软件开发平台
快速入门
文档版本 01
发布日期 2022-02-17
版权所有 © 华为技术有限公司 2022。 保留一切权利。
非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传 播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或 特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声 明或保证。
由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文 档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
目 录
1 软件开发平台使用流程...1 2 使用软件开发平台快速搭建项目... 6
快速入门 目 录
1
软件开发平台使用流程
软件开发平台是华为云提供的一站式云端DevOps平台，本章节为您介绍软件开发平台 的基本操作流程。
前提条件
1. 拥有已实名认证的华为云帐号。若没有，请先注册帐号并完成实名认证。
快速入门 1 软件开发平台使用流程
配置项目
项目管理服务是使用软件开发平台各服务的基础，首先需要创建项目、添加项目成 员，然后可以根据项目规划添加工作项。
步骤1 创建项目。
1. 登录软件开发平台，单击“新建项目”。
2. 选择项目类型，输入项目名称，单击“确定”。
步骤2 添加项目成员。
1. 进入已创建的项目，单击页面上方导航栏“设置 > 通用设置 > 成员管理”。
2. 在页面右上角选择“添加成员”或者通过链接邀请。
其中，添加成员有从本企业用户、从其他项目导入用户、邀请其他企业用户三种 方式，请根据实际情况选择。
步骤3 创建工作项。
1. 进入已创建的项目，单击页面上方导航栏“工作 > 工作项”。
2. 单击“新建”，选择工作项类型，根据实际情况输入工作项标题、优先级、处理 人等信息。
----结束
项目管理服务更多操作请参见项目管理用户指南。
配置代码仓库
代码仓库用于项目代码的版本管理，与本地的交互基于Git，因此在使用代码仓库之前 需要在本地安装Git客户端。
步骤1 安装并配置Git客户端。
1. 通过Git官网下载安装包，并使用默认配置安装Git客户端到本地电脑。
2. 运行Git Bash，Git Bash中输入以下命令行配置用户名和邮箱。
git config --global user.name "您的名字"
git config --global user.email "您的邮箱"
3. 输入以下命令行，生成一对SSH密钥。生成的密钥通常保存在“~/.ssh/
id_rsa.pub”中。
ssh-keygen -t rsa -C "<您的邮箱>"
4. 输入以下命令可显示密钥内容。
cat ~/.ssh/id_rsa.pub
步骤2 创建代码仓库。
1. 进入已创建的项目，单击页面上方导航“代码 > 代码托管”。
2. 根据需要选择普通新建、按模板新建或导入外部仓库，按照页面提示输入仓库名 称等基本信息，单击“确定”。
快速入门 1 软件开发平台使用流程
3. 代码仓库创建成功后，页面自动跳转到仓库详情页，可查看仓库内的文件。
步骤3 克隆/推送代码。
1. 单击页面右上角用户名，在下拉列表中选择“个人设置”。
2. 单击页面左侧导航“代码托管 > SSH密钥管理”。
3. 单击“添加SSH密钥”，输入标题，并将在安装并配置Git客户端中生成的密钥，
单击“确定”。
4. 返回代码仓库，单击“克隆/下载”，复制仓库地址。
运行Git Bash，输入以下命令行，克隆云端仓库到本地。
git clone <您仓库的SSH下载链接>
5. 在本地完成代码的编辑后，在Git Bash中输入以下命令行，保存代码并推送到代 码仓库。git add .
git commit -m "<您对本次提交备注的信息>"
git push origin master
6. 返回代码仓库，即可查看更新后的文件。
----结束
代码托管服务更多操作请参见代码托管用户指南。
配置流水线
流水线集成代码检查、编译构建、部署等任务，可根据需要灵活配置流水线中的任 务。流水线为非必须操作，根据需要配置即可。
● 代码检查任务可以对代码进行静态检查和安全检查，代码检查任务为非必须操 作，根据需要配置即可。
● 编译构建任务将软件的源代码编译成目标文件，并把配置文件和资源文件等打 包。对于一些项目，例如PHP、Node.js前端代码，不需要进行编译，无需配置编 译构建任务。
● 部署任务用于将软件包或代码部署到虚拟机或者容器。对于一些项目，例如手机 APP开发，无需配置部署任务。
步骤1 创建代码检查任务。
1. 进入已创建的项目，单击页面上方导航栏“代码 > 代码检查”。
2. 单击“新建任务”，在页面中选择需要检查的代码仓库，单击仓库名称后的“创 建”，启动任务的创建。
快速入门 1 软件开发平台使用流程
3. 代码检查任务创建成功后，页面自动跳转至任务详情页，单击“开始检查”启动 任务。任务执行成功后，即可查看代码问题列表。
代码检查服务更多操作请参考代码检查用户指南。
步骤2 创建编译构建任务。
1. 进入已创建的项目，单击页面上方导航栏“构建&发布 > 编译构建”。
2. 单击“新建任务”，根据实际情况配置编译构建任务信息。
步骤 填写/选择建议
选择代码源 – 源码源：DevCloud。
– 源码仓库：选择在配置代码仓库中创建的代码仓库。
– 分支：master。
选择构建模板 服务内置了20余个构建模板，请根据实际情况选择；也可以选 择“不使用模板，直接创建”，自定义构建步骤。
3. 完成配置，单击“确定”，页面自动跳转至构建步骤页面。根据实际情况编辑各 步骤中的配置项，单击“新建”。
4. 编译构建任务创建成功后，页面自动跳转至任务详情页，单击“执行启动”启动 任务。待任务执行成功后，可以在页面中查看构建日志，也可以到发布服务中查 找生成的软件包。
编译构建服务更多操作指导请参考编译构建用户指南。
步骤3 创建部署任务。
1. 准备授信主机：部署任务通常是将软件包部署到服务器中，因此需要准备一台具 有弹性IP的主机，可以使用已有主机，也可以购买华为云弹性云服务器。
2. 添加授信主机：
a. 进入已创建的项目，单击页面上方导航栏“设置 > 通用设置”。
b. 单击页面左侧导航“主机组管理”，创建主机组并添加授信主机。
3. 在页面上方导航栏选择“构建&发布 > 部署”，单击“新建任务”，根据实际情 况配置部署任务信息。
快速入门 1 软件开发平台使用流程
步骤 填写/选择建议
基本信息 根据实际情况输入任务名称。
选择部署模板 服务内置了多个部署模板，请根据实际情况选择；也可以选择
“空白模板”，自定义部署步骤。
4. 完成配置，单击“确定”，页面自动跳转至部署步骤页面。根据实际情况编辑各 步骤中的配置项，单击“保存”。
5. 部署任务创建成功后，页面自动跳转至任务详情页，单击“执行启动”启动任 务。待任务执行成功后，可以在页面中查看部署日志，也可以登录主机查看部署 结果。
部署服务更多操作指导请参考部署用户指南。
步骤4 配置流水线。
1. 进入已创建的项目，单击页面上方导航栏“构建&发布 > 流水线”，进入“流水 线”页面。
2. 单击“新建流水线”，根据实际情况配置流水线信息。
步骤 填写/选择建议
基本信息 根据实际情况输入流水线名称。
选择模板 可选择服务内置的流水线模板，也可以选择“不使用模板，直 接创建”，自定义流水线工作流。
选择代码源 – 第一个选项选择“CodeHub”。
– 仓库：选择在配置代码仓库中创建的代码仓库。
定义工作流 根据需要配置代码检查、编译构建、部署等阶段，添加相应任 务。
3. 流水线创建成功后，页面自动跳转至流水线详情页，单击“全新执行”启动任 务。待任务执行成功后，可单击各任务查看其详情。
流水线服务更多操作指导请参考流水线用户指南 ----结束
快速入门 1 软件开发平台使用流程
2
使用软件开发平台快速搭建项目
本节基于软件开发平台内置代码仓库，介绍如何使用软件开发平台完成项目的开发、
构建与部署，实现持续交付。
准备工作
1. 拥有已实名认证的华为云帐号。若没有，请先注册帐号并完成实名认证。
2. 已购买软件开发平台。
3. 已购买弹性云服务器，购买时的配置可参考下表。完成购买后，参考配置安全组 规则添加端口22及8080的入方向规则。
配置分类 配置项 配置建议
基础配置 计费模式 选择“按需付费”。
区域 选择“华北-北京四”。
CPU架构 选择“x86”。
规格 选择“通用计算型”、2核4G或以上规格。
镜像 选择“公共镜像 > CentOS > CentOS 7.6 64bit(40GB)” 。
网络配置 网络 在列表中任选一个即可。
弹性公网IP 选择“现在购买”。
规格 选择“静态BGP”。
计费方式 选择“按宽带计费”。
高级配置 云服务器 名称
自定义（为避免帐号下购买过多个主机时不易查找的情 况，建议修改系统默认主机名称，使用易于辨认的主机 名）。
登录凭证 选择“密码”。
密码 自定义。
云备份 选择“暂不购买”。
快速入门 2 使用软件开发平台快速搭建项目
新建项目
项目是使用软件开发平台各服务的基础，创建项目后才能完成后续操作。
步骤1 登录软件开发平台，单击“新建项目”。
步骤2 选择“Scrum”，输入项目名称“Demo”，单击“确定”。
----结束
新建代码仓库
代码仓库用于项目代码的版本管理，本节使用软件开发平台内置的模板“Java Web Demo”创建代码仓库。
步骤1 单击页面上方导航栏“代码 > 代码托管”，进入代码托管服务。
步骤2 单击页面右上角“普通新建”旁边的“∨”，选择“按模板新建”。
步骤3 选择模板“Java Web Demo”，单击“下一步”。
快速入门 2 使用软件开发平台快速搭建项目
步骤4 输入代码仓库名称“Web-Demo”，单击“确定”。
----结束
检查代码
通过代码检查任务可以对代码进行静态检查，管控代码质量。
步骤1 单击页面上方导航栏“代码 > 代码检查”，进入代码检查服务。页面中显示自动创建 的代码检查任务“web-demo-codecheck”。
说明
本文使用的是产品为代码仓库模板自动创建的任务。
实际开发项目需要单击“新建任务”，根据业务场景自主创建任务，详细操作请参考新建代码检 查任务。
步骤2 单击“开始检查”启动任务，页面自动跳转至“概览”页。
步骤3 等待1分钟左右，待页面提示检查成功时，即可查看检查结果。
若任务执行失败，则页面右上角将弹出报错提示，请参考代码检查常见问题排查处 理。
快速入门 2 使用软件开发平台快速搭建项目
----结束
构建并归档软件包
通过编译构建任务将软件的源代码编译成目标文件，并把配置文件和资源文件等打包 并归档到软件发布库中。
步骤1 单击页面上方导航栏“构建&发布 > 编译构建”，进入编译构建服务。页面中显示自 动创建的编译构建任务“Web-Demo-cloudbuild”。
说明
本文使用的是产品为代码仓库模板自动创建的任务。
实际开发项目需要单击“新建任务”，根据业务场景自主创建任务，详细操作请参考新建编译构 建任务。
步骤2 单击“开始构建”启动任务，页面自动跳转至任务详情页。
步骤3 等待1分钟左右，当页面中显示 时，表示任务执行成功。请记录页面左上角的数字 串。
若构建失败，请参考编译构建常见问题排查处理。
快速入门 2 使用软件开发平台快速搭建项目
步骤4 单击页面上方导航栏“构建&发布 > 发布”，进入软件发布库。
依次单击与任务构建任务同名的文件夹，与上一步中所记录的数字串同名的文件夹，
能够找到生成的软件包。
----结束
部署构建包
通过部署任务将软件发布库中的软件包部署到虚拟机或者容器，并启动运行。
步骤1 添加授信主机。
1. 单击页面上方导航栏“设置 > 通用设置”，在页面左侧导航中选择“主机组管 理”。
2. 单击“新建主机组”，输入主机组名称“host-group”、选择操作系统
（Linux），单击“保存”。
3. 单击“添加主机”，输入在准备工作中购买的弹性云服务器信息，单击“添 加”。
等待15秒左右，页面显示验证成功。若主机添加失败，请参考部署-常见问题-主 机问题排查。
快速入门 2 使用软件开发平台快速搭建项目
步骤2 配置并执行部署任务。
1. 单击页面上方导航栏“构建&发布 > 部署”，进入部署服务。页面中显示自动创 建的部署任务“web-demo-deploy”。
说明
本文使用的是产品为代码仓库模板自动创建的任务。
实际开发项目需要单击“新建任务”，根据业务场景自主创建任务，详细操作请参考新建 部署任务。
2. 单击 ，编辑部署步骤。
a. 停止SpringBoot服务：首次执行时，由于目标主机上还未有服务，执行该步 骤会失败，因此不勾选“启用”选项。
b. 安装JDK：修改jdk版本为“openjdk-1.8.0”。
快速入门 2 使用软件开发平台快速搭建项目
c. 选择部署来源：参考下表进行配置。
配置项 值
选择源类型 构建任务
请选择构建任务 Web-Demo-cloudbuild 下载到主机的部
署目录
${download_path}
快速入门 2 使用软件开发平台快速搭建项目
3. 选择“参数设置”页签，参考下表配置任务参数。
参数名 参数值
host_group 选择上一步中创建的主机组名称“host-group”。
spring_path /usr/local/demo/demoapp.jar package_url 无需此参数，单击对应行 删除。
service_port 8080
jdk_path 保持默认值。
download_path /usr/local/demo/
快速入门 2 使用软件开发平台快速搭建项目
4. 单击“保存并执行”。
等待1分钟左右，页面提示部署成功。若部署失败，请参照部署常见问题排查。
步骤3 查看部署结果。
打开一个新的浏览器页面，输入访问地址“http://IP:8080/test”，其中“IP”为准备 工作中购买的弹性云服务器的IP。
若出现以下访问结果，表示部署成功。
----结束
配置流水线
通过流水线可以将代码检查、编译构建、部署等任务串联起来，当代码发生改变时，
自动触发流水线执行，实现持续交付。
步骤1 单击页面上方导航栏“构建&发布 > 流水线”，进入流水线服务。页面中显示自动创 建的流水线“Web-Demo-pipeline”。
快速入门 2 使用软件开发平台快速搭建项目
说明
本文使用的是产品为代码仓库模板自动创建的流水线。
实际开发项目需要单击“新建任务”，根据业务场景自主创建流水线，详细操作请参考新建流水 线。
步骤2 单击 ，在下拉列表中选择“编辑”。
步骤3 编辑流水线任务。
1. 本文暂不涉及接口测试，因此需要将接口测试任务从流水线中移除。
单击接口测试任务对应 ，在下拉列表中单击“删除任务”。
2. 单击部署任务，参考部署构建包配置部署参数。
步骤4 选择“执行计划”页签，将“代码提交时触发”对应开关打开。
快速入门 2 使用软件开发平台快速搭建项目
步骤5 单击“保存”，退出编辑。
步骤6 参考部署构建包，在部署步骤“停止SpringBoot服务”中勾选“启用”。
步骤7 进入代码仓库，找到文件“src/main/java/com/huawei/devcloud/controller/
TestController.java”。
单击 ，将“hello world”修改为“hello world change”，单击“确定”。
步骤8 返回流水线页面，可看到流水线正在运行中。
快速入门 2 使用软件开发平台快速搭建项目
等待2分钟左右，当页面显示 时，重新访问页面“http://IP:8080/test”，
访问结果将变为下图显示内容。
若任务执行失败，请于执行失败处检查失败原因，或参照流水线常见问题排查处理。
----结束
释放资源
为了避免不必要的费用产生，完成本示例体验后，可释放以下资源。
须知
资源释放后无法恢复，请谨慎操作。
步骤1 删除项目。
1. 进入项目“设置 > 通用设置 > 基本信息”页面。
2. 单击“删除项目”，在弹框中输入项目名称，单击“删除”。
快速入门 2 使用软件开发平台快速搭建项目
步骤2 删除弹性云服务器。
1. 登录弹性云服务器控制台。在列表中找到待删除的弹性云服务器，单击“更 多”，在下拉列表中选择“删除”。
2. 在弹框中勾选“释放云服务器绑定的弹性公网IP地址”、“删除云服务器挂载的 数据盘”，单击“是”。
----结束
快速入门 2 使用软件开发平台快速搭建项目
