部署GitLab代码托管平台

• Alibaba Cloud Linux 3使用安装包方式安装时，仅支持安装极狐GitLab。如果需要在Alibaba Cloud Linux 3安装GitLab社区版，请使用Docker镜像方式。

• 极狐GitLab支持的操作系统参见supported_os。

1. 远程连接需要安装GitLab的ECS实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 安装Docker。具体操作，请参见安装Docker。

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

   当容器状态为healthy时，说明GitLab容器已经正常启动。

   

GitLab需要一个邮件传输代理来发送电子邮件通知，例如项目更新、密码重置等。SMTP服务通常使用服务器的25端口发送邮件，但基于安全考虑，ECS实例25端口默认受限，建议您使用SSL加密端口（通常是465端口）来对外发送邮件，常用端口的说明请参见常用端口。配置SMTP的步骤：

1. 配置外部 SMTP 服务器。

2. 验证SMTP配置效果。

   1. 执行gitlab-rails console命令进入Rails控制台。

   2. 输入以下命令，发送测试电子邮件：

      Notify.test_email('destination_email@address.com', 'Message Subject', 'Message Body').deliver_now

   3. 在目标邮箱中查看测试邮件，或者在ECS实例中执行sudo tail -f /var/log/mail.log查看邮件的日志。

• 在ECS上安装GitLab后，GitLab仓库的数据通常会存储在服务器的/var/opt/gitlab/git-data路径中，仓库存储在名为repositories的子文件夹中。

• 备份方式：

  • 如果您只想保存仓库数据，可以为当前ECS实例的云盘创建快照，操作步骤参见创建快照和通过ECS快照备份恢复数据。

  • 如果您想备份仓库数据、GitLab配置、已安装的其他软件等全量数据，可以为ECS实例创建镜像，操作步骤参见使用实例创建自定义镜像和通过ECS镜像备份恢复数据。

  • 如果您需要使用多台ECS来部署GitLab服务器：

    1. 创建NAS文件系统：用于存储GitLab的数据。

    2. 多台ECS实例批量挂载同一NAS文件系统：将NAS系统同时挂载到所有ECS实例，以便这些实例可以共享GitLab的数据。

    3. 配置GitLab数据路径：将Git仓库的数据存储路径配置到已经挂载的NAS路径，具体的操作步骤参见将 Git 数据存储在备用目录中。

通过实例公网IP地址直接访问您的GitLab网站会降低服务端的安全性。如果您已有域名或者想为GitLab网站注册一个域名，可以参考以下步骤。

1. 注册域名。

   具体操作，参见通用域名注册基本流程如何注册阿里云域名。

2. 备案域名。

   如果您的域名指向的网站托管在阿里云中国内地节点服务器，您需要进行备案。首次备案，请参见ICP备案流程，其他情况请参见ICP备案流程。

3. 解析域名。设置域名解析后，外部用户可通过域名访问GitLab网站。

   域名解析是使用域名访问您的网站的必备环节。具体操作，请参见新手引导。

4. 开启HTTPS加密访问。使用免费服务例如使用Let’s Encrypt免费的自动HTTPS，或者付费服务SSL证书快速上手。

5. 添加安全组规则：在ECS的安全组内，添加一条入方向规则，为了安全起见，建议只对授权的IP地址开放端口。

   • 安装包或扩展程序方式：443（HTTPS）端口。

   • Docker Engine方式：对应于docker run命令中设置的主机HTTPS端口。

6. 修改gitlab.rb中的external_url参数，配置完成后如下图所示。

   • 安装包方式：配置 GitLab 的外部 URL。

   • Docker镜像方式：编辑配置文件。

     

• 低于4 vCPU、8 GiB会因规格过小，导致长时间处于Installing状态或安装失败。请升级规格以后再安装，升级规格操作，请参见升降配方式概述。

• 如果无法远程连接服务器，可以使用VNC登录实例，然后进行配置SWAP、优化Sidekiq等操作，具体步骤参见memory_constrained_envs。

• 监控ECS实例的vCPU使用率、网络流量和磁盘I/O的操作步骤，请参见查看实例监控信息。

ECS实例默认启动SSH服务，会占用22（SSH）端口。使用Docker镜像方式安装时，需要将主机的22端口映射成其他端口，并修改gitlab_rails['gitlab_shell_ssh_port'] 参数：

1. 在启动Docker时指定非标端口，例如publish 2222:22。

2. 编辑GitLab配置文件。

   1. 执行sudo docker exec -it gitlab /bin/bash，进入会话。

   2. 编辑文件/etc/gitlab/gitlab.rb。

   3. 设置gitlab_rails['gitlab_shell_ssh_port'] = 2222。

   4. 执行gitlab-ctl reconfigure，重新配置GitLab。

3. 打开项目页面，验证配置效果。