Docker Compose方式安装GitLab

末蓝、 2021-12-05 01:13 600阅读 0赞

### 文章目录 ###

*  用Docker Compose方式安装GitLab
 *   *  前提条件
     *  一键自动化以Docker Compose方式安装GitLab
     *  GitLab Docker Compose文件
     *  安装和运行GitLab
     *  打开防火墙端口
     *  访问GitLab
     *  配置Gitlab
     *  Troubleshooting
     *  其它参考文档

# 用Docker Compose方式安装GitLab #

## 前提条件 ##

要求至少`2vCPU4G`配置，否则会因为CPU太忙或内存不足导致GitLab不断重启和502错误。

参见：

*  [https://gitlab.com/help/install/requirements.md][https_gitlab.com_help_install_requirements.md]

建议安装`htop`里监控CPU、内存和Swap的资源使用情况：

yum install htop -y

## 一键自动化以Docker Compose方式安装GitLab ##

*  [https://github.com/cookcodeblog/OneDayDevOps/blob/master/components/gitlab-docker/install\_gitlab.sh][https_github.com_cookcodeblog_OneDayDevOps_blob_master_components_gitlab-docker_install_gitlab.sh]

## GitLab Docker Compose文件 ##

> GitLab官方给的GitLab Docker镜像启动后无法访问，且定位不到问题，所以使用GitHub著名博主sameersbn封装的镜像。

Gitlab的`docker-compose.yml`参见：[https://github.com/sameersbn/docker-gitlab][https_github.com_sameersbn_docker-gitlab]

1.  Replace values of below keys using `pwgen -Bsv1 64`

*  `GITLAB_SECRETS_DB_KEY_BASE`
 *  `GITLAB_SECRETS_SECRET_KEY_BASE`
 *  `GITLAB_SECRETS_OTP_KEY_BASE`

> Run `yum install pwgen -y` to install `pwgen` if it is not installed.

1.  Set value of `GITLAB_HOST`
2.  Set value of `password`
3.  Set timezone `TZ` as `Asia/Shanghai` and GITLAB\_TIMEZONE=`Beijing`

GITLAB\_TIMEZONE的值为RubyOnRails的timezone语法，参见：

[https://api.rubyonrails.org/classes/ActiveSupport/TimeZone.html][https_api.rubyonrails.org_classes_ActiveSupport_TimeZone.html]

一个GitLab的`docker-compose.yml`例子：

[https://github.com/cookcodeblog/OneDayDevOps/blob/master/components/gitlab-docker/docker-compose.yml][https_github.com_cookcodeblog_OneDayDevOps_blob_master_components_gitlab-docker_docker-compose.yml]

这里使用10080和10022分别作为HTTP和SSH端口，并设置时区为中国时间。

## 安装和运行GitLab ##

mkdir -p /opt/gitlab
    cp docker-compose.yml /opt/gitlab
    cd /opt/gitlab
    
    docker-compose up -d

查看日志：

docker-compose logs -f

Debug:

docker-compose exec gitlab /bin/bash

## 打开防火墙端口 ##

在防火墙上打开HTTP和SSH端口：

firewall-cmd --list-all
    
    # http port
    firewall-cmd --zone=public --add-port=10080/tcp
    firewall-cmd --zone=public --add-port=10080/tcp --permanent
    
    # ssh port
    firewall-cmd --zone=public --add-port=10022/tcp
    firewall-cmd --zone=public --add-port=10022/tcp --permanent
    
    firewall-cmd --reload
    firewall-cmd --list-all

## 访问GitLab ##

在浏览器中打开http://<gitlab\_host>:10080

## 配置Gitlab ##

参见：

*  [配置GitLab][GitLab]

## Troubleshooting ##

**Q:** GitLb不断重启，CPU负载很高，且报错：unicorn (exit status 1; not expected)

**A:**

1.  先运行`htop`检查服务器的CPU和内存资源使用情况，最少需要2vCPU4G
2.  运行`ulimit -a`查看`ulimit`，并可运行以下命令增加`ulimit`：
    
        ulimit -u unlimited
        ulimit -n 65535
    
    参见：[https://blog.csdn.net/duanbiren123/article/details/80190750][https_blog.csdn.net_duanbiren123_article_details_80190750]
3.  运行`docker-compose logs -f`查看日志
4.  运行以下命令：
    
        docker-compose exec gitlab tail -f /var/log/gitlab/gitlab/unicorn.stderr.log
    
    查看unicorn日志，如果日志中报错如下：
    
        /home/git/gitlab/vendor/bundle/ruby/2.6.0/gems/unicorn-5.4.1/lib/unicorn/http_server.rb:205:in `pid=': Already running on PID:581 (or pid=/home/git/gitlab/tmp/pids/unicorn.pid is stale) (ArgumentError)
    
    则需要执行以下命令删除`unicorn.pid`，再重启GitLab：
    
        docker-compose exec gitlab rm -f /home/git/gitlab/tmp/pids/unicorn.pid && docker-compose down && docker-compose up -d
5.  或者更彻底地先删除持久卷，再重启GitLab：
    
        docker-compose exec gitlab rm -f /home/git/gitlab/tmp/pids/unicorn.pid && docker-compose down && rm -rf /srv/docker/gitlab && docker-compose up -d
6.  重启浏览器，再次访问GitLab

参考文档：

*  [https://blog.stead.id.au/2017/03/synology-gitlab-error-502.html][https_blog.stead.id.au_2017_03_synology-gitlab-error-502.html]
 *  [https://github.com/sameersbn/docker-gitlab/issues/1861][https_github.com_sameersbn_docker-gitlab_issues_1861]

**Q:** Docker Compose启动GitLab不成功，报错：Bind for 0.0.0.0:10080 failed: port is already allocated’

**A:**

1.  先运行`docker stop gitlab`停止GitLab相关容器
2.  再运行`docker-compose up -d`启动GitLab

## 其它参考文档 ##

*  [https://docs.gitlab.com/omnibus/docker/\#install-gitlab-using-docker-compose][https_docs.gitlab.com_omnibus_docker_install-gitlab-using-docker-compose]
 *  [https://docs.gitlab.com/omnibus/docker/\#pre-configure-docker-container][https_docs.gitlab.com_omnibus_docker_pre-configure-docker-container]
 *  [https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/files/gitlab-config-template/gitlab.rb.template][https_gitlab.com_gitlab-org_omnibus-gitlab_blob_master_files_gitlab-config-template_gitlab.rb.template]
 *  [https://hub.docker.com/r/gitlab/gitlab-ce][https_hub.docker.com_r_gitlab_gitlab-ce]
 *  [https://developer.ibm.com/code/2017/07/13/step-step-guide-running-gitlab-ce-docker/][https_developer.ibm.com_code_2017_07_13_step-step-guide-running-gitlab-ce-docker]

[https_gitlab.com_help_install_requirements.md]: https://gitlab.com/help/install/requirements.md
[https_github.com_cookcodeblog_OneDayDevOps_blob_master_components_gitlab-docker_install_gitlab.sh]: https://github.com/cookcodeblog/OneDayDevOps/blob/master/components/gitlab-docker/install_gitlab.sh
[https_github.com_sameersbn_docker-gitlab]: https://github.com/sameersbn/docker-gitlab
[https_api.rubyonrails.org_classes_ActiveSupport_TimeZone.html]: https://api.rubyonrails.org/classes/ActiveSupport/TimeZone.html
[https_github.com_cookcodeblog_OneDayDevOps_blob_master_components_gitlab-docker_docker-compose.yml]: https://github.com/cookcodeblog/OneDayDevOps/blob/master/components/gitlab-docker/docker-compose.yml
[GitLab]: https://blog.csdn.net/nklinsirui/article/details/89498600
[https_blog.csdn.net_duanbiren123_article_details_80190750]: https://blog.csdn.net/duanbiren123/article/details/80190750
[https_blog.stead.id.au_2017_03_synology-gitlab-error-502.html]: https://blog.stead.id.au/2017/03/synology-gitlab-error-502.html
[https_github.com_sameersbn_docker-gitlab_issues_1861]: https://github.com/sameersbn/docker-gitlab/issues/1861
[https_docs.gitlab.com_omnibus_docker_install-gitlab-using-docker-compose]: https://docs.gitlab.com/omnibus/docker/#install-gitlab-using-docker-compose
[https_docs.gitlab.com_omnibus_docker_pre-configure-docker-container]: https://docs.gitlab.com/omnibus/docker/#pre-configure-docker-container
[https_gitlab.com_gitlab-org_omnibus-gitlab_blob_master_files_gitlab-config-template_gitlab.rb.template]: https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/files/gitlab-config-template/gitlab.rb.template
[https_hub.docker.com_r_gitlab_gitlab-ce]: https://hub.docker.com/r/gitlab/gitlab-ce
[https_developer.ibm.com_code_2017_07_13_step-step-guide-running-gitlab-ce-docker]: https://developer.ibm.com/code/2017/07/13/step-step-guide-running-gitlab-ce-docker/