跳转至

流水线相关问题

本页列出使用应用工作台的流水线功能时时可能遇到的一些问题,并给出相应的解决方案。

执行流水线时报错

当 Jenkins 所在集群与应用部署集群跨数据中心时,网络通信延迟会变高,可能遇到如下的报错信息:

E0113 01:47:27.690555 50 request.go:1058] Unexpected error when reading response body: net/http: request canceled (Client.Timeout or context cancellation while reading body)
error: unexpected error when reading response body. Please retry. Original error: net/http: request canceled (Client.Timeout or context cancellation while reading body)

解决方案

在该流水线的 Jenkinsfile 中将部署命令由 kubectl apply -f 修改为 kubectl apply -f . --request-timeout=30m

如何更新内置 Label 的 podTemplate 镜像?

应用工作台通过 podTemplate 能力声明了 7 个 label: basemavenmavenjdk11gogo16node.jspython 。 您可以指定具体的 Agent 标签来使用对应的 podTemplate。

如果内置 podTemplate 中的镜像不满足您的需求,可以通过以下方式替换容器镜像或者添加容器镜像。

  1. 点击左上角的 打开导航栏,前往容器管理模块,找到 Jenkins 组件所在的集群,点击集群名称。

    faq-ci2

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 jenkins-casc-config ,在操作列点击 编辑 YAML

    faq-ci3

  4. data -> jenkins.yaml -> jenkins.clouds.kubernetes.templates 字段下选择需要更改的 podTemplate 的镜像。

    faq-ci4

  5. 更新完成后,前往 工作负载 重启 Jenkins。

流水线构建环境为 maven 时,如何在 settings.xml 中修改依赖包来源?

当流水线构建环境为 maven 时,大多数客户需要修改 settings.xml 以更换依赖源。可参考以下步骤:

  1. 点击左上角的 打开导航栏,前往容器管理模块,在 集群列表 界面选择 Jenkins 组件所在的集群,点击集群名称。

    faq-ci2

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 amamba-devops-agent ,在操作列点击 编辑 YAML

    faq-ci5

  4. data 模块 下的 MavenSetting 按需修改。

    faq-ci6

  5. 更新完成后,需要前往 工作负载 重启 Jenkins。

通过 Jenkins 构建镜像时,容器无法访问私有镜像仓库

集群运行时为 Podman

  1. 点击左上角的 打开导航栏,前往容器管理模块,在 集群列表 界面找到 Jenkins 组件所在的集群,点击集群名称。

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 insecure-registries ,在操作列点击 编辑 YAML

  4. data 模块下的 registries.conf 下配置。

    修改时注意格式缩进,并且每个 registry 需要一个单独的 [[registry]] 部分,如下图所示:

    faq-ci1

    Note

    registries 关键字的值应该是完整的镜像仓库域名或 IP 地址,无需增加 httphttps 前缀。 如果镜像仓库使用非标准端口号,可以在地址后面加上冒号 : 和端口号。

    [[registry]]
    location = "registry.example.com:5000"
    insecure = true
    
    [[registry]]
    location = "192.168.1.100:8080"
    insecure = true
    

    另请参考 Podman 官网指导文档

集群运行时为 Docker

  1. 打开 Docker 的配置文件。在大多数 Linux 发行版上,配置文件位于 /etc/docker/daemon.json ,如果不存在,请创建此配置文件。

  2. insecure-registries 的字段将仓库地址添加进去。

    {
      "insecure-registries": ["10.16.10.120:4443"]
    }
    
  3. 保存后重启 Docker,执行如下命令:

    sudo systemctl daemon-reload
    sudo systemctl restart docker
    

Note

参考 Docker 官方指导文档

如何修改 Jenkins 流水线并发执行数量

目前 DCE 5.0 部署出来后 Jenkins 流水线并发执行数量为 2,下述将描述如何更改并发执行数量:

  1. 点击左上角的 打开导航栏,前往容器管理模块,找到 Jenkins 组件所在的集群,点击集群名称。

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 jenkins-casc-config ,在操作列点击 编辑 YAML

  4. data -> jenkins.yaml -> jenkins.clouds.kubernetes.containerCapStr 字段下修改数值。

    jenkins001

  5. 更新完成后,前往 工作负载 重启 Jenkins。

流水线运行状态更新不及时?

在 Jenkins 的 Pod 中,会存在一个名为 event-proxy 的 Sidecar 容器,通过此容器将 Jenkins 的事件发送到工作台中。 目前通过 dce5-installer 安装的 Jenkins 会默认开启此容器。当然, 你也可以选择在容器管理的 Addon 模块中自己创建 Jenkins(这通常用于 Jenkins 部署在工作集群),在创建时也可以选择是否开启此容器。

下面基于此容器是否开启,请分别检查不同的配置项是否正确:

开启了 event-proxy 容器

  1. 点击左上角的 打开导航栏,前往容器管理模块,找到 Jenkins 组件所在的集群,点击集群名称。

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 jenkins-casc-config ,在操作列点击 编辑 YAML

  4. data -> jenkins.yaml -> 搜索 eventDispatcher.receiver,它的值应该为 http://localhost:9090/event

    如果 Jenkins 是部署在工作集群(需要穿透 DCE 5.0 的网关),则还需要检查以下几个配置项。

  5. 再次查询名为 event-proxy-config 的配置项,查看 YAML,配置项说明:

    eventProxy:
      host: amamba-devops-server.amamba-system:80   # (1)!
      proto: http                                   # (2)!
    
    1. 此处为 DCE 5.0 的网关地址,如果为 dce5-installer 安装的 Jenkins,此处不需要修改
    2. 此处为 DCE 5.0 的网关协议(http 或者 https)
  6. 在 Jenkins 所在集群, 配置与密钥 -> 配置项 中搜索密钥 amamba-jenkins

  7. 检查密钥中的 event-proxy-token 是否正确。此 Token 用于 DCE 5.0 的网关认证。 如果不正确,Jenkins 将无法发送事件到工作台。有关如何生成此 Token, 可以查看访问密钥

如果以上配置项都正确,但是 Jenkins 的流水线状态还是无法更新,请先查看 Jenkins 的 event-proxy 的容器日志。

未开启 event-proxy 容器

  1. 点击左上角的 打开导航栏,前往容器管理模块,找到 Jenkins 组件所在的集群,点击集群名称。

  2. 在左侧导航栏依次点击 配置与密钥 -> 配置项

  3. 搜索 jenkins-casc-config ,在操作列点击 编辑 YAML

  4. data -> jenkins.yaml -> 搜索 eventDispatcher.receiver,它的值应该为 http://amamba-devops-server.amamba-system:80/apis/internel.amamba.io/devops/pipeline/v1alpha1/webhooks/jenkins。 其中 amamba-system 为工作台所部署的命名空间。

评论