全部产品
阿里云办公

构建并部署到Serverless Kubernetes

更新时间:2018-05-24 11:40:22

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

使用说明

  • 开通使用 CodePipeline 产品。

  • 前往 RAM 进行 CodePipeline 默认角色的授权。

操作步骤

新建项目

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

代码构建配置

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

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

选择部署方式

选择部署方式,单击 部署到Kubernetes

配置 镜像构建和发布

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

配置 部署Kubernetes

  • 选择 认证方式

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

  • 填写 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:64431

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

如果是阿里云容器服务Serverless Kubernetes集群,,在集群 基本信息 页面,找到 配置集群凭据 中提供的 KubeConfig10

client-key-data 的内容(冒号后面的字符串)填入 客户端Key 对话框。

client-certificate-data 的内容(冒号后面的字符串)填入 客户端证书 对话框。

  • 添加 部署配置文件

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

  • 添加 状态检查配置

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

  1. pods:pods1,pods2
  2. deployments:ds1,ds2

3注意:

  1. 1. 请严格按照说明填写单词,不要删减字母;请勿填写多余的空格或者换行。
  2. 2. Serverless Kubernetes集群只支持default namespace
  3. 3. 更多Serverless Kubernetes集群功能支持请参考 [Serverless Kubernetes集群文档](https://help.aliyun.com/document_detail/71503.html?spm=a2c4g.11186623.6.644.0k9T43)。
  • 添加 变量申明配置

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

  • 单击 下一步
  • 检查所有配置信息,单击 提交

参数化构建配置

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

  • 首先,在代码根目录下准备一个 env.properties 文件。
  • 添加一个 执行shell脚本 的构建步骤 作为构建步骤的第一步,使用鼠标拖拽到最前面。添加如下脚本:
    1. TIME=`date +%Y%m%d%H%M%S`
    2. echo TAG=$TIME >> env.properties
    3. cat env.properties
    15
  • 添加一个 注入环境变量 的构建步骤 作为构建步骤的第二步,同样使用鼠标拖拽到第二个位置。配置 env.properties 作为变量文件。16
  • 修改 镜像构建和发布 构建步骤配置。把 镜像版本号 改成上文中设置的参数$TAG17
  • 修改 部署Kubernetes(新)构建步骤配置。在 变量申明配置 中把BUILD_NUMBER 修改成 TAG。18
  • 修改 源代码中 部署配置文件 中的镜像版本号为${TAG}。例如:19

执行构建

  • 完成项目的任务配置后,可以单击左侧导航栏中的 立即构建,开始执行配置中的构建及部署命令。build

  • 您可以在构建队列及构建历史中查看构建状态。单击 构建序号,进入该次构建具体信息页面。history

  • 然后在侧导航中,单击 控制台输出,可以查看该次构建日志。output