# 升级组件 若组件部署失败后，也可以通过升级的形式重新部署。 #### 使用限制 组件升级时，代码源格式有限制，如：镜像部署只能使用镜像升级，jar包部署只能使用jar包升级，war包部署只能使用war包升级。 #### 操作步骤 1. [登录CAE控制台](https://console.huaweicloud.com/cae/)。 2. 在左侧导航栏中选择"组件列表"。 3. 选择待操作组件，在"操作"列单击"升级"，进入升级组件页面。 4. 参考下表设置组件升级后信息。 表1组件基本信息 | 参数 | 类别 | 说明 | |:---|:---|:---| | 组件名称 | - | 新建组件的名称。组件名称命名规则：输入4到32个字符，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 | | 版本号 | - | 组件的版本号。 格式为：A.B.C或者A.B.C.D。A、B、C、D为自然数，例如：1.0.0或者1.0.0.0。 | | 实例规格 | - | 选择实例规格，实例规格包括CPU规格和内存规格，不同规格的CPU配套对应不同大小的内存。例如：0.5core、1GiB；1core、1GiB；1core、2GiB；2core、4GiB。 说明： 如果您的环境首次创建大规格实例，则需要更多时长配置对应配额资源，请耐心等待。 | | 实例数量 | - | 实例数量默认为2，最少为1，最大值为99。 组件创建成功后，支持[手动伸缩组件实例](https://support.huaweicloud.com/usermanual-cae/cae_03_0035.html)，手动伸缩的实例数范围在1至99之间。 | | 代码源 | 源码仓库 | 当前不支持该功能，推荐使用[CAE对接GitHub Actions实现自动CICD部署](https://support.huaweicloud.com/bestpractice-cae/cae_05_0064.html)。 1. 选择源码来源。本服务支持识别CodeArts、GitHub、GitCode、GitLab、Gitee和Bitbucket来源的代码。 2. 将代码信息补充完整。 - **授权信息**：从下拉框中选择对应的源码授权信息。如果您是首次使用该功能，在下拉框右侧单击"新建授权"，填写"授权名称"和选择"授权方式"，单击"确认"完成授权。单击"授权列表"可查看当前已创建的授权信息，选中列表前方复选框，可对已授权源码进行"重新授权"或"删除"。 - **用户名/组织**：选择源码对应的用户名称或组织，用于当前项目的代码管理。 - **仓库名称**：用于当前项目下各个模块代码的管理。 - **分支**：选择对应的分支，用于开发对代码的管理。 3. 语言/运行时：从下拉框中选择源码对应的语言格式。具体操作请参考[组件说明](https://support.huaweicloud.com/usermanual-cae/cae_03_0020.html#cae_03_0020__zh-cn_topic_0208462089_section3341123774917)。 4. 自定义构建：构建命令可根据业务需要选择"使用默认命令或脚本"或"使用自定义命令"。 说明： 不同源码来源新建授权时授权方式不同，请按照实际情况进行选择。 - 使用默认命令或脚本：优先执行代码根目录下的build.sh，不存在则按照所选语言的通用方法构建，如Java：mvn clean package。 - 使用自定义命令：根据所选语言自定义构建命令；或修改build.sh文件后选择使用默认命令或脚本。 5. Dockerfile：组件来源是"源码仓库"时，根据业务需要设置。支持"自定义"和"系统默认"。 说明： 仅当"运行时"选择java时，可选择"系统默认"修改系统默认dockerfile中指定运行的maven构建制品文件名。 6. Dockerfile地址：当"Dockerfile"选择"自定义"时可设置。 - "Dockerfile地址"即Dockerfile文件相对于项目的根目录（./）所在的目录，Dockerfile文件用于镜像构建。 - Docker程序通过读取Dockerfile文件生成定制的镜像。 - dockerfile地址只能包含字母、数字及.-_/且字符长度在1\~255范围内的内容。 - 如果文件名为Dockerfile，允许只填写目录地址，但目录地址必须以/结尾。 7. 制品文件名：当"Dockerfile"选择"系统默认"时可设置。 maven构建生成多个jar包时，选取指定的jar包运行，以".jar"结尾，支持模糊匹配，如:demo-1.0.jar，demo\*.jar | | 代码源 | 镜像 | 1. 用户可以通过"客户端上传镜像"和"页面上传镜像"两种方式上传镜像包。 - 客户端上传镜像：选择"客户端上传镜像"时，需要以root用户登录容器引擎所在的虚拟机，获取登录访问命令，并复制到节点上执行，上传镜像。 - 页面上传镜像：选择"页面上传镜像"时，单次仅支持添加1个镜像压缩包，文件大小（含解压后）不得超过 2 GB，支持 tar、tar.gz格式，仅支持上传1.11.2及以上容器引擎。客户端版本制作的镜像压缩包，制作过程详见[制作镜像压缩包](https://support.huaweicloud.com/usermanual-swr/swr_01_0006.html#swr_01_0006__section3433103111126)。 如需上传大于 2GB的文件，请使用"客户端上传镜像"。 2. 在"我的镜像"、"开源镜像"或者"共享镜像"中选择已上传的镜像包部署。可通过镜像名称搜索镜像。 - **我的镜像**：用户自定义上传的镜像包。 - **开源镜像**：容器镜像服务SWR中提供的开源镜像。 - **共享镜像**：不同账号之间共享的镜像包。 3. （可选）用户还可以通过单击"代码源"右侧链接，前往容器镜像服务SWR控制台对镜像进行更多管理操作。 需注意： - CAE容器部署不支持arm架构的镜像。 - 选择"页面上传镜像"时，单次仅支持添加1个镜像压缩包，文件大小（含解压后）不得超过 2 GB，支持 tar、tar.gz格式，仅支持上传1.11.2及以上容器引擎。客户端版本制作的镜像压缩包，制作过程详见[制作镜像压缩包](https://support.huaweicloud.com/usermanual-swr/swr_01_0006.html#swr_01_0006__section3433103111126)。 如需上传大于 2GB的文件，请使用"客户端上传镜像"。 | | 代码源 | 软件包 | 当前不支持该功能，推荐使用[CAE对接GitHub Actions实现自动CICD部署](https://support.huaweicloud.com/bestpractice-cae/cae_05_0064.html)。 1. 选择软件包的来源，来源包括"CodeArts软件发布库"、"OBS对象存储选择"和"GitHub Artifact"。 - 从"CodeArts软件发布库"选择对应软件包时，需要提前将软件包上传至软件发布库，具体操作请参考[上传软件包](https://support.huaweicloud.com/usermanual-cloudartifact/cloudartifact_01_0002.html)。 - 从"OBS对象存储选择"中选择对应软件包时，需要先将软件包上传至OBS对象存储桶内，具体操作请参考[上传对象](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829661.html)。 - 从"GitHub Artifact"中选择对应软件包时，需填写授权名称，选择授权方式。授权方式可以选择OAuth和私人令牌。 说明： 私人令牌的获取方式： 1. 登录GitHub的[创建私人令牌页面](https://github.com/settings/tokens)。 2. 依次单击"Generate new token \> Generate new token (classic) "。 3. 在设置页面创建正确权限的私人令牌，依次勾选下列scopes："repo"、"read:org"、"admin:repo_hook"、"admin:org_hook"、"read:user"。 4. 单击"Generate token"按钮，生成私人令牌。令牌只返回一次，请记录保存好。 2. 语言/运行时：从下拉框中选择软件包对应的语言格式。具体操作请参考[组件说明](https://support.huaweicloud.com/usermanual-cae/cae_03_0020.html#cae_03_0020__zh-cn_topic_0208462089_section3341123774917)。 3. 构建方式：根据业务需要选择"系统默认"或"自定义Dockerfile"。 - 使用"系统默认"：根据语言/运行时使用默认Dockerfile构建。 - 使用"自定义Dockerfile"：根据所选语言自定义Dockerfile内容构建。 | 图1升级组件 ![](https://support.huaweicloud.com/usermanual-cae/zh-cn_image_0000001723012705.png "点击放大") 5. 单击"立即升级"，完成组件升级。