• Alibaba Cloud Linux 3使用安裝包方式安裝時，僅支持安裝極狐GitLab。如果需要在Alibaba Cloud Linux 3安裝GitLab社區(qū)版，請使用Docker鏡像方式。

• 極狐GitLab支持的操作系統(tǒng)參見supported_os。

1. 遠程連接需要安裝GitLab的ECS實例。

   具體操作，請參見使用Workbench工具以SSH協(xié)議登錄Linux實例。

2. 安裝Docker。具體操作，請參見安裝Docker。

3. 創(chuàng)建Docker容器的掛載數據目錄，該目錄會作為GitLab配置、日志和數據文件所在的目錄。

   sudo mkdir -p /srv/gitlab 

4. 設置環(huán)境變量$GITLAB_HOME。

   export GITLAB_HOME=/srv/gitlab

5. 執(zhí)行如下命令，安裝GitLab容器鏡像。

   重要

   由于運營商網絡原因，會導致您拉取Docker Hub鏡像變慢，甚至下載失敗。您可以使用阿里云容器鏡像服務ACR提供的官方鏡像加速器，加速官方鏡像的下載。具體操作，請參見官方鏡像加速。

   GitLab社區(qū)版

   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訪問需要的端口。如果出現(xiàn)端口被主機端口已經被占用的報錯時，請?zhí)鎿Q為非標準端口，如publish 8443:443。 說明 如替換成非標端口，需要在安全組中添加開放對應端口的入方向規(guī)則例如8443，請參見添加安全組規(guī)則。
   publish 80:80	將主機的80端口映射到容器的80端口，使用HTTP訪問需要的端口。如果出現(xiàn)端口被主機端口已經被占用的報錯時，請?zhí)鎿Q為非標準端口，例如publish 8080:80。 說明 如替換成非標端口，需要在安全組中添加開放對應端口的入方向規(guī)則例如8080，請參見添加安全組規(guī)則。
   publish 2222:22	將主機的2222端口映射到容器的22端口，使用Git操作進行代碼克隆、推送和拉取操作，需要使用SSH服務。 說明 ECS實例默認啟動SSH服務，會占用22端口。 替換成非標端口例如2222后，需要先在安全組中添加開放對應端口的入方向規(guī)則，然后修改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訪問需要的端口。如果出現(xiàn)端口被主機端口已經被占用的報錯時，請?zhí)鎿Q為非標準端口，如publish 8443:443。 說明 如替換成非標端口，需要在安全組中添加開放對應端口的入方向規(guī)則例如8443，請參見添加安全組規(guī)則。
   publish 80:80	將主機的80端口映射到容器的80端口，使用HTTP訪問需要的端口。如果出現(xiàn)端口被主機端口已經被占用的報錯時，請?zhí)鎿Q為非標準端口，例如publish 8080:80。 說明 如替換成非標端口，需要在安全組中添加開放對應端口的入方向規(guī)則例如8080，請參見添加安全組規(guī)則。
   publish 2222:22	將主機的2222端口映射到容器的22端口，使用Git操作進行代碼克隆、推送和拉取操作，需要使用SSH服務。 說明 ECS實例默認啟動SSH服務，會占用22端口。 替換成非標端口例如2222后，需要先在安全組中添加開放對應端口的入方向規(guī)則，然后修改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. 查看容器狀態(tài)。

   sudo docker ps -a

   當容器狀態(tài)為healthy時，說明GitLab容器已經正常啟動。

   

GitLab需要一個郵件傳輸代理來發(fā)送電子郵件通知，例如項目更新、密碼重置等。SMTP服務通常使用服務器的25端口發(fā)送郵件，但基于安全考慮，ECS實例25端口默認受限，建議您使用SSL加密端口（通常是465端口）來對外發(fā)送郵件，常用端口的說明請參見常用端口。配置SMTP的步驟：

1. 配置外部 SMTP 服務器。

2. 驗證SMTP配置效果。

   1. 執(zhí)行gitlab-rails console命令進入Rails控制臺。

   2. 輸入以下命令，發(fā)送測試電子郵件：

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

   3. 在目標郵箱中查看測試郵件，或者在ECS實例中執(zhí)行sudo tail -f /var/log/mail.log查看郵件的日志。

• 在ECS上安裝GitLab后，GitLab倉庫的數據通常會存儲在服務器的/var/opt/gitlab/git-data路徑中，倉庫存儲在名為repositories的子文件夾中。

• 備份方式：

  • 如果您只想保存?zhèn)}庫數據，可以為當前ECS實例的云盤創(chuàng)建快照，操作步驟參見創(chuàng)建快照和通過ECS快照備份恢復數據。

  • 如果您想備份倉庫數據、GitLab配置、已安裝的其他軟件等全量數據，可以為ECS實例創(chuàng)建鏡像，操作步驟參見使用實例創(chuàng)建自定義鏡像和通過ECS鏡像備份恢復數據。

  • 如果您需要使用多臺ECS來部署GitLab服務器：

    1. 創(chuàng)建NAS文件系統(tǒng)：用于存儲GitLab的數據。

    2. 多臺ECS實例批量掛載同一NAS文件系統(tǒng)：將NAS系統(tǒng)同時掛載到所有ECS實例，以便這些實例可以共享GitLab的數據。

    3. 配置GitLab數據路徑：將Git倉庫的數據存儲路徑配置到已經掛載的NAS路徑，具體的操作步驟參見將 Git 數據存儲在備用目錄中。

通過實例公網IP地址直接訪問您的GitLab網站會降低服務端的安全性。如果您已有域名或者想為GitLab網站注冊一個域名，可以參考以下步驟。

1. 注冊域名。

   具體操作，參見通用域名注冊基本流程如何注冊阿里云域名。

2. 備案域名。

   如果您的域名指向的網站托管在阿里云中國內地節(jié)點服務器，您需要進行備案。首次備案，請參見ICP備案流程，其他情況請參見ICP備案流程。

3. 解析域名。設置域名解析后，外部用戶可通過域名訪問GitLab網站。

   域名解析是使用域名訪問您的網站的必備環(huán)節(jié)。具體操作，請參見新手引導。

4. 開啟HTTPS加密訪問。使用免費服務例如使用Let’s Encrypt免費的自動HTTPS，或者付費服務SSL證書快速上手。

5. 添加安全組規(guī)則：在ECS的安全組內，添加一條入方向規(guī)則，為了安全起見，建議只對授權的IP地址開放端口。

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

   • Docker Engine方式：對應于docker run命令中設置的主機HTTPS端口。

6. 修改gitlab.rb中的external_url參數，配置完成后如下圖所示。

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

   • Docker鏡像方式：編輯配置文件。

     

• 低于4 vCPU、8 GiB會因規(guī)格過小，導致長時間處于Installing狀態(tài)或安裝失敗。請升級規(guī)格以后再安裝，升級規(guī)格操作，請參見升降配方式概述。

• 如果無法遠程連接服務器，可以使用VNC登錄實例，然后進行配置SWAP、優(yōu)化Sidekiq等操作，具體步驟參見memory_constrained_envs。

• 監(jiān)控ECS實例的vCPU使用率、網絡流量和磁盤I/O的操作步驟，請參見查看實例監(jiān)控信息。

ECS實例默認啟動SSH服務，會占用22（SSH）端口。使用Docker鏡像方式安裝時，需要將主機的22端口映射成其他端口，并修改gitlab_rails['gitlab_shell_ssh_port'] 參數：

1. 在啟動Docker時指定非標端口，例如publish 2222:22。

2. 編輯GitLab配置文件。

   1. 執(zhí)行sudo docker exec -it gitlab /bin/bash，進入會話。

   2. 編輯文件/etc/gitlab/gitlab.rb。

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

   4. 執(zhí)行gitlab-ctl reconfigure，重新配置GitLab。

3. 打開項目頁面，驗證配置效果。