本文档以构建一个 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}。例如：
执行构建
- 完成项目的任务配置后，可以单击左侧导航栏中的 立即构建，开始执行配置中的构建及部署命令。
- 您可以在构建队列及构建历史中查看构建状态。单击 构建序号，进入该次构建具体信息页面。
- 然后在侧导航中，单击 控制台输出，可以查看该次构建日志。
