OE_gitlab服务操作和维护方法

OE ： Operation Engineer

GitLab Omnibus 安装（rpm/deb 包，主流）启停、状态、日志全套命令（Ubuntu/CentOS 通用）。绝大部分离线部署 GitLab 都是omnibus 包安装，优先用gitlab-ctl；Docker 部署在文末单独说明。

一、启动 / 停止 / 重启服务

bash运行复制代码

# 1. 全量启动所有组件(nginx/puma/postgres/redis/sidekiq等)
sudo gitlab-ctl start

# 2. 全量停止
sudo gitlab-ctl stop

# 3. 全量重启（改配置后常用）
sudo gitlab-ctl restart

# 4. 修改/etc/gitlab/gitlab.rb配置后重载配置（必执行）
sudo gitlab-ctl reconfigure

# 5. 单独启停某个组件（举例nginx/数据库）
sudo gitlab-ctl start nginx
sudo gitlab-ctl restart postgresql

systemd 系统服务控制（备选）

bash 复制代码

# 开机自启
sudo systemctl enable gitlab-runsvdir
# 启停systemd托管总服务
sudo systemctl start/stop/restart gitlab-runsvdir
# 查看systemd运行状态
sudo systemctl status gitlab-runsvdir

二、查看运行状态（最常用）

bash 复制代码

# 查看所有组件运行状态：run=正常运行，down=异常停止
sudo gitlab-ctl status

输出示例：

plaintext 复制代码

run: nginx: (pid 1234) 120s; run: log: (pid 1233) 120s
run: postgresql: (pid 1236) 120s; run: log: (pid 1235) 120s
down: sidekiq: 0s, normally up

三、查看日志（2 种方式：实时跟踪 / 直接读文件）

方式 1：gitlab-ctl 实时跟踪日志（排查故障首选，Ctrl+C退出）

bash 复制代码

# 实时查看全组件汇总日志
sudo gitlab-ctl tail

# 单独查看指定服务日志（高频）
sudo gitlab-ctl tail gitlab-rails   # 主程序业务日志（页面报错、接口异常）
sudo gitlab-ctl tail nginx          # web访问、404/502错误
sudo gitlab-ctl tail postgresql     # 数据库报错
sudo gitlab-ctl tail sidekiq        # 后台任务、CI任务失败
sudo gitlab-ctl tail redis          # 缓存异常

方式 2：直接读取日志文件（默认路径：/var/log/gitlab/）

bash 复制代码

# 进入日志目录
cd /var/log/gitlab

# 查看应用错误日志
tail -f gitlab-rails/production.log
# Nginx访问日志
tail -f nginx/gitlab_access.log
# Nginx错误日志
tail -f nginx/gitlab_error.log

四、Docker 容器部署 GitLab 专用命令

bash 复制代码

# 查看容器运行状态
docker ps |grep gitlab
# 启动/停止容器
docker start gitlab
docker stop gitlab

# 实时查看容器整体日志
docker logs -f gitlab
# 查看最后100行日志
docker logs --tail 100 gitlab

# 进入容器内部用gitlab-ctl
docker exec -it gitlab bash
# 容器内再执行：gitlab-ctl status / gitlab-ctl tail

五、常用排错补充

网页打不开：优先看gitlab-ctl tail nginx
登录 500 报错：优先看gitlab-ctl tail gitlab-rails
项目 push 失败：查看gitlab-ctl tail gitaly