全部产品
阿里云办公

构建并部署到Kubernetes

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

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

使用说明

  • 使用 CodePipeline 之前,您需要先开通产品。

操作步骤

  1. 登录 CodePipeline 控制台

    如果您还未开通 CodePipeline 产品的需要先开通。

  2. 同意 RAM 的 CodePipeline 角色的授权。

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

  2. 代码构建配置。

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

    • Repository 中配置的是仓库地址和证书,默认值是CodePipeline公开的Code仓库地址。1
    • Branches to build 中配置的是代码分支,默认值是master分支。2
    • 构建 中配置的是代码构建命令,默认值是mvn package -B -DskipTests3
    • 测试 中配置的是单元测试命令,默认值是mvn test。如果您不需要做单元测试,可以不填写测试命令。4
  3. 选择部署方式,单击 部署到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

      • 选择 认证方式

        CodePipeline目前支持 证书认证,用户名密码认证 和 Token认证 三种认证方式。如果是 阿里云容器服务Kubernetes集群,默认都是 证书认证。1

      • 填写 API服务器地址

        请输入Kubernetes API 服务器地址,您可以在阿里云容器服务控制台查看Kubernetes集群 API Server 公网连接端点,例如,https://1.12.123.134:64432

      • 添加 证书

        根据上文选择的 认证方式,决定添加的证书类型。

        • 证书认证 的认证方式,添加 Docker授权 类型的证书。

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

          10

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

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

        • 用户名密码认证 的认证方式,添加 用户名和密码 类型的证书。

        • Token认证 的认证方式,添加 用户名和密码 类型的证书。

      • 添加 部署配置文件

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

      • 添加 状态检查配置

        支持检验的 Kubernetes Kind: pods,daemonsets,deployments,replicasets,replicationcontrollers,statefulsets。如果检验的不是 default namespace 下的资源,请在首行填写 namespace 名称。请用 “:” 分隔 Kubernetes Kind 和 Kind name, 用 “,” 分隔多个 Kind name。每一行描述一种 Kubernetes Kind。示例配置:

        1. namespace:default
        2. pods:pods1,pods2
        3. deployments:ds1,ds2

        注意:请严格按照说明填写单词,不要删减字母;请勿填写多余的空格或者换行。7

      • 添加 变量申明配置

        支持系统环境变量,可以通过 ${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
  4. 执行构建。

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

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

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