Installing Argo CD

Argo CD is a declarative GitOps tool for continuous delivery to Kubernetes.

Getting startedGetting started

1. If you do not have the Yandex Cloud CLI yet, install and initialize it.

   The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

2. Make sure that the security groups for the Managed Service for Kubernetes cluster and its node groups are configured correctly. If any rule is missing, add it.

   Warning

   The configuration of security groups determines the performance and availability of the cluster and the services and applications running in it.

3. Install kubect and configure it to work with the new cluster.

Installation using Yandex Cloud MarketplaceInstallation using Yandex Cloud Marketplace

1. Navigate to the folder dashboard and select Managed Service for Kubernetes.
2. Click the name of the cluster you need and select the Marketplace tab.
3. Under Application available for installation, select Argo CD and click Go to install.
4. Configure the application:
   • Namespace: Create a new namespace, e.g., argo-cd-space. If you leave the default namespace, Argo CD may work incorrectly.
   • Application name: Specify the application name.
5. Click Install.
6. Wait for the application to change its status to Deployed.

Installation using a Helm chartInstallation using a Helm chart

1. Install Helm v3.8.0 or higher.

2. To install a Helm chart with Argo CD, run the following command:

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/argo/chart/argo-cd \
     --version 7.3.11-2 \
     --untar && \
   helm install \
     --namespace <namespace> \
     --create-namespace \
     argo-cd ./argo-cd/
   

   Note

   If you are using a Helm version below 3.8.0, append the export HELM_EXPERIMENTAL_OCI=1 && \ string to the command to enable Open Container Initiative (OCI) support in the Helm client.

   If you set namespace to the default namespace, Argo CD may work incorrectly. We recommend you to specify a value different from all existing namespaces (e.g., argo-cd-space).

Access to the applicationAccess to the application

You can open Argo CD via localhost or dedicated IP address. The first method is easier to configure and does not require additional network load balancer costs. The second method allows you to get permanent access to Argo CD. The application is available through localhost only for as long as port redirection is active.

Before you set up access to Argo CD, get the administrator password (admin):

kubectl --namespace <namespace> get secret argocd-initial-admin-secret \
  --output jsonpath="{.data.password}" | base64 -d

You will need the password for authorization in Argo CD.

Opening the application via localhostOpening the application via localhost

1. Configure Argo CD port redirection to your local computer:

   kubectl port-forward service/<app_name>-argocd-server \
     --namespace <namespace> 8080:443
   

   In the command, specify the application name you had set during installation.

2. Follow the https://localhost:8080 link and log in with administrator credentials.

Opening the application via a dedicated IP addressOpening the application via a dedicated IP address

1. Save the following specification for creating a LoadBalancer type service to a file named load-balancer.yaml. This will create you a Yandex Network Load Balancer:

   apiVersion: v1
   kind: Service
   metadata:
     name: argocd-load-balancer
     namespace: <namespace>
   spec:
     type: LoadBalancer
     ports:
     - port: 443
       name: load-balancer-port-ssl
       targetPort: 8080
     # Selector Kubernetes label used in the Deployment object named <application_name>-argocd-server.
     selector:
       app.kubernetes.io/name: argocd-server
   

   In the specification, specify the namespace you installed Argo CD in.

   The specification giving no IP address, the load balancer will get a dynamic public IP address. You can add a field named spec.loadBalancerIP and specify a pre-reserved static IP address in it.

   For details on the specification, see this service reference.

2. Apply the specification and create a network load balancer:

   kubectl apply -f load-balancer.yaml --namespace <namespace>
   

3. Get the IP address of the load balancer you created:

   Management console

   1. In the management console, select the folder the Managed Service for Kubernetes cluster is deployed in.

   2. Select Network Load Balancer.

      The Load balancers section shows a network load balancer with the k8s prefix in its name and the unique Kubernetes cluster ID in its description.

   3. Copy the IP address field value for the load balancer of interest.

4. Follow the https://<load_balancer_IP_address> link and log in with administrator credentials.

Use casesUse cases

• Integration with Argo CD

See alsoSee also

• Argo CD documentation.