文档首页/ 软件开发生产线 CodeArts/ 快速入门/ 使用CodeArts快速搭建基于ECS部署的代码开发流水线
更新时间:2024-08-28 GMT+08:00
分享

使用CodeArts快速搭建基于ECS部署的代码开发流水线

本文基于CodeArts内置代码仓库,介绍如何使用CodeArts完成项目的开发、构建与部署,实现持续交付。

本文采用的部署方式为ECS部署,适用于传统软件包部署场景。

如果您希望使用容器化部署方法,请参考使用CodeArts快速搭建基于CCE部署的代码开发流水线

准备工作

  1. 已注册华为云并实名认证。如果您还没有华为账号,请参考以下步骤创建。
    1. 注册华为账号并开通华为云
    2. 完成实名认证
  2. 购买弹性云服务器,购买时的必要配置可参考下表,表中未列出的配置可根据实际情况选择。完成购买后,参考配置安全组规则添加端口22及8080的入方向规则。
    表1 弹性云服务器配置

    配置分类

    配置项

    配置建议

    基础配置

    计费模式

    选择“按需计费”。

    CPU架构

    选择“x86计算”。

    规格

    选择2vCPUs 4GiB或以上规格。

    镜像

    选择“公共镜像 > CentOS > CentOS 7.6 64bit(10GiB)”。

    网络配置

    弹性公网IP

    选择“现在购买”。

    公网带宽

    选择“按宽带计费”。

    高级配置

    登录凭证

    选择“密码”。

    密码

    输入自定义密码。

开通CodeArts体验版

  1. 进入购买CodeArts套餐页面
  2. 选择“体验版”,勾选同意声明,单击“立即开通”。
  3. 开通成功,返回“软件开发生产线”页面,列表中显示已开通套餐记录。

新建项目

项目是使用CodeArts各服务的基础,创建项目后才能完成后续操作。

  1. 在CodeArts控制台单击“立即使用”。
  2. 单击“新建项目”,选择“Scrum”,输入项目名称“Demo”,单击“确定”。

新建代码仓库

代码仓库用于项目代码的版本管理,本文使用服务内置的模板“Java Web Demo”创建代码仓库。

  1. 单击导航栏“代码 > 代码托管”,进入代码托管服务。
  2. 单击“新建仓库”,选择“模板仓库”,单击“下一步”。
  3. 选择模板“Java Web Demo”,单击“下一步”。
  4. 输入代码仓库名称“Web-Demo”,单击“确定”。

检查代码

通过代码检查服务,可以对代码进行静态检查,管控代码质量。

  1. 单击导航栏“代码 > 代码检查”,进入代码检查服务。页面中显示自动创建的任务“Web-Demo-check”。
  2. 单击任务所在行的启动任务。
  3. 当页面中显示时,表示任务执行成功。单击任务名称,进入任务的“概览”页面查看检查结果。

    如果任务执行失败,请根据页面弹出报错提示排查修改。

构建并归档软件包

通过编译构建服务,可将软件的源代码编译成目标文件,并把配置文件和资源文件等打包并归档到软件发布库中。

  1. 单击导航栏“持续交付 > 编译构建”,进入编译构建服务。页面中显示自动创建的任务“Web-Demo-build”。
  2. 单击任务所在行的启动任务。如果出现弹窗,请确认参数设置准确后,单击“确定”。
  3. 当页面中显示时,表示任务执行成功。单击任务名称,进入构建历史页面,在列表中找到最新一次构建的构建编号,记录该编号。

    如果构建失败,请根据失败步骤信息与日志中的报错信息排查。

    图1 构建编号

  4. 单击导航栏“制品仓库 > 软件发布库”,进入软件发布库。

    在与项目名称同名的仓库中,依次进入与构建任务同名的文件夹、与构建编号同名的文件夹,即可找到生成的软件包“demoapp.jar”。

    图2 查看软件包

部署构建包

通过部署服务,可将软件发布库中的软件包部署到虚拟机,并启动运行。

  1. 配置目标主机。

    1. 单击导航栏“设置 > 通用设置 > 基础资源管理”。
    2. 单击“新建主机集群”,配置以下信息,单击“保存”。
      表2 新建主机集群

      配置项

      配置建议

      集群名称

      输入“host-group”。

      操作系统

      选择“Linux”。

      主机联通方式

      选择“直连模式”。

      执行主机

      选择“官方资源池”。

    3. 单击“添加或导入主机”,配置以下信息,单击“确定”。
      表3 添加主机

      配置项

      配置建议

      选择添加方式

      选择“通过IP手动添加”。

      主机名

      建议与在准备工作中购买的ECS的名称保持一致。

      IP

      输入在准备工作中购买的ECS的弹性公网IP。

      认证方式

      选择“密码”。

      用户名

      输入“root”。

      密码

      输入在准备工作中购买ECS时设置的密码。

      ssh端口

      输入“22”。

    4. 页面显示一条主机记录,当“连通性验证”列的值显示为“成功”,表示主机添加完成。

      如果主机添加失败,请根据失败详情排查主机配置。

  2. 单击导航栏“持续交付 > 部署”,进入部署服务。页面中显示自动创建的应用“Web-Demo-deploy”。
  3. 单击,选择“编辑”,进入编辑页面。
  4. 选择“环境管理”页签,配置主机环境。

    1. 单击“新建环境”,配置以下信息,单击“保存”。
      表4 新建环境

      配置项

      配置建议

      环境名称

      输入“demo-env”。

      资源类型

      选择“主机”。

      操作系统

      选择“Linux”。

    2. 单击“导入主机”,在弹框中选择1中配置的主机集群和主机,单击“导入”。
    3. 页面提示导入成功,关闭此窗口。

  5. 选择“部署步骤”页签,配置部署步骤。

    • 安装JDK:确认jdk版本为“openjdk-1.8.0”。
    • 选择部署来源:参考下表进行配置。
      表5 部署来源配置

      配置项

      选择源类型

      选择“构建任务”。

      请选择构建任务

      选择“Web-Demo-build”。

      下载到主机的部署目录

      输入“/usr/local/${package_name}/”。

    • 停止SpringBoot服务:首次执行时,由于目标主机上还未有服务,执行该步骤会失败,因此建议禁用此步骤,单击步骤卡片上的,选择“禁用”。
      图3 禁用“停止SpringBoot服务”
    • URL健康测试:此步骤为可选步骤,本文中选择禁用此步骤。

  6. 选择“参数设置”页签,参考下表配置参数。

    参数名

    参数值

    host_group

    选择4中添加的环境名称“demo-env”。

    package_url

    无需此参数,单击对应行删除。

    service_port

    输入“8080”。

    package_name

    输入“demoapp”。

  7. 单击“保存并部署”。如果出现弹窗,请确认参数设置准确后,单击“确定”。

    待页面显示。如果部署失败,请根据失败步骤信息与日志中的报错信息排查。

  8. 查看部署结果。

    打开一个新的浏览器页面,输入访问地址“http://IP:8080/test”,其中“IP”为准备工作中购买的ECS的弹性公网IP。

    如果出现以下访问结果,表示部署成功。

    图4 部署结果

配置流水线

通过流水线可以将代码检查、编译构建、部署等任务串联起来,当代码发生改变时,自动触发流水线执行,实现持续交付。

  1. 单击导航栏“持续交付 > 流水线”,进入流水线服务。在“流水线”页签中显示自动创建的流水线“Web-Demo-pipeline”。
  2. 单击,选择“编辑”。
  3. 选择“任务编排”页签,配置流水线。

    1. 本文暂不涉及接口测试,因此需要将接口测试任务从流水线中移除。

      单击任务“测试”对应,在弹框中单击“确定”。

      图5 删除任务
    2. 单击任务“部署”,关联构建任务选择“构建”,其它配置项的值与部署构建包中的参数设置保持一致。

  4. 选择“执行计划”页签,勾选“代码提交时触发”,在分支过滤下拉列表中勾选分支“master”。

    图6 配置执行计划

  5. 单击“保存”,退出编辑。
  6. 进入部署服务,编辑部署步骤,启用步骤“停止SpringBoot服务”。
  7. 进入代码仓库,搜索并打开文件“TestController.java”。

    单击,将“hello world”修改为“hello world again”,输入提交信息后单击“确定”。

    图7 修改代码

  8. 返回流水线页面,可看到流水线正在运行中。

    当页面显示时,重新访问页面“http://IP:8080/test”,访问结果将变为下图显示内容。

    如果任务执行失败,请于执行失败处检查失败原因,可打开步骤详情查看任务日志,根据日志进行排查。

    图8 流水线执行结果

后续操作

为了避免不必要的费用产生,完成本示例体验后,可以释放部分不再使用的资源。可以释放的资源如下。

表6 释放资源

资源名称

操作步骤

CodeArts项目

进入项目的“设置 > 通用设置 > 基本信息”页面,单击“删除项目”,根据页面提示完成删除操作。

ECS

登录ECS控制台,在列表中找到待删除的ECS,单击“更多 > 删除”,根据页面提示完成删除操作。

资源释放后无法恢复,请谨慎操作。

相关信息

本文采用的代码检查、构建、部署、流水线等任务均为代码仓库模板关联的内置任务。

在实际开发项目时可参考以下指导自主创建任务。

表7 创建任务参考

服务

操作方法

代码检查

参考新建代码检查任务

编译构建

参考新建构建任务

部署

参考新建应用

流水线

参考新建流水线

相关文档