docker安装gitlab

安装gitlab

提示

gitlab的坑比较奇葩，如果已经了解过，可以直接查看完整安装步骤

安装运行

搜索gitlab

docker search gitlab

拉取gitlab镜像，其中gitlab-ce为社区版，gitlab-ee为企业版，这里我们拉取社区版即可

docker pull gitlab/gitlab-ce

运行gitlab-ce容器

使用默认端口启动gitlab

docker run -d --name gitlab \
    -p 443:443 -p 80:80 -p 22:22 \
    --restart always \
    -v /srv/gitlab/etc:/etc/gitlab \
    -v /srv/gitlab/log:/var/log/gitlab \
    -v /srv/gitlab/opt:/var/opt/gitlab \
    gitlab/gitlab-ce
  • -v /srv/gitlab/etc:/etc/gitlab 配置文件目录映射
  • -v /srv/gitlab/log:/var/log/gitlab 日志文件目录映射到
  • -v /srv/gitlab/opt:/var/opt/gitlab 数据文件目录映射

使用非默认端口启动gitlab（推荐）

使用默认端口我们经常会遇到以下端口占用问题，即便没有占用，一般也会预留出来：

  • 80端口为web服务的默认端口，nginx等服务都是使用的此端口；
  • 22端口为远程ssh默认端口，基本上Linux服务器都会开启
docker run -d --name gitlab \
    -p 443:443 -p 10080:80 -p 222:22 \
    --restart always \
    -v /srv/gitlab/etc:/etc/gitlab \
    -v /srv/gitlab/log:/var/log/gitlab \
    -v /srv/gitlab/opt:/var/opt/gitlab \
    gitlab/gitlab-ce

此时我们就可以通过访问http://ip:10080地址查看gitlab UI了

配置

仓库地址

默认情况下，当我们创建一个项目后，在Clone的时候显示的仓库地址为容器ID，这显然在外部是无法访问的，需要改成宿主机IP+端口才行。

  • 查找gitlab.rb文件

  1. 容器中查找

    如果容器没有做配置文件目录映射，可以进入容器修改

    docker exec -it gitlab /bin/bash

    容器内的gitlab.rb文件路径为/etc/gitlab/gitlab.rb

  2. 宿主机查找

    如果做了配置文件目录映射，可以直接在宿主机中找到该文件修改即可，具体请查看配置文件映射目录

  • 修改gitlab.rb文件

将external_url参数设置为外部主机地址

# 这段为原始需要修改的代码，找到该行代码修改
# external_url 'GENERATED_EXTERNAL_URL'

# 假设宿主机IP为`192.168.222.136`
# 配置http协议所使用的访问地址，这里端口号也指向内部映射端口号，所以在映射时需要指定相同的端口号
external_url 'http://192.168.222.136:10080'

# 配置ssh协议所使用的访问地址和端口
gitlab_rails['gitlab_ssh_host'] = '192.168.222.136'
gitlab_rails['gitlab_shell_ssh_port'] = 222
  • 重启gitlab

修改gitlab.rb文件后，需要重启gitlab才会生效

docker restart gitlab

等待重启成功后再次访问http://ip:10080地址试试，是不是连UI都不能打开了？

其实这是gitlab的一个坑，原因是使用非默认http端口80映射，如果修改external_url地址为http://ip:10080，相当于也将（容器）内部的端口号修改为10080了，而此时映射的端口号还是80，自然就无法访问了

要解决此问题只需要把映射的容器端口改为10080。可以通过docker容器端口映射修改容器端口号，或者直接移除容器然后重新安装启动

完整安装配置

  • 安装启动gitlab
docker run -d --name gitlab \
    -p 443:443 -p 10080:10080 -p 222:22 \
    --restart always \
    -v /srv/gitlab/etc:/etc/gitlab \
    -v /srv/gitlab/log:/var/log/gitlab \
    -v /srv/gitlab/opt:/var/opt/gitlab \
    gitlab/gitlab-ce
  • 修改gitlab.rb
vim /srv/gitlab/etc/gitlab.rb

# 配置http协议所使用的访问地址，这里端口号也指向内部映射端口号，所以在映射时需要指定相同的端口号
external_url 'http://192.168.222.136:10080'

# 配置ssh协议所使用的访问地址和端口
gitlab_rails['gitlab_ssh_host'] = '192.168.222.136'
gitlab_rails['gitlab_shell_ssh_port'] = 222
  • 重启gitlab
docker restart gitlab

docker-compose

  1. 如果服务器上还没有docker-compose，我们需要先安装docker-compose

    # unbuntu
apt install docker-compose

  2. 创建docker-compose.yml文件

    version: '3.3'

services:
  gitlab:
    network_mode: bridge # do not create new network
    image: 'gitlab/gitlab-ce'
    container_name: gitlab
    hostname: '192.168.37.128'   # server ip
    restart: always
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://192.168.37.128'  # the same as hostname, custom port number
        gitlab_rails['gitlab_ssh_host'] = '192.168.37.128'
        gitlab_rails['gitlab_shell_ssh_port'] = 222
        # Add any other gitlab.rb configuration here, each on its own line
    ports:
      - "80:80" # port is the same as external_url
      - "443:443"
      - "222:22" # port is the same as gitlab_shell_ssh_port
    volumes:
      - /srv/gitlab/etc:/etc/gitlab
      - /srv/gitlab/opt:/var/opt/gitlab
      - /srv/gitlab/log:/var/log/gitlab

  3. 确保与docker-compose.yml文件在同一目录下并启动它

    docker compose up -d

初始账号

在安装完启动 GitLab 后，应该就可以在网页上访问到 GitLab 的登录界面了，不过 GitLab 已事先创建了一个账号，这个账号就是管理员账号。即便是注册新 GitLab 账号，也需要登录管理员账号进行审批。那么这个管理员账号和密码各是什么呢？

这个管理员账号的用户名为root，而密码在一个自动生成的文件/etc/gitlab/initial_root_password中，且会在 24 小时后自动被删除。

# 进入gitlab容器
docker exec -it gitlab /bin/bash

# 查看初始密码
cat /etc/gitlab/initial_root_password

登录GitLab后可以在管理界面修改密码，密码至少需要8个字符

相关链接