七里河头条

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

2024-03-19 14:09 由 极狐GitLab 发表于 #软件工程

本文作者：徐晓伟

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 进行学习。