Docker方式安裝GitLab教程
Docker方式安裝GitLab
GitLab 提供了一個官方 Docker 鏡像,該鏡像包含了 GitLab 所需的所有服務,并以單個容器的形式運行。
GitLab 官方 Docker 鏡像地址:
注意事項
- GitLab Docker 鏡像默認不包含郵件傳輸代理 (MTA),如 Postfix 或 Sendmail。
- 推薦使用獨立容器部署 MTA,或者直接在 GitLab 容器中安裝 MTA,盡管這樣會增加維護難度。
先決條件
確保您的環(huán)境中已經(jīng)安裝了 Docker。
配置 GitLab 數(shù)據(jù)目錄
在安裝之前,需要配置一個目錄來存儲 GitLab 配置、日志和數(shù)據(jù)文件。建議設置一個環(huán)境變量 $GITLAB_HOME,指向該目錄。確保該目錄存在并且權限正確。
- 對于 Linux 用戶,設置為
/srv/gitlab:
export GITLAB_HOME=/srv/gitlab
- 對于 macOS 用戶,設置為
$HOME/gitlab:
export GITLAB_HOME=$HOME/gitlab

確保將 $GITLAB_HOME 環(huán)境變量添加到您的 shell 配置文件中,以便在后續(xù)會話中生效:
GitLab 使用掛載卷來存儲數(shù)據(jù),下面是各個卷的說明:
| 本地路徑 | 容器路徑 | 用途 |
|---|---|---|
| $GITLAB_HOME/data | /var/opt/gitlab | 存儲 GitLab 數(shù)據(jù) |
| $GITLAB_HOME/logs | /var/log/gitlab | 存儲 GitLab 日志 |
| $GITLAB_HOME/config | /etc/gitlab | 存儲 GitLab 配置文件 |
安裝 GitLab
GitLab Docker 鏡像可以通過多種方式安裝,包括直接使用 Docker Engine、Docker Compose 或 Docker Swarm。
下面是使用 Docker Engine 安裝 GitLab 的步驟。
使用 Docker Engine 安裝 GitLab
1.設置好 $GITLAB_HOME 環(huán)境變量后,運行以下命令啟動 GitLab 容器:
sudo docker run --detach \ --hostname gitlab.example.com \ --publish 443:443 --publish 80:80 --publish 22: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-ee:latest
該命令會:
- 下載并啟動 GitLab 容器。
- 映射 GitLab 所需的端口:80(HTTP)、443(HTTPS)、22(SSH)。
- 使用
$GITLAB_HOME目錄掛載容器的配置、日志和數(shù)據(jù)。 - 設置容器自動重啟。
2.如果您的系統(tǒng)使用 SELinux,您需要加上 :Z 標記來調整權限:
sudo docker run --detach \ --hostname gitlab.example.com \ --publish 443:443 --publish 80:80 --publish 22:22 \ --name gitlab \ --restart always \ --volume $GITLAB_HOME/config:/etc/gitlab:Z \ --volume $GITLAB_HOME/logs:/var/log/gitlab:Z \ --volume $GITLAB_HOME/data:/var/opt/gitlab:Z \ --shm-size 256m \ gitlab/gitlab-ee:latest
這確保了 Docker 容器能在掛載的卷中創(chuàng)建配置文件。
查看安裝日志
初始化過程可能需要一些時間。
您可以使用以下命令查看容器的實時日志:
sudo docker logs -f gitlab
獲取 GitLab 初始密碼
容器啟動后,您可以通過以下命令獲取 GitLab root 用戶的初始密碼:
sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password
注意:
- 該密碼在容器啟動 24 小時后會自動被刪除。
- 建議盡早登錄并修改密碼。
訪問 GitLab
安裝完成后,您可以通過瀏覽器訪問 GitLab。
例如,若您使用了 gitlab.example.com 作為主機名,直接訪問 http://gitlab.example.com 即可。
如果您在 macOS 上使用 Boot2Docker,可以訪問 http://192.168.59.103。
管理員登錄后設置中文

總結
通過以上步驟,您可以在 Docker 容器中成功部署 GitLab。注意,GitLab 鏡像并不包含郵件傳輸代理 (MTA),因此需要額外配置郵件發(fā)送功能。另外,確保在 Docker 容器啟動后及時獲取初始密碼并進行安全設置。
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。

