华为云用户手册

主机连通方式概述 在主机部署场景中，部署服务下的执行主机通过SSH/WSMan协议与目标主机进行通信以实现应用的部署。执行主机又称资源池，是表示部署步骤最终执行的物理环境，部署服务在提供官方资源池的同时，也支持您将自己的主机实例接入部署服务并成为自托管资源池，支持通过主机直连方式与代理机方式，实现资源池和目标主机的连接。因此在部署应用之前，要确保执行主机与部署的目标主机可以进行正常通信，这一过程即为主机连通性验证。 主机直连方式 在弹性公网IP（EIP）资源充足，或者在进行工程Demo验证仅需少量EIP的场景下，建议选择主机直连方式。 为确保主机连通性验证通过，您需要对目标主机进行配置并开放相应端口。 该方案通过在服务器中绑定EIP的方式，实现官方资源池与目标主机之间的连通，具体方案如下图所示。 代理机方式 在用户有少量弹性公网IP（EIP）资源时，需要在其他无EIP的云服务器进行部署的场景下，建议选择代理机方式。 为确保主机连通性验证通过，您需要对目标主机、代理主机分别进行配置并开放相应端口。 Linux代理机方式 用一台绑有EIP的E CS 作为代理主机。在部署过程中，部署服务将执行的命令下发到该代理主机，利用SSH协议转发到各目标主机中，实现主机的批量部署。 在部署应用中，当目标主机需要从软件发布库中下载软件包时，目标主机通过该NAT网关访问软件发布库，实现软件包的拉取，具体方案如下图所示。 红色标记为部署命令下发场景。 绿色标记为目标主机下载软件包场景。 Windows代理机方式 用一台绑有EIP的ECS作为代理主机。在部署过程中，部署服务将执行的命令下发到该代理主机，利用端口转发到各目标主机中，实现主机的批量部署。

步骤详解 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 部署租户 当前租户：表示将软件包部署到当前租户的CCE集群中发布。 选择“当前租户”，当前租户需要有CCE集群操作权限，如果当前没有CCE集群操作权限，可以通过下方的 IAM 授权选择已有权限的授权用户进行部署。 其他租户：表示通过IAM授权方式将软件包部署到其他租户的CCE集群中发布。 选择“其他租户”，则必须选择授权租户进行CCE集群部署。 说明： 推荐配置拥有CCE集群操作权限的子账号的AK/SK，不推荐配置租户账号的AK/SK。 IAM授权 如果当前用户无操作权限执行接口时，可通过IAM提权获取到其他用户的临时AK/SK去执行CCE接口。 区域 选择要部署的区域。 集群名称 选择CCE云容器引擎中申请的K8S集群。 命名空间名称 选择CCE云容器引擎中K8S集群的命名空间。 工作负载名称 选择需要部署的无状态工作负载。 访问方式名称 选择与目标工作负载所绑定的service服务名称。 路由名称 选择与目标service服务所绑定的路由名称。 容器名称 选择需要部署的容器实例名。 镜像名称 选择需要部署的镜像。 镜像版本 选择需要部署的镜像版本。 开启灰度配置 灰度策略： Header Header-Key：支持输入自定义Header的键。 Header-Value：支持输入自定义Header的值，支持字符串及正则表达式，正则表达式格式为：^....$。 灰度流量权重（%）：支持流量自定义配置。 Cookie Cookie：支持输入自定义Cookie内容。 灰度流量权重（%）：支持流量自定义配置。 说明： Header与Cookie所输入的字符串长度最大为500。

ServiceStage组件部署 应用管理与运维平台（ServiceStage）是一个应用托管和微服务管理平台，将应用部署到ServiceStage上，可以帮助企业简化部署、监控、运维和治理等应用生命周期管理工作。为适配ServiceStge新特性，推出ServiceStage组件部署2.0插件，对于新应用，推荐使用ServiceStage组件部署2.0插件，ServiceStage组件部署插件仅存量应用使用，不再更新。 表1 部署系统为容器部署的参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 组件名称 部署的实例，将以servicestage组件的形式，部署在servicestage的default应用和default环境下。 组件版本 组件的版本号。 选择组件类型 目前支持：Web应用和ServiceComb应用。 运行环境 设置应用的运行环境。 部署系统 目前支持：虚机部署、容器部署。 集群选择 选择上述环境中需要部署的CCE集群。 命名空间选择 选择组件要部署到CCE集群中的命名空间。 实例数量 应用可以有一个或多个实例，您可以设置具体实例个数。 设置多个实例主要用于实现高可靠性，当某个实例故障时，应用还能正常运行。 资源配置 可选择容器的配置。 选择软件包 可以选择制品仓库已有软件包，也可以选择本地上传的软件包/文件。 说明：本地上传的软件包/文件会上传到制品仓库，可以重复使用。 负载均衡 选择已经创建的负载均衡，若不存在，请创建新的负载均衡，详细步骤参考创建增强型负载均衡器。 Java 探针 勾选探针会启用 应用性能管理 服务并在节点上安装探针，产生少量资源消耗。当勾选时，需要填写监控组。 控制项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 表2 部署系统为虚机部署的参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 组件名称 部署的实例，将以servicestage组件的形式，部署在servicestage的default应用和default环境下。 组件版本 组件的版本号。 选择组件类型 目前支持：Web应用和ServiceComb应用。 运行环境 设置应用的运行环境。 部署系统 目前支持：虚机部署、容器部署。 弹性伸缩组 新建应用所在的弹性伸缩组及伸缩实例，新建弹性伸缩组请参考创建弹性伸缩组。 实例数量 应用可以有一个或多个实例，您可以设置具体实例个数。 设置多个实例主要用于实现高可靠性，当某个实例故障时，应用还能正常运行。 选择软件包 可以选择制品仓库已有软件包，也可以选择本地上传的软件包/文件。 说明： 本地上传的软件包/文件会上传到制品仓库，可以重复使用。 负载均衡 选择已经创建的负载均衡，若不存在，请创建新的负载均衡，详细步骤参考创建增强型负载均衡器。 控制项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的容器类部署步骤

步骤详情 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 部署租户 当前租户：表示将软件包部署到当前租户的CCE集群中发布。 选择“当前租户”，当前租户需要有CCE集群操作权限，如果当前没有CCE集群操作权限，可以通过下方的IAM授权选择已有权限的授权用户进行部署。 其他租户：表示通过IAM授权方式将软件包部署到其他租户的CCE集群中发布。 选择“其他租户”，则必须选择授权租户进行CCE集群部署。 说明： IAM授权 如果当前用户无操作权限执行接口时，可通过IAM提权获取到其他用户的临时AK/SK去执行CCE接口。 区域 选择要部署的区域。 集群名称 选择CCE云容器引擎中申请的K8S集群。 命名空间名称 选择CCE云容器引擎中K8S集群的命名空间。 工作负载名称 选择需要部署的工作负载。 实例数量 填写需要部署的实例数量。 说明： 若实例数量输入为空，则自动适配CCE集群实时实例数量。 容器名称 选择需要部署的容器实例名。 镜像名称 选择需要部署的镜像。 镜像版本 选择需要部署的镜像版本。 容器规格 可配置目标工作负载中的目标容器的容器规格。 CPU配额 配额申请：容器使用的最小CPU需求，作为容器调度时资源分配的判断依赖。只有当节点上可分配CPU总量 ≥ 容器CPU申请数时，才允许将容器调度到该节点。 配额限制：容器能使用的CPU最大值，如果CPU使用值大于限制值，则容器使用CPU资源可能会被限流。 内存配额 配额申请：容器使用的最小内存需求，作为容器调度时资源分配的判断依赖。只有当节点上可分配内存总量 ≥ 容器内存申请数时，才允许将容器调度到该节点。 配额限制：容器能使用的内存最大值。当内存使用率超出设置的内存限制值时，该实例可能会被重启进而影响工作负载的正常使用。 环境变量 支持配置目标工作负载中的目标容器的环境变量 支持获取容器实时环境变量并同步到当前页面，同步后将覆盖本页面原有环境变量。 JAVA探针 可协助您快速进行工作负载的问题定位与性能瓶颈分析，详情可参考性能管理配置（性能瓶颈分析） 。 探针类型： APM 2.0探针：JAVA探针将分配 0.25 Core CPU 和 250 MiB 内存供初始化容器使用； 不启用：不启用探针问题定位； 当探针类型选择“APM2.0探针”时，需要填选以下信息。 探针版本：选择探针的版本； 探针升级策略：选择“重启自动升级”或“重启手动升级”； 重启自动升级：每次都尝试重新下载镜像。 重启手动升级：如果本地有该镜像，则使用本地镜像，本地不存在时下载镜像。 APM环境：填写APM环境信息（选填）； APM业务：选择已有的APM业务； 子业务：填写子业务（选填）； 接入密钥AK：将会自动获取APM服务的密钥信息，可前往APM控制台查看密钥详情。 关于APM2.0参数概念的详细说明，请参见APM参数说明。 控制选项 当前步骤部署失败后，应用是否继续部署后续的步骤。 超时时间 指定该步骤最大执行时间，时间单位为分钟。在手动停止应用之前，执行时长大于超时时长，系统将该步骤设置为执行超时状态。取值范围：1-30 。

停止服务 该步骤通过指定端口停止目标主机中对应的应用，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 服务的端口号 需要被停止的服务的端口号。 控制选项 配置是否启用该操作。 当前步骤执行失败后，应用是否继续执行后续的步骤。 配置是否使用sudo权限执行该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用关于服务启动停止相关的部署步骤

安装GO语言 添加该应用步骤可以在主机上安装GO语言，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 GO版本 GO的版本。 Go安装路径 Go的安装路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

安装IIS服务 该步骤可对指定环境下目标主机进行安装IIS服务，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 安装IIS服务部署步骤不支持win7和win10。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

操作步骤 选择目标应用，单击图标，单击“编辑”，进入“部署步骤”页面。 单击“通知订阅”，即可切换到“通知订阅”页面。 设置应用相关事件的通知，请根据实际情况单击（表示开启）/（表示关闭）进行设置。 站内 消息通知 ：提供应用站内消息通知推送能力。 邮件通知：提供应用动态邮件推送能力，以发送邮件的形式，向应用创建者、执行者和已收藏该应用的成员发送应用动态。 钉钉：提供应用动态钉钉推送能力，填写URL地址，根据需要填写其他信息，并配置通知内容即可。 企业微信：提供应用动态企业微信推送能力，填写URL地址，根据需要填写其他信息，并配置通知内容即可。 飞书：提供应用动态飞书推送能力，填写URL地址，根据需要填写其他信息，并配置通知内容即可。 加签密钥：若钉钉机器人或飞书机器人，安全设置开启加签，请填写加签密钥。若未使用加签，无需填写加签密钥。 修改完所有信息，单击“保存”，保存该应用。

启动/停止SpringBoot服务 该步骤可通过指定环境下目标主机中SpringBoot应用的路径，用于启动或者停止SpringBoot服务，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 服务操作类型 配置启动服务或者停止服务。 服务对应的绝对路径 SpringBoot服务的绝对路径。 系统变量 选填。 Java运行参数，使用JVM变量，常用的是 -D 参数。 -XX 和-X 参数是用来设定内存和GC参数, 不同JVM的参数设置可能不同。 -D 和 -X 参数紧跟在 java 后面，当选择启动服务时，可设置服务运行所需内存大小等。 说明： 常见填入参数形式为 ：-Dfile.encoding=UTF-8 -Xms256m -Xmx512m 命令行参数 选填。 SpringBoot运行参数，即应用程序自己的参数。 当选择启动服务时，可以通过--参数方法, 设定SpringBoot服务监听端口等。 说明： 常见填入参数形式为 ：--server.port=9000 --spring.profiles.active=prod 等待时间 等待服务启动的时间。当选择启动服务时，启动过程中会通过检测进程方式检测服务是否成功启动。可根据服务启动实际所需时间进行调整，如时间设置不合理，会导致检测结果无效。 组件监控 配置是否启用应用运维服务（ AOM ），该服务提供指标监控、日志查询、告警功能（勾选后自动安装数据采集器 ICAgent，仅支持华为云linux主机，且与此应用在同一region下），详细请参见配置组件监控。 控制选项 配置是否启用该操作。 当前步骤执行失败后，应用是否继续执行后续的步骤。 配置是否使用sudo权限执行该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用关于服务启动停止相关的部署步骤

URL健康测试 该步骤通过访问目标主机部署应用的健康检查URL，用于检测服务是否正常启动，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 重试次数 失败后重试次数，超过预设的重试次数，服务未启动会导致URL检测失败。 间隔时间 每次重试测试的间隔时间。 测试路径 健康测试URL，支持添加多个。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用其他的部署步骤

安装Nginx 添加该应用步骤可以在主机上安装Nginx，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 nginx版本 nginx的版本。 nginx安装路径 nginx的安装路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

安装JDK 添加该应用步骤可以在主机上安装JDK，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 请选择jdk版本 jdk的版本。 jdk安装路径 jdk的安装路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 在购买华为云弹性云主机时，因Arm架构的Euler系统无openjdk-11的yum源，建议选择Arm架构的CentOS 、Ubuntu 、Huawei Cloud EulerOS等。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

安装Node.js 添加该应用步骤可以在主机上安装Node.js，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 node.js版本 node.js的版本。 安装路径 node.js的安装路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

创建委托 登录华为云控制台。 鼠标悬停于右上角的用户名称，如下图所示，选择并单击” 统一身份认证 ”。 单击左侧目录树的“委托”，进入委托页面。 单击右上角“创建委托”，进入创建委托页面。 参考表1设置创建委托的参数。 表1 创建委托的参数说明 名称 说明 样例 委托名称 该参数项为必填，表示该委托代理的名称。 aom_ecm_trust 委托类型 选择“云服务”。 - 云服务 选择”弹性 云服务器ECS 裸金属服务器BMS”。 - 持续时间 选择“永久”。 - 描述 该参数项为非必填。用于补充说明该委托代理的详细信息。 - 单击“完成”，进入授权页面。 在右上角搜索框中输入“APM”，在查找结果中勾选“APM Administrator”。 单击页面下方的“确定”，委托关系创建成功。

拷贝文件 该步骤支持环境下主机内目录间的文件拷贝和跨主机间的文件拷贝，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 拷贝方式 主机内拷贝：用于一台主机内不同目录间的文件拷贝。 主机间拷贝：用于在不同主机之间进行文件拷贝。 环境 进行拷贝应用的主机所在环境。 目标环境 拷贝方式为“主机间拷贝”时，表示拷贝的目标环境。 注意： 当环境下有多个主机时，对目标环境下的所有主机执行拷贝操作。 拷贝文件 指定待拷贝文件的源路径和目标路径，均为绝对路径。 控制选项 配置是否启用该操作。 当前步骤执行失败后，应用是否继续执行后续的步骤。 配置是否使用sudo权限执行该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法 。 父主题： 配置CodeArts Deploy应用的文件操作类相关的部署步骤

删除文件 该步骤用于删除环境下目标主机中指定路径的文件/文件夹，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 删除路径 待删除文件/文件夹的路径。 说明： 删除路径如果为文件，则删除具体的文件；如果为文件夹，则删除该文件夹及文件夹下所有文件。 控制选项 配置是否启用该操作。 当前步骤执行失败后，应用是否继续执行后续的步骤。 配置是否使用sudo权限执行该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的文件操作类相关的部署步骤

制品仓库使用案例 在应用步骤信息配置页面，“选择playbook来源”勾选“制品仓库”，单击“选择playbook文件”属性框右边的。 弹出“选择文件”对话框，选择对应的playbook文件压缩包，如下图所示。 填写playbook入口执行文件路径。 入口执行文件路径以选择的playbook压缩包解压后的目录为基准。 如果解压后的目录如下图所示，则入口执行文件路径为“AnsibleDemo/install.yml”。 如果解压后的目录如下图所示，则入口执行文件路径为“install.yml”。

代码仓库使用案例 在应用步骤信息配置页面，“选择playbook来源”勾选“代码仓库”。 单击“选择代码仓库”属性下拉框，选择对应的代码仓库对应的地址（即代码仓库存放playbook具体的SSHurl地址）。 需要先选择代码仓库，然后联动选择分支。 选择入口执行文件路径。 入口执行文件路径以解压playbook包后的目录为基准。 参数设置。 切换到“参数设置”页签，单击“新建参数”，可以为Ansible应用步骤增加参数或者替换all文件参数。 部署应用后，会把相应构建序号的构建任务下载到指定的路径下。 all文件的文件架构及内容样例如下： tomcat_url: http://mirror.olnevhost.net/pub/apache/tomcat/tomcat-7/v7.0.78/bin/apache-tomcat-7.0.78.tar.gz war_url: http://test.com/xxx.war 图1 文件架构 如果添加的参数在playbook参数all文件中存在，则会将all文件中的同名参数替换掉，否则会作为新增参数。 参数设置中参数名称不能包含英文状态的“.”（小数点）、“-”（中划线）和“:”（冒号）。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。

选择部署来源 选择软件包路径或者根据构建记录，将制品库中对应的软件包下载到目标环境中，信息配置如下所示。 表1 选择源类型为制品仓库的参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 选择源类型 包括“制品仓库”和“构建任务”两种类型。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 选择软件包 选择制品仓库中需要部署的软件包。 下载到主机的部署目录 软件包下载到目标主机的路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 表2 选择源类型为构建任务的参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 选择源类型 包括“制品仓库”和“构建任务”两种类型。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 请选择构建任务 目标构建任务，若无构建任务，请创建构建任务 。 制品过滤方式 包括“构建版本”和“构建分支”。 构建序号 目标构建序号。 下载到主机的部署目录 软件包下载到目标主机的路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法 。 父主题： 配置CodeArts Deploy应用其他的部署步骤

安装/卸载Docker 在主机上安装或者卸载Docker环境。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 服务操作类型 选择需要安装或者卸载docker服务。 说明： docker服务只支持拥有sudo权限的用户，此次安装会覆盖之前的docker版本。 docker版本 安装docker的目标版本。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。 配置是否使用sudo权限部署该步骤。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

Linux系统主机配置 为确保Linux系统主机连通性验证成功，Linux主机需确保安装Python并开启SELinux机制，目标主机需要满足以下条件。 目标主机安装Python： 需安装Python2.6及以上版本，如果已安装Python2.6以下版本，需要在主机上安装以下模块，各系统安装命令如下： Ubuntu系统 sudo apt install python-minimal python-simplejson Centos或Euler系统 sudo yum install python-minimal python-simplejson ln -s /usr/bin/python2 /usr/bin/python 采用Apt或者Yum安装工具时，请确保已配置可用的源。 主机开启SELinux机制并安装“libselinux-python”模块： 查看SELinux状态，命令如下： /usr/sbin/sestatus “SELinux”状态参数值所对应的模式： SELinux=disabled：未开启。 SELinux=enforcing：强制模式，表示所有违反安全策略的行为都将被禁止。 SELinux=permissive：宽容模式，表示所有违反安全策略的行为不被禁止，但是会在日志中作记录。 若SELinux=disabled，则主机未开启该机制，需修改SELinux状态，步骤如下： 编辑SELinux的config文件，执行命令： vi /etc/selinux/config 根据实际情况选择修改SELinux参数为参数： SELinux=enforcing：强制模式，表示所有违反安全策略的行为都将被禁止。 SELinux=permissive：宽容模式，表示所有违反安全策略的行为不被禁止，但是会在日志中作记录。 修改完成按键盘“Esc键”，退出编辑模式，执行下面的命令，保存并退出文件。 wq 在根目录下创建隐藏文件.autorelabel，执行下面的命令后，重启Linux主机。 touch /.autorelabel 在主机上安装“libselinux-python”模块，各系统安装命令如下： Ubuntu系统 sudo apt install libselinux-python Centos或Euler系统 sudo yum install libselinux-python

启动/停止GO服务 该步骤可根据服务的指定路径进行启动、停止服务。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 服务操作类型 配置启动服务或者停止服务。 服务对应的绝对路径 GO服务的安装路径。 等待时间 等待服务启动的时间。当选择启动服务时，启动过程中会通过检测进程方式检测服务是否成功启动。可根据服务启动实际所需时间进行调整，如时间设置不合理，会导致检测结果无效。 控制选项 配置是否启用该操作。 当前步骤执行失败后，应用是否继续执行后续的步骤。 配置是否使用sudo权限执行该步骤。 父主题： 配置CodeArts Deploy应用关于服务启动停止相关的部署步骤

在Windows主机新建IIS站点 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 应用程序池 IIS服务的应用程序池。 .Net CLR版本 .Net CLR的版本。 网站名称 网站的名称。 绑定端口 绑定 (监听) 的端口。 物理路径 应用程序对应的物理路径。 日志路径 IIS运行站点日志路径。 控制选项 配置是否启用该操作。 当前步骤部署失败后，应用是否继续部署后续的步骤。

使用NodeJs应用部署模板创建并部署应用 在主机上部署Node.js框架的web服务，并启动该服务。 请确认目标主机已安装Node.js，若已安装请移除模板中“安装Node.js”步骤。 该模板涉及的部署步骤如下所示： 安装Node.js 下载软件包 停止nodeJs服务 启动nodeJs服务 服务启动测试 该模板需要填写的参数如表1所示。 表1 模板参数说明 参数 说明 host_group 该应用部署的目标环境。 package_url 软件包下载地址，可前往制品仓库-软件发布库获取下载链接。 service_port 应用端口。 父主题： 使用预置模板新建并部署应用

示例：通过shell命令步骤查看服务日志 应用部署完毕需要查看服务的启动或执行日志，可使用执行shell命令操作直接查看。 准备工作 您有查看服务启动或执行日志的权限。 需要确定服务启动日志的全路径。 以安装Tomcat服务为例： 服务启动日志的全路径：/usr/local/tomcat/apache-tomcat-8.5.38/logs/catalina.out 操作步骤 使用tail命令可查询服务的启动或执行日志。 在“执行shell命令”步骤详情中，执行以下命令可查询日志的最后20行，执行结果如下图所示。 tail -n 20 /usr/local/tomcat/apache-tomcat-8.5.38/logs/catalina.out 使用shell命令查看文件时尽量不要使用cat命令，如果日志文件过大可能会导致页面加载缓慢。禁止使用tail –f命令。 当执行的shell命令长度大于10240个字符时，建议使用“执行shell脚本”插件。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。

Windows系统代理机配置 所需资源 已有Windows机器。 代理机和主机网络连通正常。 操作步骤 进入代理机，打开powershell窗口，执行netsh命令，注意按参数说明替换参数： netsh interface portproxy add v4tov4 listenaddress=${proxy_ip} listenport=${proxy_port} connectaddress=${host_ip} connectport=${host_port} 表2 参数说明 参数 参数释义 ${proxy_ip} 代理机私网IP ${proxy_port} 代理机监听端口，如54 ${host_ip} 主机私网IP ${host_port} 主机端口，一般为5986 进行安全配置，需要开通代理监听端口，即上述指令中的${proxy_port}。

问题现象 日志提示如下信息： "msg": "Failed to find handler for \"usr/local/python/Python-3.5.4.tgz\". Make sure the required command to extract the file is installed. Command \"/usr/bin/unzip\" could not handle archive. Command \"/usr/bin/gtar\" could not handle archive."}

处理方法 本地使用Xshell工具登录本次实施部署的机器。 重新部署“启动SpringBoot服务”步骤（即部署相同的shell指令），查看机器打印的日志详情。 在本地远程连接的机器上重复上述指令执行。 查看SpringBoot启动日志。 发现该版本包部署的URL接口的路径是/hello01。 回到部署步骤页面，更新URL的path路径配置即可。 SpringBoot服务是由jar包启动，TomCat服务是由war包启动。

选择源为制品仓库 在部署步骤信息配置页面，“选择源类型”选项下勾选“制品仓库”，单击“选择软件包”属性框右边的。 弹出“选择文件”对话框，选择制品仓库下载的目标软件包。 “文件夹”形式的软件包，“选择部署来源”部署步骤会默认下载当前文件夹下面的所有文件。 对于Linux系统，文件夹下面的文件名不能采用中文，否则下载后，文件夹下面的文件名会出现乱码，导致部署失败。 “文件”形式的软件包，“选择部署来源”部署步骤默认下载当前文件。

处理方法 若未安装Jdk，可通过“安装Jdk ”部署步骤进行安装。 正确配置相关环境变量。 由于当前启动操作为“no_login”方式，若系统为Linux系统，jdk为手动安装，还需在以下文件中增加jdk环境变量： Ubuntu: ~/.bashrc 和 ~/.profile Centos: ~/.bashrc 和 ~/.bash_profile 所需环境变量配置示例如下： export JAVA_HOME=/usr/local/jdk /jdk1.8.0_151 export CLASS_PATH=$JAVA_HOME/lib:$JAVA_HOME/jre/lib export PATH=$JAVA_HOME/bin:$PATH 若当前系统为Linux，并使用了“安装JDK”部署步骤，安装版本为“openjdk-1.8.0”时，无需手动配置jdk，应在以下文件中去除jdk环境变量的相关配置。 Ubuntu: ~/.bashrc 和 ~/.profile Centos: ~/.bashrc 和 ~/.bash_profile