华为云CodeArts Deploy部署服务完全对接指南：从入门到生产级实战
一、CodeArts Deploy概述：什么是部署服务
部署（CodeArts Deploy）是华为云软件开发生产线CodeArts中的核心服务之一，提供可视化、自动化的部署能力。该服务通过丰富的部署步骤帮助用户制定标准的部署流程，有效降低部署成本，显著提升发布效率。CodeArts Deploy支持多种部署形态，包括主机部署（涵盖物理机、虚拟机以及第三方主机）、容器部署（支持CCE集群、自建集群及第三方集群）、微服务应用部署（基于ServiceStage）以及函数部署（FunctionGraph）。
在部署流程上，用户通过手动上传或编译构建任务将制品保存在制品仓库或镜像仓库中，部署服务从仓库中获取目标制品，将其部署到指定的主机或容器环境。CodeArts Deploy预置了Tomcat、SpringBoot、Django等常用技术栈的系统模板，用户可以直接使用这些模板快速创建应用，也可以通过拖拽方式自由编排组装原子步骤。此外，服务还支持保存自定义模板便于团队内批量推广，支持参数化配置实现部署时的动态参数替换，并与流水线服务无缝集成实现持续发布。
需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联
二、使用前的准备工作
2.1 开通CodeArts服务
在使用CodeArts Deploy之前，首先需要开通CodeArts服务。登录华为云控制台后，进入软件开发生产线CodeArts产品页面，根据实际需求选择合适的产品套餐进行开通。CodeArts提供了体验版、基础版等多种套餐选项，新用户可以根据需要选择体验版进行试用。
2.2 创建CodeArts项目
开通服务后，需要创建一个CodeArts项目来承载后续的部署工作。项目是CodeArts中组织和管理软件开发活动的核心单元，所有的代码仓库、构建任务、部署应用等资源都归属于某个具体的项目。创建项目时需指定项目名称和所属区域，建议根据团队的实际业务需求进行命名以便于管理。
2.3 准备部署目标资源
根据部署方式的不同，需要提前准备好相应的目标资源。对于主机部署场景，需要准备一台或多台弹性云服务器（ECS），并确保这些主机能够与CodeArts服务进行网络通信。如果目标主机无法连接到公网，则需要选取一台绑定了弹性公网IP（EIP）的主机作为代理主机，通过代理模式实现CodeArts到目标主机的网络连通。对于容器部署场景，则需要提前创建好CCE集群或准备好自建的Kubernetes集群。
2.4 准备部署制品
部署前需要准备好待部署的软件包或容器镜像。在主机部署场景下，软件包可以是jar包、war包或其他格式的应用程序包。这些制品可以通过编译构建任务自动归档到制品仓库，也可以从本地直接上传。在创建部署应用时，可以选择从制品仓库获取软件包，也可以选择直接引用构建任务的输出。对于容器部署场景，则需要准备好Docker镜像并推送到镜像仓库。
三、主机集群与环境的配置
3.1 创建主机集群
主机集群是CodeArts Deploy中管理多台主机的逻辑单元。通过将多台主机纳入同一个集群，可以统一进行连通性验证、批量导入环境等操作。
创建主机集群的操作步骤如下：
- 进入CodeArts项目，单击菜单"设置 > 通用设置 > 基础资源管理"，默认进入"主机集群"页面
- 单击"新建主机集群"，填写集群名称（仅支持3-128位数字、中文、英文字母或-_.符号）
- 选择操作系统类型（Linux或Windows），根据即将添加的主机系统进行选择
- 选择主机连通方式：直连模式适用于目标主机绑定了EIP的场景；代理模式适用于目标主机无法连接公网，需要通过代理主机进行中转的场景
- 选择执行主机，默认使用官方资源池
- 填写描述信息（可选，长度限制0-500字符）
3.2 添加主机到集群
主机集群创建完成后，需要向集群中添加具体的主机实例：
- 在主机集群详情页中单击"添加或导入主机"
- 选择添加方式，支持"通过IP手动添加"或从已有列表导入
- 填写主机名、IP地址（私有IP或公网IP均可）
- 选择认证方式：密码认证或密钥认证
- 密码认证：输入ECS的用户名和密码
- 密钥认证：输入用户名和密钥（密钥的生成与获取方式请参考华为云官方文档）
- 设置SSH端口，推荐使用22端口，也支持自定义端口
- 单击"确定"完成主机添加
添加完成后，建议立即对主机进行连通性验证。在主机列表中单击对应主机操作列的连通性验证图标，系统将尝试与目标主机建立连接并返回验证结果。只有连通性验证成功的主机才能正常用于后续的部署操作。
3.3 创建与配置环境
环境是由一台或多台相同操作系统的主机组成的一个集合，是部署服务中的核心概念。通过在应用中配置环境，可以实现多台主机的批量部署，无需逐台操作。
创建环境的操作步骤如下：
- 在应用的编辑页面中单击"环境管理"选项卡
- 单击"新建环境"，填写环境名称（仅支持3-128位数字、中文、英文字母或-_.符号）
- 选择资源类型（当前支持"主机"）
- 选择操作系统（Linux或Windows）
- 填写描述信息（可选）
- 单击"保存"完成环境创建
环境创建后，需要将主机导入到环境中：
- 在环境的"资源列表"页签中单击"导入主机"
- 系统会自动筛选符合当前环境操作系统要求的所有主机集群
- 可以选择单独导入某台主机，也可以批量勾选多台主机进行批量导入
- 当选择已绑定代理主机的目标主机进行导入时，该目标主机绑定的代理主机会一同被导入
导入完成后，建议对主机进行连通性验证以确保部署时能够正常通信。环境管理还支持对主机进行权限管控以及实时的连通性验证。
四、创建与配置部署应用
4.1 进入部署服务
进入CodeArts项目后，单击菜单"持续交付 > 部署"即可进入项目下的部署服务界面。在部署服务界面中，可以看到当前项目下所有的部署应用列表。
4.2 新建应用
CodeArts Deploy支持两种方式新建应用：使用系统模板创建和使用空白模板创建。
方式一：使用系统模板创建
部署服务预置了丰富的系统模板，覆盖了常见的部署场景：
- Tomcat应用部署：在主机上部署Tomcat应用
- SpringBoot应用部署：在主机上部署SpringBoot应用
- Docker应用部署-Linux：支持全系Docker命令，实现主机场景下的容器化部署
- Kubernetes Manifest部署-CCE集群：通过manifest文件定义Kubernetes对象，实现对CCE集群的部署
- FunctionGraph函数部署：将软件包部署到FunctionGraph并发布新版本
- Django应用部署、NodeJs应用部署、Go应用部署、Vue应用部署等多种模板
使用系统模板的步骤为：单击"新建应用"进入基本信息页面，修改名称和描述后单击"下一步"，在模板选择页面中根据业务类型选中相应的推荐模板，单击"确定"即可快速生成一个包含预置部署步骤的应用。
方式二：使用空白模板创建
如果系统模板无法满足特定的部署需求，可以选择空白模板从零开始编排部署步骤。选择空白模板后，进入部署步骤编排页面，页面左侧为步骤编排区，右侧为可选步骤列表。
4.3 编排部署步骤
部署步骤是CodeArts Deploy中最小的可执行单元，每个步骤对应一个特定的部署功能。一个应用可以由一个或多个部署步骤组成，用户可以根据实际需求自由组合。
步骤编排的操作方式如下：
- 在右侧步骤列表中单击目标步骤的"添加"，即可将该步骤添加到左侧的编排区
- 单击已添加步骤的上方或下方，可以在当前步骤的前后插入新的步骤
- 编排区内的步骤支持拖拽调整顺序
- 可以随时删除不需要的步骤
部署服务提供了40多种开箱即用的原子步骤，涵盖了文件操作、软件安装、通用部署、容器命令执行等丰富功能。常用的部署步骤包括：
- 选择部署来源：从制品仓库或构建任务中获取待部署的软件包
- 安装JDK：在目标主机上安装指定版本的JDK
- 执行Shell命令：在目标主机上执行自定义的Shell脚本或命令
- 文件操作：支持文件的拷贝、删除等操作
- Docker命令：支持镜像构建、上传、拉取、运行等全系Docker操作
每个部署步骤都支持独立配置，步骤执行过程中会输出独立的部署日志，部署失败时能够快速定位原因。
4.4 配置部署步骤参数
添加部署步骤后，需要为每个步骤配置具体的执行参数。以"安装JDK"步骤为例：
- 步骤显示名称：该步骤在部署流程中显示的名称
- 环境：选择该步骤要部署的目标环境
- JDK版本：选择需要安装的JDK版本号
- JDK安装路径：指定JDK在目标主机上的安装目录
- 控制选项：配置是否启用该步骤、失败后是否继续后续步骤、是否使用sudo权限执行等
4.5 保存为自定义模板
当一个应用的部署步骤编排完成后，可以将其保存为自定义模板。自定义模板会显示在模板管理页面的"自定义模板"分类中，团队成员可以在新建应用时直接使用该模板一键创建应用，实现部署流程的标准化和快速推广。
五、参数化配置与动态部署
5.1 参数类型
CodeArts Deploy支持参数化配置，提供字符串、环境、枚举三种类型的参数。参数化配置的核心价值在于实现部署应用时应用配置的动态替换，同一套部署流程可以应用于不同的环境而无需修改应用本身。
5.2 创建与管理参数
在应用的编辑页面中，切换到"参数设置"页签即可进行参数的创建与管理：
- 字符串类型：适用于普通的文本参数，如应用版本号、配置文件路径等
- 环境类型：用于引用已创建的环境资源，实现环境维度的参数隔离
- 枚举类型：适用于有固定取值范围的参数，如部署模式（灰度/全量）、日志级别等
创建参数时，可以开启"运行时设置"选项。开启后，在每次部署应用时系统会弹出参数设置框，要求用户填入具体的参数值。这种设计使得同一个应用可以在不同的部署场景下使用不同的参数值，极大地增强了应用的重用性和灵活性。
5.3 在部署步骤中引用参数
参数创建完成后，可以在部署步骤的配置中通过特定的语法引用这些参数。部署执行时，系统会自动将参数引用替换为实际的参数值，实现配置的动态生效。这种机制对于需要在不同环境（如开发环境、测试环境、生产环境）中使用不同配置的应用尤为实用。
六、执行部署与查看结果
6.1 执行部署
应用配置完成后，可以通过以下方式触发部署：
- 在应用列表中找到目标应用
- 单击应用名称进入应用详情页
- 单击"部署"按钮启动部署流程
- 如果应用配置了运行时参数，会弹出参数设置框，填入参数值后单击"确定"继续
- 系统开始执行部署，页面会实时显示部署进度
6.2 查看部署详情与日志
部署执行过程中和完成后，可以查看详细的部署信息：
- 部署动态：展示部署的状态变化，包括部署成功、部署失败等消息
- 部署详情：可视化显示部署进程和当前部署的应用信息
- 部署日志：每个原子步骤独立输出日志，多主机并行部署时支持分主机查看日志
原子步骤独立输出部署日志并支持关键字匹配FAQ，部署失败时能够快速定位原因。这种设计极大地简化了部署问题的排查过程。
七、与流水线服务无缝集成
CodeArts Deploy与流水线服务（CodeArts Pipeline）无缝集成，是实现持续交付的关键能力。通过将部署应用添加到流水线中，可以实现代码提交、代码检查、编译构建、应用部署的全流程自动化。
在流水线中编排时，可以添加部署任务作为流水线的一个阶段。部署任务支持配置为串行或并行执行，可以根据业务需求灵活编排。流水线还支持参数传递，构建任务产出的软件包可以自动传递给部署任务使用。
CodeArts提供了多种端到端的实践示例：
- 基于ECS部署的代码开发流水线：适用于传统软件包部署场景，从代码提交到部署到ECS全流程自动化
- 基于CCE部署的代码开发流水线：适用于容器化部署场景，从代码提交到部署到CCE集群全流程自动化
这种无缝集成能力使得开发团队可以建立标准化的交付流程，实现部署环境标准化和部署过程自动化。
八、安全最佳实践
8.1 权限管理
CodeArts Deploy的权限管理分为四个层级：项目级、应用级、主机集群级和环境级。
项目级权限：通过项目设置中的权限管理页面，可以为不同角色配置部署服务的访问权限。新增的成员需要被赋予指定的角色才能正常使用部署服务。
应用级权限：在应用的编辑页面中切换到"权限管理"页签，可以为不同角色配置该应用的创建、编辑、部署、删除等操作权限。
主机集群权限：在主机集群的管理页面中，可以控制不同角色对主机集群的访问和操作权限。
环境权限：在环境管理页面中，可以为各角色配置环境级别的操作权限。
通过这种多层次的权限管理体系，企业可以实现精细化的访问控制，确保只有授权用户才能执行敏感的部署操作。结合IAM（统一身份认证服务）进行用户身份认证和权限隔离，可以进一步提升安全性。
8.2 安全部署实践
CodeArts Deploy提供了安全最佳实践指导文档，涵盖数据传输加密、权限最小化原则、制品来源可信验证等多个方面。建议在实际使用中遵循以下原则：
- 使用密钥认证方式代替密码认证，提高主机访问的安全性
- 定期轮换认证密钥和密码
- 使用私有网络和代理主机模式部署内网主机，避免暴露公网
- 对制品仓库中的软件包进行签名验证，确保制品来源可信
九、常见问题与解决方案
9.1 连通性验证失败
问题现象：运行部署应用时失败，提示"没有连通性验证成功的主机和环境"。
原因分析：该应用所配置的主机已经从主机列表中被删除，或者连通性验证失败。
处理方法：
- 进入部署服务，单击目标应用名称，切换到"环境管理"页面
- 单击对应环境名称，在弹窗中切换到"资源列表"页面
- 搜索该主机是否存在，并查看主机连通性验证状态
- 如果主机存在但连通性验证失败，进入"设置 > 通用设置 > 基础资源管理"，找到目标主机集群
- 单击主机所在行的编辑按钮，修改主机信息后重新进行连通性验证
- 如果主机不存在，需要重新添加主机并确保连通性验证成功
9.2 应用部署超时
问题现象：部署应用一直在部署中，最终超时失败。
原因分析：
- 应用中的命令本身执行效率较低，部署耗时较长
- 脚本中包含了交互式的命令（如read、sudo、su、yum等），部署过程中需要前台输入信息
处理方法：
- 在目标主机上手工执行对应的命令，评估实际执行时长是否超过部署超时时间（默认为30分钟）
- 检查命令中是否包含交互式命令，如有则修改脚本去除交互或使用非交互模式
- 如果由于部署步骤过多导致超时，建议将应用拆分为多个应用依次部署
- 对于"执行shell命令"步骤的同步等待导致的超时，可通过命令将执行方式改为异步执行
9.3 服务启动后异常退出
问题现象：部署了启动服务的命令后服务正常启动，但部署完成后服务又异常退出。
原因分析：未使用异步方式启动服务。部署应用完成后，启动服务的会话链接断开，父进程结束导致子进程也同步结束。
处理方法：使用异步方式启动服务，参考命令格式：
nohup ${command} > ${log_file} 2>&1 &其中，${command}代表服务启动命令，${log_file}代表服务启动日志的输出文件。如果不希望输出日志文件，可以使用/dev/null代替。
9.4 服务停止失败
问题现象：部署停止服务的命令后系统提示部署已完成，但服务实际上并未停止。
原因分析：使用了异步方式停止服务，停止命令可能报错或未完成部署。
处理方法：结束服务时应使用同步方式部署停止命令，而不是异步方式。同步方式部署过程中如果命令报错，应用会明确提示错误信息，便于定位问题。
9.5 命令不存在
问题现象：目标主机上明明存在某个命令，但部署应用时提示命令不存在。
原因分析：该命令对应的安装目录未添加到/etc/profile环境变量文件中。
处理方法：
- 登录目标主机，执行
type ${command}查看命令的安装目录 - 修改应用中的命令调用方式，使用绝对路径调用对应命令
- 或者将命令安装目录添加到目标主机的
/etc/profile环境变量中
9.6 Shell脚本执行未达预期
问题现象：部署应用中的Shell脚本执行完成了，但并未达到脚本预期的效果。
原因分析：应用部署成功，但脚本中的某些命令执行失败但被忽略了。
处理方法：在Shell脚本中使用以下选项帮助定位问题：
set -e：脚本执行过程中遇到第一个报错命令即退出整个脚本，返回错误信息set -x：脚本执行过程中输出debug信息，显示每一条命令执行的详细信息
建议在脚本开头添加 set -e 确保任何命令失败时脚本都能及时停止并报告错误，避免"静默失败"的情况。
十、总结
华为云CodeArts Deploy作为一款企业级的自动化部署服务，通过可视化的部署编排、丰富的系统模板、灵活的参数化配置以及与流水线的无缝集成，为开发团队提供了从开发到交付的全链路自动化能力。无论是传统的主机部署场景，还是云原生的容器部署场景，CodeArts Deploy都能提供标准化的部署流程支持。
在实际使用中，建议开发者遵循以下最佳实践路径：
- 合理规划主机集群和环境的组织方式，建立清晰的基础资源管理体系
- 充分利用系统模板快速启动，再根据实际需求进行定制化编排
- 善用参数化配置实现不同环境的配置隔离，避免为每个环境单独维护部署应用
- 将部署应用与流水线集成，建立从代码提交到生产部署的自动化交付流水线
- 遵循权限最小化原则，通过多层次的权限管理体系保障部署安全
- 遇到部署问题时，充分利用独立步骤日志和关键字匹配功能快速定位根因
通过系统性地掌握CodeArts Deploy的各项能力，开发团队可以显著提升部署效率、降低人为错误、加速软件交付周期，真正实现DevOps理念中的持续交付与持续部署。
常见问题问答
问1：CodeArts Deploy支持哪些部署方式？
答：CodeArts Deploy支持主机部署（物理机、虚拟机及第三方主机）、容器部署（CCE集群、自建集群及第三方集群）、微服务应用部署（基于ServiceStage）和函数部署（FunctionGraph）四种主要部署方式。
问2：目标主机无法连接公网时如何部署？
答：当目标主机无法连接到公网时，需要选取一台绑定了弹性公网IP的主机作为代理主机，在创建主机集群时选择"代理模式"，通过代理主机实现CodeArts Deploy到目标主机的网络连通。
问3：如何实现一套部署流程在不同环境中使用不同的配置？
答：可以使用CodeArts Deploy的参数化配置功能。在应用的"参数设置"中创建字符串、环境或枚举类型的参数，并在部署步骤中引用这些参数。部署时开启"运行时设置"，每次部署时输入不同的参数值即可实现同一套流程在不同环境中的差异化部署。
问4：部署应用时提示"没有连通性验证成功的主机和环境"怎么办？
答：首先进入"环境管理"页面检查主机是否存在以及连通性验证状态。如果主机存在但验证失败，进入"基础资源管理"中的主机集群，修改主机信息后重新进行连通性验证。如果主机已被删除，则需要重新添加主机并确保连通性验证成功。
问5：部署应用后服务启动成功但部署完成后又退出了，是什么原因？
答：这通常是因为未使用异步方式启动服务。部署完成后启动服务的会话链接断开，父进程结束导致子进程同步结束。解决方法是使用 nohup ${command} > ${log_file} 2>&1 & 的异步方式启动服务。
问6：CodeArts Deploy如何与流水线集成？
答：CodeArts Deploy与流水线服务无缝集成，在编排流水线时可以直接添加部署任务作为流水线的一个阶段。部署任务支持串行或并行配置，可以与其他任务（如代码检查、编译构建）组合成完整的CI/CD流水线，实现从代码提交到自动部署的全流程自动化。
