近期因為公司的需求打算替換 Gerrit，所以用 Docker 建立了公司內部 Host 的 GitLab 和 GitLab Runner。其中這邊要提到 GitLab Runner 是用來幫 GitLab 跑 CI 的外掛，有點像是 Jenkins 的 Slave Node，用來串接 GitLab CI。
這邊主要分成三個部分
架設 GitLab
GitLab Runner 串接
Auto Backup and Restore
架設 GitLab
Step 1：
docker pull gitlab/gitlab-ce
Step 2：
新增 docker-compose.yml 檔案，其中 {host_ip}替換成實際的機器 ip 位址。
version: "3.6"
services:
web:
image: 'gitlab/gitlab-ce'
container_name: 'gitlab'
restart: always
hostname: {host_ip}
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'http://{host_ip}:9090'
gitlab_rails['gitlab_shell_ssh_port'] = 2224
networks:
- gitlab-network
ports:
- '80:80'
- '443:443'
- '9090:9090'
- '2224:22'
volumes:
- '/srv/gitlab/config:/etc/gitlab'
- '/srv/gitlab/logs:/var/log/gitlab'
- '/srv/gitlab/data:/var/opt/gitlab'
networks:
gitlab-network:
name: gitlab-network
Step 3：
docker-compose up --build --abort-on-container-exit
第一次啟動時需等待約 5 分鐘。啟動後使用瀏覽器連接 {host_ip}:9090 到 GitLab 去重新設置密碼。預設 username 是 root。
GitLab Runner 串接
這邊的話 GitLab Runner 需要準備另一台機器，跟 GitLab 分開。不然 GitLab Runner 在 clone 的時候 URL 的解析會有問題。這部分我也不知道怎麼解決，問了官方也沒有回應。可能是因為我的 GitLab Runner 是使用了 dind （docker in docker）的關係吧。其中 GitLab 可以跟多個 GitLab Runner 串接，Runner 都放在同一台機器是沒有問題的，只是 container 和 volume mount 的地方要不同。
Step 1：
其中 {runner-name} 替換成自己要的名字
docker pull gitlab/gitlab-runner
docker run -d --name {runner-name} -v /var/run/docker.sock:/var/run/docker.sock -v /srv/{runner-name}/config:/etc/gitlab-runner --rm gitlab/gitlab-runner
Step 2：
Step 1 啟動後，到 GitLab 裡面的 Admin Area > Overview > Runners。可以看到 Runner Registration Token
Step 3：
將 Step 2 取得的 token 替換掉下面指令中的 {registration-token} 並執行。{gitlab-ip} 替換為 GitLab 伺服器的 IP 位址。{runner-name} 替換為在 Step 1 設定的名字。
docker exec -it {runner-name} gitlab-runner register -n --url http://{gitlab-ip}:9090 --registration-token {registration-token} --clone-url http://{gitlab-ip}:9090 --executor docker --docker-image "docker:latest" --docker-privileged
Auto Backup and Restore
Backup
修改 /srv/gitlab/config/gitlab.rb 並增加以下的設定，這邊我是設定備份到 AWS 的 S3。其他的備份點，例如 GCP 或是本地端的可以參考官網。
gitlab_rails['backup_keep_time'] = 86400
gitlab_rails['backup_upload_connection'] = {
'provider' => 'AWS',
'region' => 'us-west-1',
'aws_access_key_id' => {access key id},
'aws_secret_access_key' => {secret access key}
}
gitlab_rails['backup_upload_remote_directory'] = 'gitlab'
修改完後，需要讓 GitLab 載入新的 config 設定
docker exec -t gitlab-master gitlab-ctl reconfigure
產生備份檔案，會自動上傳到 AWS 的 S3
docker exec -t gitlab-master gitlab-rake gitlab:backup:create
Restore
依照原本的 docker-compose.yml 重新啟動 GitLab
當 GitLab 重啟完畢後，從 S3 下載備份檔案到 /srv/gitlab/data/backups
aws s3 cp {s3 backup file url} {backup file name}
最後執行執行來復原設定
docker exec -it gitlab-master gitlab-rake gitlab:backup:restore
其中如果有多個備份檔案在 backups 目錄的話，則需要特別指定是哪個備份檔案
docker exec -it gitlab-master gitlab-rake gitlab:backup:restore BACKUP={prefix backup file name before gitlab_backup.tar}
Cron Job
最後為了讓備份可以自動執行，所以就使用了 Linux 預設的 Cron 來處理。設定每週五的午夜執行備份指令
$ crontab -e
0 0 * * FRI docker exec -t gitlab-master gitlab-rake gitlab:backup:create
