如何在极狐GitLab Runner Job 添加 域名 host？

本文作者：徐晓伟

GitLab 是一个全球知名的一体化 DevOps 平台，很多人都通过私有化部署 GitLab 来进行源代码托管。极狐GitLab 是 GitLab 在中国的发行版，专门为中国程序员服务。可以一键式部署极狐GitLab。

在极狐GitLab Runner Job 添加 域名 host是为了检出代码时使用。

问题

1. 测试项目公开地址：https://framagit.org/xuxiaowei-com-cn/sleep ，分支：host

2. 流水线配置

   stages:
      - build
   
   build-job:
      stage: build
      variables:
         # 环境变量
         SLEEP_TIME: 600
      script:
         # 延时一段时间，从环境变量中获取
         - sleep $SLEEP_TIME
   

3. 流水线执行日志如下 
   

4. 问题原因：未解析 gitlab.test.helm.xuxiaowei.cn 域名

解决办法

1. 导出 helm gitlab 配置

   # 将已配置的值导出到文件中
   helm -n gitlab-test get values my-gitlab > my-gitlab.yaml
   

2. 查看 gitlab runner 默认配置

   # 此处为节选，不同版本可能会存在差异，请以 https://artifacthub.io/packages/helm/gitlab/gitlab?modal=values 中的配置为准
   gitlab-runner:
     runners:
       config: |
         [[runners]]
           [runners.kubernetes]
           image = "ubuntu:22.04"
           {{- if .Values.global.minio.enabled }}
           [runners.cache]
             Type = "s3"
             Path = "gitlab-runner"
             Shared = true
             [runners.cache.s3]
               ServerAddress = {{ include "gitlab-runner.cache-tpl.s3ServerAddress" . }}
               BucketName = "runner-cache"
               BucketLocation = "us-east-1"
               Insecure = false
           {{ end }}
   

3. 修改配置如下

   gitlab-runner:
     runners:
       config: |
         [[runners]]
           [runners.kubernetes]
           image = "ubuntu:22.04"
           [[runners.kubernetes.host_aliases]]
           ip = "172.25.25.32"
           hostnames = [ "gitlab.test.helm.xuxiaowei.cn" ]
           {{- if .Values.global.minio.enabled }}
           [runners.cache]
             Type = "s3"
             Path = "gitlab-runner"
             Shared = true
             [runners.cache.s3]
               ServerAddress = {{ include "gitlab-runner.cache-tpl.s3ServerAddress" . }}
               BucketName = "runner-cache"
               BucketLocation = "us-east-1"
               Insecure = false
           {{ end }}
   

4. 更新配置

   helm upgrade -n gitlab-test --install my-gitlab gitlab/gitlab --timeout 600s -f my-gitlab.yaml --version 7.7.0
   

5. 等待所有 gitlab-runner 旧 pod 删除完成，新 pod 正常运行时，重试流水线，即可正常检出代码 
   

6. 说明

   检出代码与当前 .gitlab-ci.yml 使用的什么镜像无关（比如说：在 .gitlab-ci.yml 中使用的镜像中无 git，也可以正常运行）， 而是使用的 helper 镜像创建的容器，此容器还负责上传/下载缓存等操作

   更多关于极狐GitLab 的最佳实践，请搜索关注【极狐GitLab】公众号或者登录极狐GitLab 官网 https://gitlab.cn 进行学习。

本文由博客一文多发平台 OpenWrite 发布！