使用Docker Compose部署GitLab及Runner实现CICD的配置与故障咨询

问题1：gitlab-runner报错config.toml不存在解决方案 #

该报错是因为未完成GitLab Runner注册流程，config.toml为注册成功后自动生成的配置文件，无需手动编写，操作步骤如下：

• 先确认GitLab服务完全启动，GitLab启动耗时较长，需等待5-10分钟，执行docker ps | grep gitlab查看容器状态，健康状态变为healthy再继续操作
• 执行如下命令注册Runner：

docker exec -it gitlab-runner gitlab-runner register \
  --url http://gitlab \
  --registration-token 后续GitLab后台获取的注册令牌 \
  --executor docker \
  --docker-image alpine:latest \
  --docker-network-mode gitlab_gitlab \
  --docker-privileged=true

注：命令中的网络名可通过docker network ls查询，默认名称为[docker-compose项目所在目录名]_gitlab
注册过程中可按需输入Runner描述、标签，也可直接回车使用默认配置

注册完成后，挂载目录./config/gitlab-runner下会自动生成config.toml文件，报错自动消失。

问题2：无法访问GitLab Web界面解决方案 #

按以下顺序排查：

• 确认GitLab启动完成：执行docker logs -f gitlab查看日志，出现gitlab Reconfigured!提示才代表启动完成，GitLab最低要求4核8G内存的运行环境，配置不足会导致启动极慢甚至启动失败
• 检查端口占用：执行ss -tulnp | grep -E ':(80|443|522)'，确认三个端口未被其他服务占用，若存在占用可修改docker-compose.yml的端口映射规则
• 检查访问权限：服务器本地防火墙、云服务器安全组需放通80、443、522三个端口的访问权限
• 配置修改后需重启服务生效：docker-compose down && docker-compose up -d

完整CICD流程配置步骤 #

1. GitLab基础配置 #

• 访问http://192.168.1.96进入登录页，首次登录的root用户初始密码通过如下命令获取：

docker exec -it gitlab cat /etc/gitlab/initial_root_password

注：初始密码有效期为24小时，登录后请立即修改自定义密码

• 获取Runner注册令牌：登录后点击左上角菜单→管理中心→运行器→「注册实例运行器」，复制页面显示的注册令牌，替换前文Runner注册命令中的对应参数并执行注册，注册完成后刷新运行器页面即可看到已在线的Runner。

2. CI流程测试 #

• 新建测试项目，在项目根目录新增.gitlab-ci.yml配置文件，示例内容如下：

stages:
  - test
  - build

test_job:
  stage: test
  # 若注册Runner时设置了标签，需和标签匹配，否则可删除该行
  tags:
    - 自定义Runner标签
  script:
    - echo "测试阶段执行成功"

build_job:
  stage: build
  tags:
    - 自定义Runner标签
  script:
    - echo "构建阶段执行成功"

• 提交代码到仓库，点击左侧菜单「构建」→「流水线」，即可看到自动触发的流水线运行状态，两个任务均执行成功即代表CICD流程已打通。

常见优化说明 #

• 同网络内的容器可直接通过服务名互访，无需走公网地址，执行效率更高
• 若CI任务需要拉取私有镜像，可在config.toml中配置私有镜像仓库认证，也可在项目CI/CD设置中添加对应变量
• 所有数据均持久化存储在当前目录的config、data、logs文件夹中，迁移时直接拷贝三个文件夹即可保留全部配置与数据。

内容的提问来源于stack exchange，提问作者arminbiklari