部署 GitLab 代码托管平台

安装包（推荐）

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

ECS 扩展程序

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

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

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

   

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 容器已正常启动。

   

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

   sudo docker exec gitlab gitlab-ctl status

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