# 创建OS版本变更任务
在日常运维过程中，为了保持系统的稳定性和安全性，需要定期对操作系统进行版本升级。然而，手动执行这一过程不仅耗时而且容易出错。您可以通过创建OS版本变更任务。任务创建好后会生成对应的OS版本升级工单，从而简化了操作流程，提高了运维效率。
OS版本变更为按需计费功能，请根据您实际需求创建，具体收费请参考[计费说明](https://support.huaweicloud.com/price-coc/coc_pro_07_02.html)。
#### 约束限制
- 目前操作系统类型仅支持Red Hat Enterprise Linux。
- 资源类型仅支持ECS和IDC离线资源。
- 升级路径：Red Hat Enterprise Linux（RHEL）7.4/7.6 -\> 7.9、Red Hat Enterprise Linux（RHEL）7.9 -\> 8.6/8.8/8.10。
- 架构类型仅支持x86_64。
- 所选择实例的UniAgent状态必须为运行中。
 
#### 注意事项
OS升级失败时可能会导致系统无法启动或功能异常，升级前务必完成系统镜像备份。更多兼容性问题请参考[OS版本升级兼容性问题](https://support.huaweicloud.com/usermanual-coc/coc_um_05_05_03.html)。
#### 创建OS版本变更
1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。
2. 在左侧导航栏选择"资源运维 \> 自动化运维"，进入自动化运维页面。
3. 在"高阶运维"模块单击"OS版本变更"，进入OS版本变更页面。
4. 填写OS版本变更的基本信息。 
   图1配置基本信息   
   ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780946203.png "点击放大")
   表1基本信息参数说明 
   | 参数        | 说明                                                                                            | 示例                  |
   |:---|:---|:---|
   | IAM权限委托 | 必选参数。 IAM委托名称（该委托是云服务委托，"委托名称"若不填，则默认为"ServiceAgencyForCOC"）。 | ServiceAgencyForCOC |
   | 执行描述      | 可选参数。 对本次作业进行描述说明。说明内容不能超过500个字符。                          | -                    |
      
   
   
5. 选择"OS类型"、"架构类型"和"目标版本"。 
   - OS类型：请选择升级的OS类型。目前只支持"RedHat"类型。
   
   - 架构类型：请选择升级的CPU架构类型。目前只支持x86_64。
   
   - 目标版本：请选择升级的目标版本。
     图2配置执行内容   
     ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866333.png "点击放大") 
   
   
   
   
6. 设置"OS版本升级步骤"。 
   - 系统已预置了"升级前业务处理"、"升级前准备"、"升级前检查"、"升级前备份"、"OS升级"、"OS重启"、"睡眠"、"等待OS重启"、"升级后系统处理"、"升级后业务处理"和"升级后业务验证"11个步骤。
   
   - 其中"升级前业务处理"、"升级后业务处理"、"升级后业务验证"支持自定义配置，单击步骤下的"修改"，右侧弹出"修改参数"抽屉，您可以在"基本信息"选择[自定义脚本](https://support.huaweicloud.com/usermanual-coc/coc_um_05_01_01.html)，在"输入"修改输入参数。其余步骤不支持自定义配置。
     图3自定义配置   
     ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866339.png "点击放大") 
   
   
   
   
7. 单击"添加实例"，选择需要升级的实例。
   
   图4添加实例   
   ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002751227328.png "点击放大")
   表2选择实例参数说明 
   | 参数     | 说明                                                                                                                                                                                                                                                                                                                      | 示例       |
   |:---|:---|:---|
   | 选择方式   | 请选择实例选择方式，"自动全选"暂不支持。 - 手动选择：根据"企业项目"、"视图类型"、"资源类型"、"区域"和"目标实例"确认筛选条件，手动选择实例。  - 自动全选：根据"企业项目"、"视图类型"、"资源类型"、"区域"和"目标实例"确认筛选条件，自动选择全部实例。   | 手动选择      |
   | 企业项目 | 请选择企业项目，支持选择"全部"。                                                                                                                                                                                                                                                                                                      | 全部      |
   | 视图类型 | 请选择视图类型。 - CMDB资源视角：以资源视角选择实例列表。  - CMDB应用视角：以应用视角选择实例列表。                                                                           | CMDB资源视角 |
   | 资源类型   | 请选择资源类型。目前仅支持ECS和IDC离线资源。                                                                                                                                                                                                                                                                                              | ECS     |
   | 区域   | 请选择执行区域。不支持跨区域选择目标实例。                                                                                                                                                                                                                                                                                                   | 华北-北京四   |
   | 目标实例 | 在筛选框设置条件，手动选择实例。                                                                                                                                                                                                                                                                                                      | 勾选需要的实例。  |
      
   
   
8. 当[7]选择多实例时，根据实际需求设置分批策略。
   
   表3分批策略参数说明 
   | 参数     | 说明                                  |
   |:---|:---|
   | 自动分批 | 用户选择的待执行机器，会根据默认规则，自动分成多批次。          |
   | 手动分批  | 用户可以根据自身需要，手动创建若干批次，然后手动将机器分配到各批次中。 |
   | 不分批   | 用户所有待执行的机器会全部在同一批次。                |
      
   "目标实例"选择多个实例，且"分批策略"选择"自动分批"或"手动分批"时，可以设置批次之间的规则，支持选择"首次暂停"、"全部暂停"、"全部继续"或"自定义"。
   - 选择"首次暂停"，则第一批次执行完毕后，需要手动单击"继续"才能执行下一批次。
   
   - 选择"全部暂停"，则每个批次执行完毕后，都需要手动单击"继续"才能执行下一批次。
   
   - 选择"全部继续"，则每个批次执行完毕后自动继续执行下一批次。
   
   - 选择"自定义"，则可自定义设置每个批次执行完毕后是暂时还是继续执行下一批次。
   
   
   例如，您已选择多个目标实例，并希望自定义分批执行，则可以选择"手动分批"，设置分批次数为3，及批次间执行规则选择"首次暂停"，再选择对应批次并单击"添加实例"，为该批次添加需要执行的实例。
   当第一批次实例执行完任务后，会暂停执行，您可以检测执行结果是否符合预期；确认无误后单击"继续"，会执行下一批次实例任务；第二批任务执行完毕后无需手动确认，自动执行第三批次。
   图5设置分批策略   
   ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780946195.png "点击放大")
   
   
9. （可选）设置全局参数。 
   单击"修改"，修改OS版本变更相关的全局参数。
   表4参数说明 
   | 参数                                   | 说明                                                                                                                                                                                                                                                                                                                   |
   |:---|:---|
   | REPO_IP_GLOBAL                          | 必填参数。 为本地yum源的IP地址。                                                                                                                                                                                                                                                                  |
   | SUT_PACKAGE_NAME_GLOBAL             | 必填参数，存在默认值。 sut包名。                                                                                                                                                                                                                                                                 |
   | HUAWEI_OBS_ENDPOINT_GLOBAL           | 必填参数，存在默认值。 华为云OBS桶地址。                                                                                                                                                                                                                                                              |
   | BACKUP_DIR_CUSTOM_GLOBAL            | 选填参数。 需要自定义备份的目录地址，多个地址之间使用英文逗号隔开。                                                                                                                                                                                                                                              |
   | EXCLUDE_DIR_CUSTOM_GLOBAL              | 选填参数。 无需备份的目录地址，多个地址之间使用英文逗号隔开。                                                                                                                                                                                                                                                  |
   | REPO_BASE_URL_GLOBAL                  | 必填参数。 本地yum源结构，即yum源的路径地址。                                                                                                                                                                                                                                                          |
   | MAXIMUM_SPACE_OF_BACKUP_FILE_GLOBAL | 选填参数。 备份目录中的最大文件限制（MB），默认值5120。                                                                                                                                                                                                                                                   |
   | IDC_PROXY_IP_PORT_GLOBAL               | 使用IDC代理方式升级时必填。 代理服务器IP与端口。                                                                                                                                                                                                                                                        |
   | CONFLICT_RPM_CUSTOM_GLOBAL             | 选填参数，大版本升级特有参数。 自定义升级冲突RPM包名单用以决定冲突检测是否允许跳过，多个包名使用英文逗号隔开。                                                                                                                                                                                                                        |
   | IS_AUTO_FIX_INCOMPAT_CASE_GLOBAL     | 选填参数，大版本升级特有参数。 是否允许自动修复部分RPM包的不兼容问题，默认为true。 - true：自动修复部分RPM包的不兼容问题。  - false：不自动修复RPM包的不兼容问题。   |
      
   
   
10. 单击"确定"，确认执行信息后再次单击"确定"。 
    系统将自动跳转至OS版本变更工单页面，可[查看OS版本变更工单执行记录]。
    
    
 
 #### 查看OS版本变更工单执行记录
执行OS版本变更后会生成一条OS版本变更记录，记录OS版本变更执行的结果。若您需要跟踪和记录OS版本变更的对象及执行结果，可通过OS版本变更工单功能查看。
1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。
2. 在左侧导航栏选择"任务管理 \> 执行记录"，进入执行记录页面。
3. 单击上方"OS版本变更工单"，切换至OS版本变更工单页签。
4. 在OS版本变更工单列表中，单击工单ID，进入工单详情页面。
5. 根据工单状态，支持以下操作： 
   - 若工单状态为"失败"。单击"重试"，重新尝试执行OS版本变更工单。
   
   - 若工单状态为"失败"，单击"回滚"，回滚到升级前的版本。
   
   
   
   
 
#### 相关文档
通过COC的**OS版本变更** 功能，实现对多台主机的**批量升级** 操作，具体操作请参考[通过COC批量升级OS版本](https://support.huaweicloud.com/bestpractice-coc/coc_case_06.html)。
