如何在GitLab Runner Helm Chart值文件中复用配置避免重复？

问题根源 #

你遇到的核心问题是：Helm的values文件是纯值输入文件，不会被解析模板语法。你在values.yaml里写的"{{ .Values.config.gitlabRunner.token }}"会被当成普通字符串传入Chart模板，最终被Base64编码成模板文本本身，而非期望的实际值。只有Chart的templates目录下的文件才会被Helm渲染模板语法。

解决方案 #

根据你的场景，推荐以下几种实用的复用配置方式：

方法1：多Values文件合并（最适合当前场景）

不需要在values里写模板，直接把公共配置拆分到独立文件，利用Helm的多values文件合并特性复用值：

1. 拆分公共配置与服务专属配置

   • 公共配置文件common-config.yaml：

     # 公共配置：MinIO、GitLab Runner共享值
     gitlabUrl: https://gitlab.example.com
     runnerToken: secret3
     minio:
       host: minio
       port: 80
       bucket: runners-bucket
       rootUser:
         login: admin
         pwd: secret1
       runnerUser:
         login: gitlab-runner
         pwd: secret2
     

   • GitLab Runner专属values.yaml：

     # 仅保留Runner特有的配置
     rbac:
       create: true
     serviceAccount:
       create: true
     nodeSelector:
       node: gitlab
     runners:
       config: |
         [[runners]]
           [runners.cache]
             Path = ""
             Shared = true
             Type = "s3"
             [runners.cache.s3]
               AccessKey = "{{ .Values.minio.runnerUser.login }}"
               BucketName = "{{ .Values.minio.bucket }}"
               Insecure = true
               SecretKey = "{{ .Values.minio.runnerUser.pwd }}"
               ServerAddress = "{{ .Values.minio.host }}:{{ .Values.minio.port }}"
           [runners.kubernetes]
             # 其他Runner配置
     

2. 安装时合并两个文件

   helm install \
     --namespace gitlab-ns \
     gitlab-runner \
     -f ./common-config.yaml \
     -f ./values.yaml \
     gitlab/gitlab-runner
   

   Helm会自动合并两个文件的内容，公共值来自common-config.yaml，专属配置来自values.yaml，而runners.config里的模板会在Chart的ConfigMap模板中被正确渲染。

方法2：自定义父Chart（适合多服务集中管理）

如果未来要添加更多服务（如MinIO、dind），可以创建一个父Chart，将各服务作为子Chart，统一管理公共配置：

1. 创建父Chart结构

   gitlab-stack/
   ├── Chart.yaml
   ├── values.yaml
   └── charts/
       ├── gitlab-runner/  # 官方GitLab Runner子Chart
       └── minio/          # 官方MinIO子Chart
   

2. 父Chart的values.yaml定义公共配置

   common:
     minio:
       host: minio
       port: 80
       bucket: runners-bucket
       rootUser:
         login: admin
         pwd: secret1
       runnerUser:
         login: gitlab-runner
         pwd: secret2
     gitlabRunner:
       gitlabUrl: https://gitlab.example.com
       token: secret3
   

3. 子Chart引用父Chart的公共配置
   在charts/gitlab-runner/values.yaml中直接引用父Chart的公共值：

   gitlabUrl: "{{ .Values.common.gitlabRunner.gitlabUrl }}"
   runnerToken: "{{ .Values.common.gitlabRunner.token }}"
   runners:
     config: |
       [[runners]]
         [runners.cache]
           # 引用公共MinIO配置
           AccessKey = "{{ .Values.common.minio.runnerUser.login }}"
           BucketName = "{{ .Values.common.minio.bucket }}"
           # 其他缓存配置
   

4. 安装父Chart

   helm install gitlab-stack ./gitlab-stack --namespace gitlab-ns
   

方法3：Kubernetes ConfigMap/Secret（适合非Helm部署的资源）

对于dind这类用kubectl直接部署的资源，可将公共配置存入Kubernetes的ConfigMap/Secret，通过环境变量引用：

1. 创建公共ConfigMap

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: common-config
     namespace: gitlab-ns
   data:
     MINIO_HOST: minio
     MINIO_PORT: "80"
     MINIO_BUCKET: runners-bucket
   

2. 创建公共Secret

   apiVersion: v1
   kind: Secret
   metadata:
     name: common-secrets
     namespace: gitlab-ns
   type: Opaque
   stringData:
     MINIO_ROOT_LOGIN: admin
     MINIO_ROOT_PWD: secret1
     GITLAB_RUNNER_TOKEN: secret3
   

3. 在资源中引用

   • GitLab Runner的values.yaml引用已存在的Secret：

     runnerToken: ""
     existingSecret: "common-secrets"
     runnerTokenKey: "GITLAB_RUNNER_TOKEN"
     

   • dind的Deployment通过环境变量引用：

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: dind
       namespace: gitlab-ns
     spec:
       template:
         spec:
           containers:
           - name: dind
             image: docker:dind
             env:
             - name: MINIO_HOST
               valueFrom:
                 configMapKeyRef:
                   name: common-config
                   key: MINIO_HOST
             - name: MINIO_ROOT_LOGIN
               valueFrom:
                 secretKeyRef:
                   name: common-secrets
                   key: MINIO_ROOT_LOGIN
     

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