Deploying an Application from a Chart

Constraints

• The number of charts that can be uploaded by a single user is limited. The value displayed on the console of each region is the allowed quantity.
• CCE uses Helm v3.8.2 and allows uploading Helm v3 chart packages.
• A chart with multiple versions consumes the same amount of portion of chart quota.
• Users with chart operation permissions can perform multiple operations on clusters. Therefore, exercise caution when assigning users the chart lifecycle management permissions, including uploading charts and creating, deleting, and updating chart releases.

Chart Specifications

The Redis workload is used as an example to illustrate the chart specifications.

• Naming requirement

  A chart package is named in the format of {name}-{version}.tgz, where {version} indicates the version number in the format of Major version number.Minor version number.Revision number, for example, redis-0.4.2.tgz.

  

  The chart name {name} can contain a maximum of 64 characters.

  The version number must comply with the semantic versioning rules.

  • The main and minor version numbers are mandatory, and the revision number is optional.
  • The major and minor version numbers and revision number must be integers, greater than or equal to 0, and less than or equal to 99.
• Directory structure

  The directory structure of a chart is as follows:

  redis/
    templates/
    values.yaml
    README.md
    Chart.yaml
    .helmignore

  As listed in Table 1, the parameters marked with * are mandatory.

  Table 1 Parameters in the directory structure of a chart

  Parameter	Description
  * templates	Stores all templates.
  * values.yaml	Describes configuration parameters required by templates. NOTICE: Make sure that the image address set in the values.yaml file is the same as the image address in the container image repository. Otherwise, an exception occurs when you create a workload, and the system displays a message indicating that the image fails to be pulled. To obtain the image address, perform the following operations: Log in to the CCE console. In the navigation pane, choose Image Repository to access the SWR console. Choose My Images > Private Images and click the name of the uploaded image. On the Image Tags tab, obtain the image address from the pull command. You can click to copy the command in the Image Pull Command column.
  README.md	A markdown file, including: The workload or services provided by the chart. Prerequisites for running the chart. Configurations in the values.yaml file. Information about chart installation and configuration.
  * Chart.yaml	Basic information about the chart. Note: The API version of Helm v3 is switched from v1 to v2.
  .helmignore	Data or files that do not need to read templates during workload installation.

Uploading a Chart

1. Log in to the CCE console and click the cluster name to go to the cluster console.
2. In the navigation pane, choose App Templates. In the upper right corner, click Upload Chart.
3. Click Add, select the chart to be uploaded, and click Upload.
   Figure 1 Uploading a chart
   

Creating a Release

1. Log in to the CCE console and click the cluster name to go to the cluster console.
2. In the navigation pane, choose App Templates.
3. On the My Charts tab, locate the target chart and click Install.
4. Configure the parameters by referring to Table 2.

   Table 2 Parameters for installing a chart

   Parameter	Description
   Release Name	Unique name of the chart release.
   Namespace	Namespace to which the workload will be deployed.
   Select Version	Version of the chart.
   Configuration File	You can import and replace the values.yaml file or directly edit the chart parameters online. NOTE: An imported values.yaml file must comply with YAML specifications, that is, KEY:VALUE format. The fields in the file are not restricted. The key value of the imported values.yaml must be the same as that of the selected chart package. Otherwise, the values.yaml does not take effect. That is, the key cannot be changed. Click Add. Select the corresponding values.yaml file and click Open.

5. Click Install.

   On the Releases tab, you can view the status of the release.

Upgrading an Applications Deployed Using a Chart

1. Log in to the CCE console and click the cluster name to go to the cluster console.
2. In the navigation pane, choose App Templates. Then click the Releases tab.
3. Locate the target release, click Upgrade in the Operation column, and then configure the parameters.
4. Select a chart version.
5. Follow the prompts to modify the chart parameters. Confirm the modification and click Upgrade.

   In the release list, if the release status changes to Upgraded, the application has been upgraded.

Rolling Back an Application Deployed Using a Chart

1. Log in to the CCE console and click the cluster name to go to the cluster console.
2. In the navigation pane, choose App Templates. Then click the Releases tab.
3. Locate the target release, click Roll Back in the Operation column, select the release version, and click Roll Back.

   In the release list, if the release status changes to Rollback successful, the application has been rolled back.

Uninstalling an Application Deployed Using a Chart

1. Log in to the CCE console and click the cluster name to go to the cluster console.
2. In the navigation pane, choose App Templates. Then click the Releases tab.
3. Locate the target release, choose More > Uninstall in the Operation column, and then click Yes. Uninstalled releases cannot be recovered.