当前位置： 首页 > news >正文

gitlab-runner 如何配置使用 Overwrite generated pod specifications

news 2025/6/12 17:33:13

gitlab-runner 如何配置使用Overwrite generated pod specifications

说明

Overwrite generated pod specifications

此功能目前处于 Beta 阶段。我们强烈建议您先在测试 Kubernetes 集群上使用此功能，然后再将其用于生产集群。要使用此功能，您必须启用 FF_USE_ADVANCED_POD_SPEC_CONFIGURATION 功能标志。

要修改runner 管理端生成的 PodSpec，请使用 config.toml 文件中的 pod_spec 设置。

pod_spec 设置：

  • 覆盖并补全生成的 pod 规范的字段。
  • 覆盖 [runners.kubernetes] 下的 config.toml 中可能已设置的配置值。

你可以配置多个 pod_spec 设置：

  • name ：定义 pod_spec 的名称。
  • patch_path ：定义在生成最终 PodSpec 对象之前应用于该对象的更改的文件路径。该文件必须是 JSON 或 YAML 文件。
  • patch ：一个 JSON 或 YAML 格式的字符串，描述在生成最终 PodSpec 对象之前必须应用于它的更改。
  • patch_type ：runner用于将指定更改应用于 GitLab Runner 生成的 PodSpec 对象的策略。可接受的值包括 merge、json 和 strategic。

不能在同一个 pod_spec 配置中设置 patch_path 和 patch，否则会出错。

Merge patch strategy（不推荐）

合并补丁策略将键值替换应用于现有的 PodSpec。如果使用此策略，config.toml 中的 pod_spec 配置会覆盖最终 PodSpec 对象生成之前的值。因为这些值被完全覆盖，所以你应该谨慎使用此补丁策略。

如：

concurrent = 1
check_interval = 1
log_level = "debug"
shutdown_timeout = 0[session_server]session_timeout = 1800[[runners]]name = ""url = "https://gitlab.example.com"id = 0token = "__REDACTED__"token_obtained_at = 0001-01-01T00:00:00Ztoken_expires_at = 0001-01-01T00:00:00Zexecutor = "kubernetes"shell = "bash"environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true", "CUSTOM_VAR=value"][runners.kubernetes]image = "alpine"...[[runners.kubernetes.pod_spec]]name = "build envvars"patch = '''containers:- env:- name: env1value: "value1"- name: env2value: "value2"name: build'''patch_type = "merge"

使用此配置，最终的 PodSpec 只有一个名为 build 的容器，其中包含两个环境变量 env1 和 env2。上面的示例导致相关的 CI 作业失败，原因如下：

  • helper 容器规范被移除。
  • build 容器规范丢失了 GitLab Runner 设置的所有必要配置。 为了防止作业失败，在此示例中，pod_spec 必须包含 GitLab Runner 生成的未修改的属性。

JSON patch strategy

JSON 补丁策略使用 JSON 补丁规范来控制 PodSpec 对象和数组的更新。不能在数组属性上使用此策略。

以下是使用 JSON 补丁策略的 pod_spec 配置示例。在此配置中，新的键值对被添加到现有的 nodeSelector 中。现有值不会被覆盖。

concurrent = 1
check_interval = 1
log_level = "debug"
shutdown_timeout = 0[session_server]session_timeout = 1800[[runners]]name = ""url = "https://gitlab.example.com"id = 0token = "__REDACTED__"token_obtained_at = 0001-01-01T00:00:00Ztoken_expires_at = 0001-01-01T00:00:00Zexecutor = "kubernetes"shell = "bash"environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true", "CUSTOM_VAR=value"][runners.kubernetes]image = "alpine"...[[runners.kubernetes.pod_spec]]name = "val1 node"patch = '''{ "op": "add", "path": "/nodeSelector", "value": { key1: "val1" } }'''patch_type = "json"

Strategic patch strategy

此策略性补丁策略使用应用于 PodSpec 对象每个字段的现有 patchStrategy。

以下是一个使用策略性补丁策略的 pod_spec 配置示例。在此配置中，资源请求设置为 build 容器。

concurrent = 1
check_interval = 1
log_level = "debug"
shutdown_timeout = 0[session_server]session_timeout = 1800[[runners]]name = ""url = "https://gitlab.example.com"id = 0token = "__REDACTED__"token_obtained_at = 0001-01-01T00:00:00Ztoken_expires_at = 0001-01-01T00:00:00Zexecutor = "kubernetes"shell = "bash"environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true", "CUSTOM_VAR=value"][runners.kubernetes]image = "alpine"...[[runners.kubernetes.pod_spec]]name = "cpu request 500m"patch = '''containers:- name: buildresources:requests:cpu: "500m"'''patch_type = "strategic"

Best practices

  • 在部署到生产环境之前，请在测试环境中测试添加的 pod_spec。

  • 确保 pod_spec 配置不会对 GitLab Runner 生成的规范产生负面影响。

  • 对于复杂的 pod 规范更新，请勿使用合并补丁策略。

  • 如果配置可用，请尽可能使用 config.toml。例如，以下配置会将 GitLab Runner 设置的第一个环境变量替换为自定义 pod_spec 中设置的变量，而不是将环境变量添加到现有列表中。

    concurrent = 1
check_interval = 1
log_level = "debug"
shutdown_timeout = 0[session_server]session_timeout = 1800[[runners]]name = ""url = "https://gitlab.example.com"id = 0token = "__REDACTED__"token_obtained_at = 0001-01-01T00:00:00Ztoken_expires_at = 0001-01-01T00:00:00Zexecutor = "kubernetes"shell = "bash"environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true", "CUSTOM_VAR=value"][runners.kubernetes]image = "alpine"...[[runners.kubernetes.pod_spec]]name = "build envvars"patch = '''containers:- env:- name: env1value: "value1"name: build'''patch_type = "strategic"

patch

场景1：JSON patch strategy

runners:
config: |[[runners]]environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true"][runners.kubernetes]pull_policy = ["if-not-present"]namespace = "{{.Release.Namespace}}"privileged = trueimage = "alpine"[[runners.kubernetes.pod_spec]]name = "test_spec"patch = '''[{"op": "add","path": "/containers/0/resources","value": {"limits": {"cpu": "800m"},"requests": {"cpu": "600m"}}}]'''patch_type = "json"

在这里插入图片描述

在这里插入图片描述

场景2：Strategic patch strategy

runners:
config: |[[runners]]environment = ["FF_USE_ADVANCED_POD_SPEC_CONFIGURATION=true"][runners.kubernetes]pull_policy = ["if-not-present"]namespace = "{{.Release.Namespace}}"privileged = trueimage = "alpine"[[runners.kubernetes.pod_spec]]name = "test_spec"patch = '''containers:- name: buildresources:requests:cpu: "400m"limits:cpu: "700m"'''patch_type = "strategic"

在这里插入图片描述

在这里插入图片描述

patch_path

patch_path ：定义在生成最终 PodSpec 对象之前应用于该对象的更改的文件路径。该文件必须是 JSON 或 YAML 文件。

创建文件

cat runner-pod-patches.yml

apiVersion: v1
kind: ConfigMap
metadata:name: runner-pod-patches
data:pod-patch.yaml: |[{"op": "add","path": "/containers/0/resources","value": {"limits": {"cpu": "500m"},"requests": {"cpu": "200m"}}}]

kubectl apply -f runner-pod-patches.yml
http://www.xdnf.cn/news/967843.html

相关文章：

  • 图注意力卷积神经网络GAT在无线通信网络拓扑推理中的应用
  • 第四章 软件需求工程
  • 上位机开发：C# 读写 PLC 数据块数据
  • CppCon 2015 学习:Racing the File System
  • “详规一张图”——上海土地利用数据
  • 《大模型RAG进阶实战训练营毕业总结》
  • 多模态2025：技术路线“神仙打架”，视频生成冲上云霄
  • 雷卯针对易百纳海鸥派海思SD3403 SS928智能视觉AI视觉国产化4K视频开发板防雷防静电方案
  • 香橙派3B学习笔记9：Linux基础gcc/g++编译__C/C++中动态链接库（.so）的编译与使用
  • Vim 匹配跳转与搜索命令完整学习笔记
  • ArcGIS Pro 3.4 二次开发 - 任务
  • word的目录和正文之间存在一张空白纸，目录后面的分节符为什么调不上去？
  • 《函数之恋》
  • STL 4函数对象
  • 工控类UI设计经常接触到10.1寸迪文屏
  • React【回顾】 深层次面试详解：函数式组件核心原理与高级优化
  • 香港科技大学（广州）机器人与自主系统学域（ROAS）2025年度夏令营招募！
  • 《高等数学》（同济大学·第7版）第三章第六节函数图形的描绘
  • 如何判断Cursor邮箱被封？
  • 【Dv3Admin】系统视图角色菜单API文件解析
  • 钉钉告警集成部署指南
  • DataSource学习
  • 【时时三省】(C语言基础)静态局部变量(static局部变量)
  • Visual Studio2022配置OpenCV环境
  • 自定义表单组件面板排序处理
  • 页面渲染流程与性能优化
  • 如何删除导出的xml中的xmlns:xsd=
  • XML Group端口详解
  • RSA算法
  • 第4章 对象与类