Exporting Native Applications

To standardize the export process of applications between development, testing, and production environments, and to facilitate the rapid migration of business to new environments, you can export native applications as application templates (Charts) or export simplified YAML files that can be used directly for deployment. This allows the native application to run in different environments or namespaces. You can also export YAML files to a code repository to deploy applications across clusters quickly using GitOps functionality.

Exporting Helm Charts

Steps

  1. Access the Container Platform.

  2. In the left navigation bar, click on Application Management > Native Applications.

  3. Click on the application name of the type Custom Application.

  4. Click on Actions > Export; you can also export a specific version from the application detail page.

  5. Choose one export method as needed and refer to the following instructions to configure the relevant information.

    • Exporting Helm Charts to a template repository with management permissions

      Note: The template repository is added by the platform administrator. Please contact the platform administrator to obtain a valid template repository of type Chart or OCI Chart with Management permissions.

      ParameterDescription
      Target LocationSelect Template Repository to directly sync the template to a template repository of type Chart or OCI Chart with Management permissions. The project owner assigned to this Template Repository can directly use the template.
      Template DirectoryWhen the selected template repository type is OCI Chart, you need to select or manually input the directory for storing the Helm Chart.
      Note: When manually entering a new template directory, the platform will create this directory in the template repository, but there is a risk of the creation failing.
      VersionThe version number of the application template.
      The format should be v<Major>.<Minor>.<Patch>. The default value is the current application version or the current snapshot version.
      IconSupports JPG, PNG, and GIF image formats, with a file size of no more than 500KB. Suggested dimensions are 80*60 pixels.
      DescriptionThe description will be displayed in the list of application templates within the application directory.
      READMEDescription file. Supports editing in Markdown format and will be displayed on the details page of the application template.
      NOTESTemplate help file. Supports standard plaintext editing; after the deployment template is completed, it will be displayed on the template application details page.
    • Exporting Helm Charts to local for manual upload to the template repository: Select Local as the target location and choose Helm Chart as the file format to generate a Helm Chart package which will be downloaded locally for offline transmission.

  6. Click Export.

Follow-Up Actions

Exporting YAML to Local

Steps

Method 1

  1. Access the Container Platform.

  2. In the left navigation bar, click on Application Management > Native Applications.

  3. Click on application name.

  4. Click on Actions > Export; you can also export a specific version from the application detail page.

  5. Select Local as the target location and YAML as the file format, at which point you can export a simplified YAML file that can be deployed directly in other environments.

  6. Click Export.

Method 2

  1. Access the Container Platform.

  2. In the left navigation bar, click on Application Management > Native Applications.

  3. Click on application name.

  4. Click on the YAML tab, configure settings as needed, and preview the YAML file.

    TypeDescription
    Full YAMLBy default, Preview Simplified YAML is not selected, displaying the YAML file with the managedFields fields hidden. You can preview it and export directly; you may also uncheck Hide managedFields fields to export the full YAML file.
    Note: Full YAML is primarily used for operations and troubleshooting and cannot be used to quickly create native applications on the platform.
    Simplified YAMLCheck Preview Simplified YAML, at which point you can preview and export a simplified YAML file that can be deployed directly in other environments.
  5. Click Export.

Follow-Up Actions

After exporting the simplified YAML, you can refer to Creating Native Applications - YAML Method to create a Custom Application type of native application in a non-current namespace.

Exporting YAML to Code Repository (Alpha)

Precautions

  • Only platform administrators and project administrators can directly export native application YAML files to the code repository.

  • Template Applications do not support exporting Kustomize formatted application configuration files or directly exporting YAML files to the code repository; you can first detach from the template and convert it to a Custom Application.

Steps

  1. Access the Container Platform.

  2. In the left navigation bar, click on Application Management > Native Applications.

  3. Click on the application name of type Custom.

  4. Click on Actions > Export; you can also export a specific version from the application detail page.

  5. Choose one export method as needed and refer to the following instructions to configure the relevant information.

    • Exporting YAML to a code repository:

      ParameterDescription
      Target LocationSelect Code Repository to directly sync the YAML file to the specified Git code repository. The project owner assigned to this Code Repository can directly use the YAML file.
      Integration Project NameThe name of the integration tool project assigned or associated with your project by the platform administrator.
      Repository AddressThe repository address assigned for your use under the integrated tool project.
      Export Method
      • Existing Branch: Export the application YAML to the selected branch.
      • New Branch: Create a new branch based on the selected Branch/Tag/Commit ID and export the application YAML to the new branch.
        • If Submit PR (Pull Request) is checked, the platform will create a new branch and submit a Pull Request.
        • If Automatically delete source branch after merging PR is checked, the source branch will be automatically deleted after you merge the PR in the Git code repository.
      File PathThe specific location where the file should be saved in the code repository; you can also input a file path, and the platform will create a new path in the code repository based on the input.
      Commit MessageFill in commit information to identify the content of this submission.
      PreviewPreview the YAML file to be submitted and compare differences with the existing YAML in the code repository, displayed with color differentiation.
    • Exporting Kustomize-type files to local for manual upload to the code repository: Select Local as the target location and choose Kustomize as the file format to export the Kustomize-type application configuration file locally. This file supports differentiated configurations and is suitable for cross-cluster application deployments.

  6. Click Export.

Follow-Up Actions

After exporting the YAML to a Git code repository, you can refer to Creating GitOps Applications to create a Custom Application type of GitOps application across clusters.