CodePipeline流水线实现自动发布Serverless Kubernetes

2021-08-17 18:07:07

本文档以构建一个 Java 软件项目并部署到阿里云容器服务Serverless Kubernetes集群为例说明如何使用 CodePipeline。

使用说明

开通使用 CodePipeline 产品。
前往 RAM 进行 CodePipeline 默认角色的授权。

操作步骤

新建项目

单击新建，输入项目名称，选择 构建一个Java的软件项目 ，单击 下一步。

代码构建配置

本页所有默认配置为CodePipeline为您提供的示例，快速体验可以直接单击 下一步。

Repository 中配置的是仓库地址和证书，默认值是CodePipeline公开的Code仓库地址。
Branches to build 中配置的是代码分支，默认值是master分支。
构建中配置的是代码构建命令，默认值是mvn package -B -DskipTests。
测试中配置的是单元测试命令，默认值是mvn test。如果您不需要做单元测试，可以不填写测试命令。

选择部署方式

选择部署方式，单击 部署到Kubernetes。

配置镜像构建和发布

镜像仓库名称。镜像仓库名格式为namespace/镜像仓库名。
镜像版本号。如果为空，则默认是latest。
Registry地址。Registry地址用来配置docker registry地址，如果为空，默认使用Docker hub registry ,https://index.docker.io/v1/；如果使用阿里云registry，请填写https://registry.cn-beijing.aliyuncs.com/v2/，其中地域cn-beijing根据用户实际的镜像仓库地域来修改。
Registry证书。用来添加授权信息，请添加Registry授权类型的证书。
Dockerfile路径。填写Dockerfile文件在该项目工作空间的相对路径。如果该配置为空，则默认使用工作空间目录下命名为Dockerfile的文件。

配置部署Kubernetes

选择 认证方式。
Serverless Kubernetes集群均使用证书认证方式。

填写 API服务器地址。
请输入 Serverless Kubernetes集群API服务器地址，您可以通过阿里云容器服务控制台 -> Kubernetes集群列表 -> ${Serverless Kubernetes集群名称} -> 管理，找到 API Server连接端点。例如，c264313085e994df****508afcd25eee6.serverless-1.kubernetes.cn-shanghai.aliyuncs.com:6443。在该字符串头部添加https:// 作为Codepipeline的API服务器地址。例如，https://c264313085e994df****508afcd25eee6.serverless-1.kubernetes.cn-shanghai.aliyuncs.com:6443。

添加并使用 Docker授权 类型的证书。

如果是阿里云容器服务Serverless Kubernetes集群，请把控制台提供的 集群凭据 保存到本机 ~/.kube/config。如下图所示内容。

接着在本机执行cat ~/.kube/config |grep client-key-data |awk -F ' ' '{print $2}' | base64 -d > client.key，把client.key文件的内容填入 客户端Key 对话框。

执行cat ~/.kube/config |grep client-certificate-data |awk -F ' ' '{print $2}' | base64 -d > client.crt, 把client.crt文件的内容填入 客户端证书 对话框。

添加 部署配置文件。

输入yaml格式的Kubernetes部署配置文件。
如果文件在当前项目的workspace下，请直接输入文件名，如果在项目workspace的子目录中，请输入 ..子目录/文件名。
不支持位于当前项目的workspace之外的文件。

添加 状态检查配置。

支持检验的 Kubernetes Kind: pods,deployments。
请用 ":" 分隔 Kubernetes Kind 和 Kind name, 用 "," 分隔多个 Kind name。每一行描述一种 Kubernetes Kind。
示例配置:

pods:pods1,pods2
deployments:ds1,ds2

注意：

请严格按照说明填写单词，不要删减字母；请勿填写多余的空格或者换行。
Serverless Kubernetes集群只支持default namespace。
更多Serverless Kubernetes集群功能支持请参考 Serverless Kubernetes集群文档。

添加 变量申明配置。

支持系统环境变量，可以通过 ${JENKINS_URL}/env-vars.html/ 查看。
如果使用了多个变量，请用","分隔。
您可以在上文的部署配置文件中使用变量，请以 ${BUILD_NUMBER} 格式严格填写，其他格式插件将忽略。
示例:
BUILD_NUMBER,JOB_NAME

单击 下一步。
检查所有配置信息，单击提交。

参数化构建配置

如果需要在构建过程中使用一些动态变量，请参考注入环境变量文档。下面我们将具体描述如何使用注入环境变量插件，来配置时间戳作为镜像标签。

首先，在代码根目录下准备一个 env.properties 文件。
添加一个执行shell脚本的构建步骤作为构建步骤的第一步，使用鼠标拖拽到最前面。添加如下脚本：

TIME=`date +%Y%m%d%H%M%S`
echo TAG=$TIME >> env.properties
cat env.properties

添加一个注入环境变量的构建步骤作为构建步骤的第二步，同样使用鼠标拖拽到第二个位置。配置 env.properties 作为变量文件。
修改镜像构建和发布构建步骤配置。把镜像版本号改成上文中设置的参数$TAG。
修改部署Kubernetes（新）构建步骤配置。在变量申明配置中把BUILD_NUMBER 修改成 TAG。
修改源代码中部署配置文件中的镜像版本号为${TAG}。例如：

执行构建

完成项目的任务配置后，可以单击左侧导航栏中的 立即构建，开始执行配置中的构建及部署命令。
您可以在构建队列及构建历史中查看构建状态。单击 构建序号，进入该次构建具体信息页面。
然后在侧导航中，单击 控制台输出，可以查看该次构建日志。

码农公寓