Flow 提供了 Kubernetes 镜像升级任务,支持用户对集群中的已有应用进行镜像升级。
前提条件
请确保已经在阿里云的ACK集群或者自定义K8s集群上部署了应用镜像服务,有关在流水线上部署ACK集群镜像应用,可以参见Node.js 应用构建并部署到 ACK 集群。
添加镜像升级任务
在流水线Flow 控制台,选择目标流水线,添加Kubernetes 镜像升级任务。
在流程配置页面单击新阶段,在任务选择面板左侧选择部署分类,然后在右侧列表中选择Kubernetes 镜像升级。
镜像升级任务部署配置
在目标流水线任务步骤中,配置Kubernetes 镜像升级任务。
参数
说明
步骤名称
自定义步骤名称。
集群连接
使用集群连接,连接到自定义Kubernetes或者阿里云容器服务集群,如果第一次使用可以新建连接,详情可参见Kubernetes 服务连接。
Kubectl版本
Kubectl 版本为当前步骤中使用的kubectl客户端版本。请选择与集群适配的Kubectl版本,详情可参见版本说明。
命名空间
选择Kubernetes集群中目标自定义命名空间或者默认命名空间,详情可参见管理命名空间与配额。
Workloads 类型
选择您要升级的Workloads(工作负载)类型。它是Kubernetes集群中的资源对象类型,详情可参见工作负载类型。
Workloads 名称
选择您要升级的Workloads(工作负载)名称。就是上一个参数选择的资源对象类型目标资源对象自定义名称。
容器名称
Kubernetes中一个Pod可能包含多个容器,这里需要指定升级的容器名称,详情可参见管理容器组(Pod)。
镜像
选择上游任务步骤中镜像构建仓库地址,详情可参见ACR个人版实例。
说明注意事项:
kubectl版本建议不低于服务端版本。
k8s的命名空间确保正确。
Workloads类型默认为Deployment,如果是其他类型如StatefulSet,记得修改。
Workloads的名称和容器名称必须与实际运行的一致。
镜像有两种方式输入:1. 从前序构建产物中选择;2. 直接输入镜像地址。注意:如果选择不到镜像,请检查前序是否有镜像构建并上传的步骤;另外需注意镜像地址可能有多个,如公网地址和VPC地址,请确保k8s能拉取到对应的地址。
保存并运行流水线。配置完成后单击运行,流水线依次执行流水线源(拉取代码)、构建(镜像构建并推送至ACR个人版)和Kubernetes 镜像升级三个阶段,全部显示绿色勾号表示运行成功。
查看日志和发布单详细信息。
流水线所有步骤(申请运行环境、清理工作区、克隆代码、流水线缓存、Kubectl镜像升级、缓存上传)均执行成功。Kubectl镜像升级日志显示集群类型为 ack,命名空间为 default,资源类型为 deployments,部署名称为 node-expressjs-sample,通过
kubectl set image命令将容器镜像更新为 ACR 仓库中的指定版本镜像。查看应用镜像升级前后的POD容器输出日志结果。
升级前
[2024-12-11 14:18.20] ~/.kube [xxx] > kubectl get pod,svc,deploy NAME READY STATUS RESTARTS AGE pod/node-expressjs-sample-66f4c86989-cbl5j 1/1 Running 0 117s pod/node-expressjs-sample-66f4c86989-prv7p 1/1 Running 0 109s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/kubernetes ClusterIP 192.168.0.1 <none> 443/TCP 23h service/node-expressjs-sample ClusterIP 192.168.7.205 <none> 3000/TCP 16m NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/node-expressjs-sample 2/2 2 2 16m [2024-12-11 14:18.23] ~/.kube [xxx] > kubectl logs pod/node-expressjs-sample-66f4c86989-cbl5j Server running on port 3000升级之后
[2024-12-11 14:26:19] ~/.kube [xxx] ▶ kubectl get pod,svc,deploy NAME READY STATUS RESTARTS AGE pod/node-expressjs-sample-86c968b8c8-d5296 1/1 Running 0 45s pod/node-expressjs-sample-86c968b8c8-wc882 1/1 Running 0 42s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/kubernetes ClusterIP 192.168.0.1 <none> 443/TCP 23h service/node-expressjs-sample ClusterIP 192.168.7.205 <none> 3000/TCP 24m NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/node-expressjs-sample 2/2 2 2 24m [2024-12-11 14:26:31] ~/.kube [xxx] ▶ kubectl logs pod/node-expressjs-sample-86c968b8c8-wc882 Server running on port 3000, V2
常见问题
流水线Kubernetes 镜像升级步骤运行成功,但未更新镜像。
如需升级Deployment,请检查新构建的镜像的tag与当前正在运行中的容器的镜像tag是否一致。避免使用相同 tag 进行更新,推荐使用唯一 tag(如基于 commit hash 或构建时间戳)。