Home / Platform management / Catalog / Chart repositories / Add Template Repository

Add Template Repository

By adding a template repository, you can map enterprise-customized Helm Chart repositories, OCI Chart repositories, or Git repositories to the platform. This allows synchronization of charts (application templates) from the repository to be used by other members of the enterprise or team.

When adding a template repository to the platform, you can assign it to specific projects or all projects on the platform. All namespaces under projects assigned to the template repository can use the application templates from that repository.

Prerequisites

Before adding a template repository, ensure you have a remote repository set up and you have access credentials (username, password) for it.

Procedure

  1. In the left navigation pane, click App Store Management > Template Repositories.

  2. Click the Add Template Repository button to open the Add Template Repository dialog box.

  3. Configure the parameters as per the following instructions.

    Parameter Description
    Type Type of the template repository, defaulting to Chart.
    • OCI Chart: Supports OCI-standard image repositories.
    • Chart: Helm Chart repository.
    • Git: Git repository.
    Repository URL
    • For OCI Chart type, enter the address of the OCI Chart repository. The OCI-Chart repository URL should be provided without a protocol (e.g., HTTP or HTTPS), only the domain or server address part is needed. For example: harbor.demo.io/3rdparty/chart-app. The platform can integrate with Docker Registry, Harbor, etc., supporting OCI-standard repositories (both internally deployed or externally hosted).
    • For Chart type, enter the Chart repository URL. For Harbor Chart repositories, the address must point to a specific project within the Harbor repository. For example, if the Harbor repository chartrepo has two projects, project1 and project2, the repository URLs would be https://harbor-b.test.cn/chartrepo/project1 and https://harbor-b.test.cn/chartrepo/project2. The field chartrepo is fixed and should not be modified.
    Permission For Chart or OCI Chart type, set the repository access level, defaulting to Manage.
    • Manageable: Allows deployment, version management, and deletion of templates within the repository. Supports uploading application templates locally to the repository.
    • Read-Only: Allows deployment of templates from the repository, without management capabilities.
    Code Repository URL URL to access the template repository remotely. Required when the repository type is Git, and the URL should start with http:// or https://.
    Directory Directory within the repository to access, defaults to /. Required when the repository type is Git.
    Username Username to access the template repository.
    Password Password to access the template repository.
    Allocated Projects Assign this template repository to All Projects or Specific Projects on the platform. After assignment, all namespaces under assigned projects can create custom applications using templates from this repository.
    None indicates no immediate assignment. You can update project assignments later using the Update Template Repository operation after the template repository is created.
  4. Click Add.
    Once the template repository is successfully created, it will start synchronizing application templates from the repository.

You can click the on the list page or Actions in the details page to update or delete the template repository as needed.

Note: Deleting a template repository will also delete all application templates imported through that repository. However, it will not affect applications created using the deleted application templates.