流水线相关问题¶

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

执行流水线时报错¶

当 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： base 、 maven 、 mavenjdk11 、 go 、 go16 、 node.js 和 python 。您可以指定具体的 Agent 标签来使用对应的 podTemplate。

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

点击左上角的 ≡ 打开导航栏，前往容器管理模块，找到 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
命名空间选择 amamba-system ，通过名称 global-jenkins-casc-config 进行搜索，在操作列点击 编辑 YAML 。
在 data -> jenkins.yaml -> jenkins.clouds.kubernetes.templates 字段下选择需要更改的 podTemplate 的镜像。
更新完成后，前往 工作负载 重启 Jenkins。

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

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

点击左上角的 ≡ 打开导航栏，前往容器管理模块，在 集群列表 界面选择 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
搜索 amamba-devops-agent ，在操作列点击 编辑 YAML 。
在 data 模块下的 MavenSetting 按需修改。
更新完成后，需要前往 工作负载 重启 Jenkins。

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

集群运行时为 Podman¶

点击左上角的 ≡ 打开导航栏，前往容器管理模块，在 集群列表 界面找到 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
搜索 insecure-registries ，在操作列点击 编辑 YAML 。
在 data 模块下的 registries.conf 下配置。

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

registries 关键字的值应该是完整的镜像仓库域名或 IP 地址，无需增加 http 或 https 前缀。如果镜像仓库使用非标准端口号，可以在地址后面加上冒号 : 和端口号。
```
[[registry]]
location = "registry.example.com:5000"
insecure = true

[[registry]]
location = "192.168.1.100:8080"
insecure = true
```
另请参考 Podman 官网指导文档。

集群运行时为 Docker¶

打开 Docker 的配置文件。在大多数 Linux 发行版上，配置文件位于 /etc/docker/daemon.json ，如果不存在，请创建此配置文件。
在 insecure-registries 的字段将仓库地址添加进去。
```
{
  "insecure-registries": ["10.16.10.120:4443"]
}
```

保存后重启 Docker，执行如下命令：

sudo systemctl daemon-reload
sudo systemctl restart docker

Note

参考 Docker 官方指导文档。

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

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

点击左上角的 ≡ 打开导航栏，前往容器管理模块，找到 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
命名空间选择 amamba-system ，通过名称 global-jenkins-casc-config 进行搜索，在操作列点击 编辑 YAML 。
在 data -> jenkins.yaml -> jenkins.clouds.kubernetes.containerCapStr 字段下修改数值。
更新完成后，前往 工作负载 重启 Jenkins。

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

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

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

开启了 event-proxy 容器¶

点击左上角的 ≡ 打开导航栏，前往容器管理模块，找到 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
搜索 jenkins-casc-config ，在操作列点击 编辑 YAML 。
在 data -> jenkins.yaml -> 搜索 eventDispatcher.receiver，它的值应该为 http://localhost:9090/event

如果 Jenkins 是部署在工作集群（需要穿透 DCE 5.0 的网关），则还需要检查以下几个配置项。
再次查询名为 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）
在 Jenkins 所在集群， 配置与密钥 -> 配置项 中搜索密钥 amamba-jenkins 。
检查密钥中的 event-proxy-token 是否正确。此 Token 用于 DCE 5.0 的网关认证。如果不正确，Jenkins 将无法发送事件到工作台。有关如何生成此 Token，可以查看访问密钥。

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

未开启 event-proxy 容器¶

点击左上角的 ≡ 打开导航栏，前往容器管理模块，找到 Jenkins 组件所在的集群，点击集群名称。
在左侧导航栏依次点击 配置与密钥 -> 配置项 。
命名空间选择 amamba-system ，通过名称 global-jenkins-casc-config 进行搜索，在操作列点击 编辑 YAML 。
在 data -> jenkins.yaml -> 搜索 eventDispatcher.receiver，它的值应该为 http://amamba-devops-server.amamba-system:80/apis/internel.amamba.io/devops/pipeline/v1alpha1/webhooks/jenkins。其中 amamba-system 为工作台所部署的命名空间。