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

本文作者：徐晓伟

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

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

问题

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

流水线配置

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

流水线执行日志如下
问题原因：未解析 gitlab.test.helm.xuxiaowei.cn 域名

解决办法

导出 helm gitlab 配置

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

查看 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 }}

修改配置如下

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 }}

更新配置

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

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

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