The page has been translated by Gen AI.

Helm Chart

Helm chart is a feature that registers charts stored in the chart repository so they can be used in the DevOps Console.

Helm charts can be used through Helm install. Additionally, you can integrate them with the App template via Add supported Helm chart.

Getting Started with Helm Chart

To start managing Helm charts, follow these steps.

  1. Main page, click the Admin icon at the top right. Admin page opens.
  2. In the left menu, click the Tools & Templates > Helm Chart menu.

Getting Started with Project Helm Chart

Note
You can register, modify, or delete Helm charts that are usable only within the project.
  1. On the Main page, click the Project card. You will be taken to the Project Dashboard page.
  2. Click the Repository > Helm Chart menu in the left sidebar. You will be taken to the Helm Chart page.

Add Helm chart

Users can add their own Helm charts.

Before registering a Helm chart, the user must first upload the chart to be used via Upload Chart.

To add a Helm chart, follow these steps.

  1. Click the Admin icon at the top right of the Main page. The Admin page opens.
  2. From the left menu, click the Tools & Templates > Helm Chart menu. The Helm Chart page opens.
  3. Select the Helm chart type from the menu. The Add Helm chart button appears only if you have registration permission based on the selected information.
  4. Click the Add Helm Chart button. You will be taken to the Helm Chart Registration page.
  5. Enter Helm chart basic information and click the Start button.
    ItemExplanation
    Helm chart typeSelect the type of Helm chart to add.
    Tenant/Project GroupSelect the tenant/project group to add the Helm chart
    • When selecting a tenant, you can use the registered chart only in projects of the selected tenant.
    • When selecting a project group, you can use the registered chart only in projects of the selected project group.
    Allow new installationSelect whether to allow a new installation via Helm install.
    Table. Helm Chart Basic Information Settings
  6. After selecting Helm chart repository and Helm chart, click the Validation Check button.
  7. After entering the remaining information, click the Next button.
    repository
    Item
    Explanation
    ChartMuseumHelm chart repositorySelect the chart repository as ChartMuseum.
    Select chartSelect the chart you want to register as a Helm chart among the charts registered via 차트 업로드하기.
    Harbor OCIHelm chart repositorySelect the chart repository as Harbor OCI.
    Authentication informationEnter the chart repository credentials and click the Connection Test button.
    Chart selectionSelect a Helm chart that can be queried with the entered credentials and click the Validation Check button.
    OCIHelm chart repositorySelect the chart repository as OCI.
    Authentication informationEnter the chart repository credentials and click the Connection Test button.
    Chart inputEnter the Helm chart that can be queried using the authentication information entered in Authentication Information, and click the Validation Check button.
    (ex. oci://chart.url/repo/chartname:version)
    commoniconSelect an icon to represent the Helm chart.
    CI/CD informationSelect whether to support CI/CD functionality
    • Indicates whether it is linked with the App template.
    • The chart’s Values.yaml file must contain the keys image.repository, image.tag, and imagePullSecrest[0].name.
    • Support CI/CDWhen selected, a CI/CD information step is added.
    Chart imageSelect whether to register an image
    • The chart’s Values.yaml file must contain the key imagePullSecrets[0].name.
    • No image If selected, the image secret information step will be omitted.
    Table. Chart Repository Configuration Items
  8. After selecting the image repository and entering the authentication information, click the Connection Test button.
  9. After entering the remaining information, click the Next button.
    ItemExplanation
    Image repository informationSelect an image repository and enter the authentication information.
    • The image repository requires administrator privileges.
    • Grant read access to the image repository for users who want to perform a Helm install using a Helm chart.
    • Assign permissions to the image repository using the entered authentication information.
    Add used imagesAdd the image path of the selected image repository.
    • Select an image from the list: choose Organization, Repository, and Tag to add.
    • User input: directly enter the image’s docker repository and docker tag to add.
    • Multiple entries are allowed.
    Use the registrant’s authentication credentialsThis is an option that can be selected when the image repository chosen in the image registry is a tool that cannot grant permissions (e.g., SCR).
    • If not checked, when the Helm chart user performs an installation, the Pull permission for the image used by the Helm chart user is added. If the tool cannot grant permissions, no permission granting is performed.
    • If not checked, when the Helm chart user performs an installation, the Helm chart registrant’s credentials are used instead of the Helm chart user’s permissions.
    Cautions when checked
    • Since the registrant’s credentials may be exposed to the Helm chart user, it should be used only when necessary.
    • If the image repository provides only image Pull, it must be selected to avoid issues during use. You must enter an image repository that will be used exclusively for Pull. (When checked, Pull and Push cannot be performed simultaneously on a single image repository.)
    • The registrant’s credentials are used in Project > Image Repository > Pull-only images and the Helm release’s ImagePull Secret. These credentials cannot be changed by Helm chart users, and if the registrant’s credentials are changed in the Helm chart, they are updated globally.
    Select Docker base imageSelect the image to be used as the Docker base image
    • Only select this if you chose Support CI/CD in the previous step, and it will be used as the base image for Docker build.
    Table. Image secret information configuration items
  10. App to support. After selecting a template, click the Done button.
Reference
App marked as Environment Only. The template provides only the build/deployment environment without project sample source code.

Modify Helm chart

To modify the Helm chart, follow these steps.

  1. Main page, click the Admin icon at the top right. Admin page opens.
  2. Click the Tools & Templates > Helm Chart menu in the left menu.
  3. Click the Helm chart card you want to edit from the Helm chart list. The Helm chart details page opens.
  4. Click the Edit button at the bottom right.
  5. After editing the information, click the Save button to complete the edit.

Add Helm chart version

To add a Helm chart version, the same chart with only a different version must already be registered via Upload Chart.

To add a version to the Helm chart, follow these steps.

  1. Main page, click the Admin icon at the top right. The Admin page opens.
  2. In the left menu, click the Tools & Templates > Helm Chart menu.
  3. Click the Helm chart card you want to edit from the Helm chart list. The Helm chart details page opens.
  4. Click the Add Version button at the bottom right. The Add Helm Chart Version popup window opens.
  5. After entering the information, click the Save button to complete adding the version.
    ItemExplanation
    Chart versionSelect the chart version to add
    • Shows the versions of charts in the chart repository that are not registered as Helm charts.
    Table. Additional Helm Chart Version Settings

Delete Helm chart

To delete a Helm chart, follow these steps.

  1. Main page, click the Admin icon at the top right. The Admin page opens.
  2. From the left menu, click the Tools & Templates > Helm Chart menu. The Helm Chart page opens.
  3. Click the Helm chart card you want to delete from the Helm chart list. The Helm chart details page opens.
  4. Click the Delete button at the bottom right.
  5. In the confirmation popup, click the Confirm button to complete the deletion.
Chart Repository
Creating Helm Charts with Form Input Support