GitLab在Linux中的容器化部署方案

Linux 上容器化部署 GitLab 的可落地方案

一方案总览与选型

单机 Docker：最快速上手，适合测试/小型团队，通过挂载卷实现配置、日志、数据持久化。
Docker Compose：在单机基础上提供编排与可维护性，便于统一管理、备份与升级。
Kubernetes：面向生产级与高可用，结合 Helm 与 Ingress/cert-manager 实现域名、证书与弹性扩展。

二单机 Docker 快速部署

准备与拉取镜像
- 安装并启动 Docker；如需编排可安装 Docker Compose。
- 拉取镜像：docker pull gitlab/gitlab-ce:latest（企业版用 gitlab/gitlab-ee:latest）。

运行容器（示例）

建议将宿主机端口 80/443/22 映射到容器，便于直接使用标准端口；如冲突可改为 8080/8443/2222。

命令示例：

docker run -d \
  --hostname gitlab.example.com \
  -p 8443:443 -p 8080:80 -p 2222:22 \
  --name gitlab \
  --restart always \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

首次访问与初始密码
- 浏览器访问：http://服务器IP:8080 或 https://服务器IP:8443。
- 初始 root 密码位于容器内：/etc/gitlab/initial_root_password，文件默认 24 小时内有效，首次登录后请立即修改。

三 Docker Compose 编排部署

目录与持久化
- 建议目录结构：/data/gitlab/{config,logs,data}，分别挂载到容器内 /etc/gitlab、/var/log/gitlab、/var/opt/gitlab。

示例 docker-compose.yml

version: '3.6'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    hostname: 'gitlab.example.com'
    environment:
      TZ: 'Asia/Shanghai'
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'https://gitlab.example.com'
        gitlab_rails['gitlab_shell_ssh_port'] = 22
        nginx['redirect_http_to_https'] = true
    ports:
      - '80:80'
      - '443:443'
      - '22:22'
    volumes:
      - /data/gitlab/config:/etc/gitlab
      - /data/gitlab/logs:/var/log/gitlab
      - /data/gitlab/data:/var/opt/gitlab
      - /etc/localtime:/etc/localtime:ro
    shm_size: '256m'

启动与常用操作
- 启动：docker-compose up -d
- 重新配置：docker exec -it gitlab gitlab-ctl reconfigure
- 查看日志：docker-compose logs -f
说明
- 如需使用非标准 SSH 端口，务必在宿主机与容器内一致，并在 GitLab 中设置 gitlab_rails[‘gitlab_shell_ssh_port’]。

四 Kubernetes 生产级部署

前置与仓库
- 准备 Kubernetes 集群与 kubectl/Helm；添加 GitLab Helm 仓库并创建命名空间：
```
helm repo add gitlab https://charts.gitlab.io
helm repo update
kubectl create namespace gitlab
```
安装与访问
- 安装：helm install gitlab gitlab/gitlab --namespace gitlab -f values.yaml（可按需定制 values.yaml，如域名、资源、存储等）。
- 获取外部访问地址：kubectl get svc --namespace gitlab（LoadBalancer/Ingress IP 或域名）。
HTTPS 与证书
- 推荐集成 cert-manager 自动签发 Let’s Encrypt 证书，或预先创建 TLS Secret 并在 Ingress 中引用。
备份与监控
- 集群级备份可用 Velero；监控建议接入 Prometheus/Grafana。

五关键配置与运维要点

外部访问与 SSH
- 设置 external_url（HTTP/HTTPS 地址）；如 SSH 端口非 22，同步设置 gitlab_rails[‘gitlab_shell_ssh_port’]，并确保宿主机端口映射一致。
HTTPS 两种常用方式
- 自动签发：启用 letsencrypt[‘enabled’] = true 并配置联系邮箱，完成域名验证后自动续期。
- 手动证书：在 /etc/gitlab/ssl/ 放置证书与私钥，并在 nginx 段配置：
```
nginx['enable'] = true
nginx['redirect_http_to_https'] = true
nginx['ssl_certificate'] = "/etc/gitlab/ssl/server_cert.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/private.key"
```
  修改后执行：gitlab-ctl reconfigure 与 gitlab-ctl restart。
资源与健康检查
- 建议设置容器资源限制（如 CPU/内存），并配置健康检查（示例：/opt/gitlab/bin/gitlab-healthcheck）。
邮件与通知
- 如需 SMTP，在 gitlab.rb 中配置 smtp_enable/smtp_address/smtp_port/smtp_user_name/smtp_password 等，然后 reconfigure 生效。
备份与恢复
- 定期备份：/opt/gitlab/bin/gitlab-backup create；恢复：/opt/gitlab/bin/gitlab-backup restore BACKUP=timestamp。
安全与合规
- 首次登录后立即修改 root 密码；按需关闭用户注册、开启双重认证、限制出站网络与容器资源。

GitLab在Linux中的容器化部署方案

最新问答

相关标签