部署 GitLab 代码托管平台

安装包（推荐）

在中国内地优先选择极狐 GitLab，下载和访问速度更快；当团队需要与海外环境协同，或要求保持与 GitLab 社区版完全一致的代码与文档体系时，再选择 GitLab 社区版。

ECS 扩展程序

ECS 扩展程序是用于增强和扩展 ECS 实例功能的插件。Alibaba Cloud Linux 3 系统默认安装极狐 GitLab，其他系统默认安装 GitLab 社区版。

1. 登录 ECS 控制台，进入目标实例的扩展程序页签。

2. 在扩展程序列表中找到 GitLab 类扩展程序并完成安装，操作步骤参见OOS扩展程序，支持的操作系统版本以控制台界面为准。

   当前支持的操作系统版本包括 Ubuntu 24.04、Ubuntu 22.04、Ubuntu 20.04、CentOS 7.9、CentOS 7.8、CentOS 7.7 和 Aliyun 3.2（Aliyun 3.2 的 GitLab 版本使用极狐GitLab）。可在左侧导航栏选择服务器管理 > 扩展程序进入扩展程序列表，单击 GitLab 进入详情页后单击安装扩展程序完成安装。

3. 扩展程序状态显示为成功后，远程连接 ECS 实例，执行以下命令验证 GitLab 服务状态。

   sudo gitlab-ctl status

   输出 puma、sidekiq、nginx、postgresql、redis 等进程均为 run 状态，表示 GitLab 已成功启动。

Docker 镜像

1. 使用Workbench登录Linux实例。

2. 安装Docker。

   无需安装Docker Compose。

3. 创建 Docker 容器的挂载数据目录，该目录会作为 GitLab 配置、日志和数据文件所在的目录。

   sudo mkdir -p /srv/gitlab 

4. 设置环境变量$GITLAB_HOME。

   export GITLAB_HOME=/srv/gitlab

5. 执行如下命令，安装 GitLab 容器镜像。

   重要

   由于运营商网络原因，会导致您拉取Docker Hub镜像变慢，甚至下载失败。您可以使用阿里云容器镜像服务ACR提供的官方镜像加速器，加速官方镜像的下载。具体操作，请参见官方镜像加速。

   GitLab 社区版

   sudo docker run --detach \
     --hostname gitlab.example.com \
     --publish 443:443 --publish 80:80 --publish 2222:22 \
     --name gitlab \
     --restart always \
     --volume $GITLAB_HOME/config:/etc/gitlab \
     --volume $GITLAB_HOME/logs:/var/log/gitlab \
     --volume $GITLAB_HOME/data:/var/opt/gitlab \
     --shm-size 256m \
     gitlab/gitlab-ce:latest

   容器参数	主机参数说明
   hostname	指定的主机名，建议修改为当前 ECS 实例的公网 IP 地址。
   publish 443:443	将主机的 443 端口映射到容器的 443 端口，使用 HTTPS 访问需要的端口。如果出现端口被主机端口已经被占用的报错时，请替换为非标准端口，如publish 8443:443。 说明 如替换成非标端口，需要为安全组添加放行对应端口的入方向规则，例如 8443，请参见为安全组配置安全组规则。安全组规则为有状态规则，只需配置入方向，系统自动放行对应出方向响应流量。常用端口与授权建议见下表，完整示例见安全组应用指导和案例。。
   publish 80:80	将主机的 80 端口映射到容器的 80 端口，使用 HTTP 访问需要的端口。如果出现端口被主机端口已经被占用的报错时，请替换为非标准端口，例如publish 8080:80。 说明 如替换成非标端口，需要为安全组添加放行对应端口的入方向规则，例如 8080，请参见为安全组配置安全组规则。安全组规则为有状态规则，只需配置入方向，系统自动放行对应出方向响应流量。常用端口与授权建议见下表，完整示例见安全组应用指导和案例。。
   publish 2222:22	将主机的 2222 端口映射到容器的 22 端口，Git 克隆、推送、拉取代码时通过 SSH 服务使用该端口。 说明 ECS 实例默认启动 SSH 服务，会占用 22 端口。 替换成非标端口例如 2222 后，需要先为安全组添加放行对应端口的入方向规则，然后修改 gitlab.rb 文件中的 SSH 端口号。

   ECS 实例的路径和容器路径的对应关系如下：

   ECS 路径	容器路径	说明
   $GITLAB_HOME/data	/var/opt/gitlab	存储应用程序数据。
   $GITLAB_HOME/logs	/var/log/gitlab	存储 GitLab 日志文件。
   $GITLAB_HOME/config	/etc/gitlab	存储 GitLab 配置文件。

   极狐 GitLab

   sudo docker run --detach \
     --hostname gitlab.example.com \
     --publish 443:443 --publish 80:80 --publish 2222:22 \
     --name gitlab \
     --restart always \
     --volume $GITLAB_HOME/config:/etc/gitlab \
     --volume $GITLAB_HOME/logs:/var/log/gitlab \
     --volume $GITLAB_HOME/data:/var/opt/gitlab \
     --shm-size 256m \
     registry.gitlab.cn/omnibus/gitlab-jh:latest

   容器参数	主机参数说明
   hostname	指定的主机名，建议修改为当前 ECS 实例的公网 IP 地址。
   publish 443:443	将主机的 443 端口映射到容器的 443 端口，使用 HTTPS 访问需要的端口。如果出现端口被主机端口已经被占用的报错时，请替换为非标准端口，如publish 8443:443。 说明 如替换成非标端口，需要为安全组添加放行对应端口的入方向规则，例如 8443，请参见为安全组配置安全组规则。安全组规则为有状态规则，只需配置入方向，系统自动放行对应出方向响应流量。常用端口与授权建议见下表，完整示例见安全组应用指导和案例。。
   publish 80:80	将主机的 80 端口映射到容器的 80 端口，使用 HTTP 访问需要的端口。如果出现端口被主机端口已经被占用的报错时，请替换为非标准端口，例如publish 8080:80。 说明 如替换成非标端口，需要为安全组添加放行对应端口的入方向规则，例如 8080，请参见为安全组配置安全组规则。安全组规则为有状态规则，只需配置入方向，系统自动放行对应出方向响应流量。常用端口与授权建议见下表，完整示例见安全组应用指导和案例。。
   publish 2222:22	将主机的 2222 端口映射到容器的 22 端口，Git 克隆、推送、拉取代码时通过 SSH 服务使用该端口。 说明 ECS 实例默认启动 SSH 服务，会占用 22 端口。 替换成非标端口例如 2222 后，需要先为安全组添加放行对应端口的入方向规则，然后修改 gitlab.rb 文件中的 SSH 端口号。

   ECS 实例的路径和容器路径的对应关系如下：

   ECS 路径	容器路径	说明
   $GITLAB_HOME/data	/var/opt/gitlab	存储应用程序数据。
   $GITLAB_HOME/logs	/var/log/gitlab	存储 GitLab 日志文件。
   $GITLAB_HOME/config	/etc/gitlab	存储 GitLab 配置文件。

6. 查看容器状态。

   sudo docker ps -a

   STATUS 列显示 (healthy) 时，说明 GitLab 容器已正常启动。

   [ecs-user@iZ2zeee22a96g       ~]$ sudo docker ps -a
   CONTAINER ID   IMAGE                     COMMAND             CREATED      STATUS                PORTS                                                                                                         NAMES
   75b3bc5de483   gitlab/gitlab-ce:latest   "/assets/wrapper"   2 hours ago  Up 2 hours (healthy)  0.0.0.0:443->443/tcp, :::443->443/tcp, 0.0.0.0:5000->22/tcp, :::5000->22/tcp, 0.0.0.0:8080->80/tcp, :::8080->80/tcp   gitlab

   进入容器进一步检查 GitLab 各内部进程：

   sudo docker exec gitlab gitlab-ctl status

   期望 puma、sidekiq、nginx、postgresql、redis 等进程均为 run 状态，表示容器内 GitLab 服务已成功启动。