ACK One工作流集群基于开源Argo Workflows项目构建,全托管Argo Workflows,具有极致弹性、自动扩展、无运维成本等优势,可以帮助您快速实现更简单、低成本、高效率的CI流水线。本文为您介绍如何基于工作流集群构建Golang项目的CI Pipeline。
方案介绍
ACK One工作流集群构建CI Pipeline,主要使用BuildKit实现容器镜像的构建和推送,并使用BuildKit Cache加速镜像的构建。使用NAS存储Go mod cache,可加速go test
和go build
运行过程,最终大幅加速CI Pipeline的流程。
预置工作流模板说明
工作流集群中默认已经预置了名为ci-go-v1
的CI工作流模板(ClusterWorkflowTemplate),其使用BuildKit Cache和NAS存储Go mode cache,可大幅加速CI Pipeline的流程。
您可以直接使用预置模板,也可以基于预置模板自定义自己的CI工作流模板。
预置的CI工作流模板中包含以下流程:
Git Clone & Checkout
用于Clone Git仓库,将Git仓库Checkout到目标分支。
获取Commit ID,在构建镜像时根据Commit ID追加Tag后缀。
Run Go Test
默认运行Git Repo(Go项目)中的所有测试用例。
可通过工作流参数
enable_test
控制是否运行该步骤。其中Go mod cache存储在NAS的
/pkg/mod
目录,用于go test
和后续的go build
的加速。
Build & Push Image
使用BuildKit构建和推送容器镜像,并使用BuildKit Cache中registry类型的cache来加速镜像构建。
镜像Tag默认使用
{container_tag}-{commit_id}
格式,可在提交工作流时通过参数控制是否追加Commit ID。推送镜像的同时,也会推送覆盖其latest版本镜像。
预置的CI工作流模板内容如下:
模板中暴露的参数如下:
参数 | 说明 | 示例值 |
entrypoint | 定义入口模板。 | main |
repo_url | Git仓库的url。 | https://github.com/ivan-cai/echo-server.git |
repo_name | 仓库名称。 | echo-server |
target_branch | 仓库的目标分支。 默认为main。 | main |
container_image | 要构建的镜像。格式如下: <ACR EE Domain>/<ACR EE命名空间>/<仓库名>。 | test-registry.cn-hongkong.cr.aliyuncs.com/acs/echo-server |
container_tag | 要构建的镜像Tag。 默认为v1.0.0。 | v1.0.0 |
dockerfile | Dockerfile目录和文件名。 项目根目录下的相对路径,默认为 |
|
enable_suffix_commitid | 是否在镜像Tag后追加Commit ID。
默认值为true。 | true |
enable_test | 是否开启运行Go Test步骤。
默认值为true。 | true |
前提条件
从ACK One控制台获取工作流集群的KubeConfig,并通过kubectl连接至工作流集群。具体操作,请参见获取集群KubeConfig并通过kubectl工具连接集群。
操作步骤
本文以公共Git仓库为例为您介绍构建CI Pipeline的操作,如果您在工作流的CI Pipeline中使用的是私有Git仓库,则需要在CI流程中先成功Clone该私有仓库。具体的Clone操作,请参见在CI Pipeline中Clone私有Git仓库。
保存容器镜像访问凭证的Secret和挂载的NAS存储卷都需要与最终提交的工作流在同一个命名空间下。
步骤一:在工作流集群中创建ACR EE访问凭证
ACR EE访问凭证主要用于BuildKit推送镜像。
为ACR EE配置访问凭证。具体操作,请参见配置访问凭证。
执行如下命令,在工作流集群中创建Secret保存ACR EE的密码,供BuildKit使用。
$username:$password
需要替换为您实际为ACR EE配置的访问凭证信息。kubectl create secret generic docker-config --from-literal="config.json={\"auths\": {\"$repositoryDomain\": {\"auth\": \"$(echo -n $username:$password|base64)\"}}}"
步骤二:在工作流集群中挂载NAS存储卷
使用NAS存储卷的目的如下:
在工作流的各任务之间共享数据,如Clone的代码仓库信息等。
存储Go mod cache,用于加速CI Pipeline中的
go test
和go build
过程。
在工作流集群中使用NAS存储卷的步骤如下:
获取NAS文件系统的挂载点地址。具体操作,请参见管理挂载点。
使用以下内容在工作流集群中创建PV/PVC。具体操作,请参见使用NAS存储卷。
apiVersion: v1 kind: PersistentVolume metadata: name: pv-nas labels: alicloud-pvname: pv-nas spec: capacity: storage: 100Gi accessModes: - ReadWriteMany csi: driver: nasplugin.csi.alibabacloud.com volumeHandle: pv-nas # 必须与PV Name保持一致。 volumeAttributes: server: <your nas filesystem mount point address> path: "/" mountOptions: - nolock,tcp,noresvport - vers=3 --- kind: PersistentVolumeClaim apiVersion: v1 metadata: name: pvc-nas spec: accessModes: - ReadWriteMany resources: requests: storage: 100Gi selector: matchLabels: alicloud-pvname: pv-nas
步骤三:基于预置模板启动工作流
通过控制台提交工作流
登录ACK One控制台,在左侧导航栏选择 。
在集群信息页面,单击基础信息页签,然后在下方常用操作区域,单击工作流控制台(Argo)。
在Argo工作台左侧导航栏单击Cluster Workflow Templates,然后单击ci-go-v1预置模板名称。
在模板详情页左上角单击+ SUBMIT,然后在弹出的面板中填写相关参数,并在面板下方单击+ SUBMIT。
参数填写请参考模板参数说明将参数值设置为您实际使用的参数值。
操作完成后,您可在Workflows详情页查看工作流运行情况:
通过Argo CLI提交工作流
使用以下内容创建
workflow.yaml
文件,按照模板参数说明将参数值修改为您实际使用的参数值。apiVersion: argoproj.io/v1alpha1 kind: Workflow metadata: generateName: ci-go-v1- labels: workflows.argoproj.io/workflow-template: ackone-ci spec: arguments: parameters: - name: repo_url value: https://github.com/ivan-cai/echo-server.git - name: repo_name value: echo-server - name: target_branch value: main - name: container_image value: "test-registry.cn-hongkong.cr.aliyuncs.com/acs/echo-server" - name: container_tag value: "v1.0.0" - name: dockerfile value: ./Dockerfile - name: enable_suffix_commitid value: "true" - name: enable_test value: "true" workflowTemplateRef: name: ci-go-v1 clusterScope: true
执行以下命令提交工作流。
argo submit workflow.yaml
相关文档
本文以公共Git仓库为例为您介绍构建CI Pipeline的操作,如果您在工作流的CI Pipeline中使用的是私有Git仓库,则需要在CI流程中先成功Clone该私有仓库。具体的Clone操作,请参见在CI Pipeline中Clone私有Git仓库。