编辑批量升级发布单

前提条件

批量升级发布单已创建但未发布。创建批量升级发布单，请参考创建批量升级发布单。

编辑批量升级发布单

1. 登录ServiceStage控制台。
2. 单击“发布管理”，进入“发布管理”列表页面。
3. 选择待编辑的状态是“待发布”的批量升级发布单。
   • 直接编辑：选择“操作”列的“更多 > 编辑”。
   • 确认发布单详情后编辑：单击目标发布单名称，进入该发布单的“发布管理”页面确认各组件的配置后，单击“编辑”。

4. 参考下表修改发布单基本信息，其中带“*”标志的参数为必填参数。

   参数名称	参数说明
   *发布单名称	发布单的名称。 长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或数字结尾。
   描述	发布单描述信息，长度不超过128个字符。

5. 设置“激进策略”。
   • 开启“激进策略”，遇到组件发布失败，会继续发布剩余组件。
   • 关闭“激进策略”，遇到组件发布失败，会导致发布单发布任务失败。

6. 如需删除已加入发布单的组件，请单击目标组件所在行“操作”列的“删除”。
7. 如需新增组件，请单击“添加组件”，批量勾选待加入发布单的组件，单击“确定”。

   同一个批量升级发布单下，支持最多包含64个运行状态为“运行中”、“未就绪”、“未知”、“异常”的组件。查看组件状态，请参考查看组件详情。

8. 根据实际业务需要参考下表重新设置各组件版本配置信息。

   参数名称	参数说明
   组件版本	组件版本号。 发布单中原有组件默认版本号以您开始执行3操作的时间来生成版本号；发布单中新添加组件默认以您完成7操作的时间来生成版本号。默认版本号格式为yyyy.mmdd.hhmms，s取时间戳中秒数的个位值。例如：时间戳为2022.0803.104321，则版本号为2022.0803.10431。 您也可以自定义版本号，格式为：A.B.C或者A.B.C.D。A、B、C、D为自然数，例如：1.0.0或者1.0.0.0。 自定义版本号需唯一，请勿与该组件的历史版本号重复，否则会导致本次部署记录覆盖掉相同版本的历史部署记录。
   镜像包	单击，重新选择组件包来源，请参考组件来源说明。 容器部署方式部署的组件，如果选择的是镜像包： 如果创建并部署组件已经勾选了“启用多容器”，选择指定的容器，单击，可以指定该容器为初始化容器，用于业务容器启动前安装特定工具或脚本。多个容器中，至少需要指定一个容器作为业务容器（非初始化容器）。初始化容器详情，请参考Init容器。 可重新自定义“容器名称”：长度为1到63个字符，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 单击已选择的容器卡片右上角的，可修改容器的镜像包来源。 容器部署方式部署的组件，如果选择的是软件包，可重新自定义“容器名称”：长度为1到63个字符，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 如果组件来源为软件包且需要使用例如JFrog（制品仓库）作为软件包存储仓库，您可以选择“自定义文件地址”上传方式。 输入软件包所在的自定义HTTP/HTTPS协议的文件下载地址。 选择是否开启认证。 不开启认证，则默认任何用户都可以下载上传到自定义文件地址的软件包。 单击开启认证，则只有通过认证的用户才能下载上传到自定义文件地址的软件包。“认证方式”支持“用户密码认证”、“自定义Header认证”，认证方式及对应的认证参数由您自定义的文件地址所在服务器支持的认证方式决定。 容器部署方式部署的组件，支持设置“镜像访问凭证”。最多支持选择16个镜像访问凭证。单击“创建密钥”，可以创建新的镜像访问凭证。请参考创建密钥，“密钥类型”必须选择kubernetes.io/dockerconfigjson。 镜像访问凭证即密钥，用于存放拉取私有仓库镜像所需的认证信息。如果是公共仓库镜像，可以保持默认设置或者不设置镜像访问凭证。如果是私有仓库镜像，必须设置正确的镜像访问凭证，否则会导致镜像拉取失败。
   部署批次	表示分几个批次升级组件实例，取值范围为[1, 总实例数]。总实例数，即组件当前运行的实例数量。 例如，组件总实例数为4，“部署批次”参数设置为2，则表示会分2批次升级组件版本配置，每批次升级2个组件实例。 容器部署方式部署的组件，设置了本参数后，在9中设置组件升级策略时，您也可以重新设置。
   部署顺序	指定组件在所有待加入发布单组件里面的部署次序。 如果已选组件之间存在依赖关系，例如某组件的启动需要依赖其他组件，则需要设置“部署顺序”，使被依赖的组件优先被部署。 例如，待加入发布单的A、B、C三个组件，A组件的启动依赖于B、C组件。因此，需要将B、C组件的“部署顺序”设置为1，将A组件的“部署顺序”设置为2。 如果待加入发布单的组件之间不存在依赖关系，则“部署顺序”可以保持默认，所有组件会同批次被部署。

9. 单击目标组件所在行“操作”列的“高级配置”，根据实际业务需要设置组件高级配置参数，然后单击“确定”。
   • 选择组件技术栈及版本。技术栈详情，请参考技术栈简介。
   • 容器部署方式部署的组件，请参考管理容器部署组件云服务配置~管理容器部署组件高级配置进行设置。
   • 虚拟机部署方式部署的组件：
     • 请参考管理虚拟机部署组件配置进行设置。
     • 选择“升级策略”，设置组件“停止前等待时间”。

       设置停止实例运行前等待时间，以保证已接收的流量处理完成。单位为秒（s），取值范围为[0, 600]。

10. 请参考下表根据是否发布发布单执行后续操作。

    是否发布发布单	操作方法
    是	单击“完成并执行”，系统会自动进行高级配置预检查，检查各组件的高级配置是否正确。 如果高级配置预检查报错，请执行以下操作重新配置后再执行后续操作。 请在弹出的对话框确认问题后，单击“确定”。 单击报错组件“操作”列的“高级配置”，参考9根据报错情况重新设置。 如果高级配置预检查通过，发布单中的组件会按照发布单的配置批量完成部署。 在发布单发布过程中，如果发现组件配置错误等原因，您可以单击“中断”终止发布单发布，然后单击“克隆”，参考克隆批量升级发布单，重新设置组件配置后重新发布发布单。 您可以查看该发布单的发布记录和发布单信息，执行回滚已发布的批量升级发布单、克隆批量升级发布单、删除发布单操作。
    否	单击“创建完成”，系统会自动进行高级配置预检查，检查各组件的高级配置是否正确。 如果高级配置预检查报错，请执行以下操作重新配置后再执行后续操作。 请在弹出的对话框确认问题后，单击“确定”。 单击报错组件“操作”列的“高级配置”，参考9根据报错情况重新设置。 如果高级配置预检查通过，生成状态为“待发布”的发布单。 在“发布管理”页面，您可以查看发布单信息，执行发布待发布的发布单、克隆批量升级发布单、编辑批量升级发布单或删除发布单操作。