迁移 Jenkins Agent 镜像¶

本文适用于： - Jenkins v0.5.0 及以上 - 应用工作台 v0.35 及以上 - DCE 5.0 安装器 v0.27 及以上

自 Jenkins 升级到 v0.4.8 版本以后，我们对 Jenkins 的 Chart 进行了精简，避免在安装 DCE 5.0 时因为镜像体积过大导致安装时间过长，这加快了安装速度，同时提升了系统的稳定性。从 v0.4.8 开始，Jenkins 的 Chart 分为两个：

Jenkins 精简版，包含 Jenkins 的核心功能。其中，Jenkins Agent 的镜像仅包含：
- base
- nodejs (16.20.2)
- python (3.8.19)
- golang (1.22.6)
- maven (jdk8)
除此之外，**不再**提供 CentOS 系统的镜像。
jenkins-full：完全版的 Jenkins。除了上述的镜像外，还包含不同版本的 Agent 镜像，例如 Python 包含 3.8.19、2.7.9、3.11.9 等多个版本的镜像，具体的 Agent 镜像版本查阅 Agent 版本列表。

为了保证 DCE 5.0 升级的兼容性，Jenkins 升级以后虽然名称不变，但是可选的镜像列表发生了变化（镜像依旧存在于镜像仓库中），需要手动修改 Agent 镜像的映射关系。

如果您仅使用到了 base、golang、nodejs、maven、python， 不需要 执行以下操作。本文仅适用于使用了非默认 Agent 镜像的用户。如您使用了类似于 go-v1.17.13 这样带版本号的 Agent，请按照下面 👇 的步骤进行迁移。

迁移步骤¶

Jenkins 可用的 Agent 镜像通过 ConfigMap 进行映射，修改步骤如下：

在 DCE 5.0 的界面中，点击左上角的 ≡ 打开导航栏，选择 容器管理 -> 集群列表 ，找到并点击集群名称 kpanda-global-cluster。
在左侧导航栏中选择 存储和密钥 -> 配置项 ，命名空间选择 amamba-system 集群，名称搜素 global-jenkins-casc-config
进入详情，点击右上角的 编辑 YAML , YAML 的路径为 data -> jenkins.yaml -> jenkins -> clouds -> kubernetes -> templates

如果对应的 key 不存在，您需要新建一份，格式参考 Jenkins 安装的 namespace 下的配置项：jenkins-casc-config
其中 label 字段表示的是在 UI 或者 JenkinsFile 中使用的 agent label 名称。
选择您需要修改的 agent label，将 containers 字段中的对应的 container（例如 go、python 等）的 image 修改为对应版本的镜像

例如，升级前使用的 agent label 是 go-1.17.13，对应的镜像为 https://my-regiestry.com/go-v1.17.13。升级之后，configmap 中只有 label 为 go 的 template，您需要将 go 对应的 image 改为 https://my-regiestry.com/go-v1.17.13

    kind: ConfigMap
    apiVersion: v1
    metadata:
      name: global-jenkins-casc-config
      namespace: amamba-system
    data:
      jenkins.yaml: |
        jenkins:
          clouds:
          - kubernetes:
              templates:
              - containers:
                - args: ""
                  image: amambadev/jenkins-agent-go:v0.4.6-1.17.13-ubuntu-podman  # 修改为对应agent版本的镜像地址
                  name: go                  
                - args: ^${computer.jnlpmac} ^${computer.name}
                  image: docker.m.daocloud.io/jenkins/inbound-agent:4.10-2        # jnlp的配置不需要改动
                  name: jnlp
                label: go   # 对应的label
                name: go

迁移 Jenkins Agent 镜像¶

迁移步骤¶

评论