Container Service for Kubernetes:Use ACK One GitOps to deploy Container Registry Enterprise Edition OCI Helm charts

Prerequisites

Before you begin, ensure that you have:

• Fleet management enabled. See Enable Fleet management.

• The kubeconfig file of your Fleet instance downloaded from the ACK One console, with kubectl connected to the Fleet instance.

• The latest Argo CD CLI installed. See Argo CD releases.

• A Container Registry Enterprise Edition instance created.

Step 1: Push the Helm chart to ACR EE

Package your Helm chart and push it to your ACR EE instance. This topic uses the echo-server chart at version 0.1.1 as an example. In this example, the tar command is used to create the package. We recommend that you use the helm package command. For detailed steps, see Push and pull Helm charts.

Step 2: Add an OCI repository

Run the following command to register your ACR EE instance as an OCI Helm repository in Argo CD:

argocd repo add <registry-domain> --type helm --name <repo-name> --enable-oci --username <username> --password <password>

Example:

argocd repo add demo***-registry.cn-hangzhou.cr.aliyuncs.com --type helm --name acr-oci --enable-oci --username ack***@test.aliyunid.com --password <password>

Replace the placeholders with your actual values:

Step 3: Deploy the application

1. Create a file named app-helm-dev-oci.yaml with the following content:

   apiVersion: argoproj.io/v1alpha1
   kind: Application
   metadata:
     name: app-helm-dev-oci
   spec:
     # Deployment target: the cluster and namespace to deploy into
     destination:
       namespace: app-helm-dev-oci
       server: <apiserver-url>                              # Example: https://XX.XX.XX.XX:6443
     # Chart source: the OCI repository, chart name, and version
     source:
       repoURL: <registry-domain>/<namespace>              # Example: demo***-registry.cn-hangzhou.cr.aliyuncs.com/test
       chart: <my-chart-name>                              # Example: echo-server
       targetRevision: <my-chart-version>                  # Example: 0.1.1
       helm:
         passCredentials: true
         valueFiles:
           - values-dev.yaml                               # Defaults to values.yaml if not specified
     project: default
     # Sync policy: automatically sync and create the namespace if it does not exist
     syncPolicy:
       automated: {}
       syncOptions:
         - CreateNamespace=true

   Replace the placeholders with your actual values:

   Placeholder	Description	Example
   <apiserver-url>	API server URL of the target cluster	https://XX.XX.XX.XX:6443
   <registry-domain>/<namespace>	Registry domain and namespace	demo***-registry.cn-hangzhou.cr.aliyuncs.com/test
   <my-chart-name>	Helm chart name	echo-server
   <my-chart-version>	Chart version to deploy	0.1.1

2. Create the application:

   argocd app create -f app-helm-dev-oci.yaml

   Argo CD syncs the application automatically based on the automated sync policy and creates the app-helm-dev-oci namespace if it does not exist.