Argo CD Getting Started

An example Ksonnet guestbook application is provided to demonstrates how Argo CD works.

Requirements

Installed minikube
Installed the kubectl command-line tool
Have a kubeconfig file (default location is ~/.kube/config).

1. Download Argo CD

Download the latest Argo CD version

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/download/v0.3.0/argocd-darwin-amd64
chmod +x /usr/local/bin/argocd

2. Install Argo CD

argocd install

This will create a new namespace, argocd, where Argo CD services and application resources will live.

3. Open access to Argo CD API server

By default, the Argo CD API server is not exposed with an external IP. To expose the API server, change service type to LoadBalancer:

kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "LoadBalancer"}}'

argocd login $(minikube service argocd-server -n argocd --url | cut -d'/' -f 3)

Now, the Argo CD cli is configured to talk to API server and you can deploy your first application.

5. Connect and deploy the Guestbook application

argocd cluster add minikube

The argocd cluster add CONTEXT command installs an argocd-manager ServiceAccount and ClusterRole into the cluster associated with the supplied kubectl context. Argo CD then uses the associated service account token to perform its required management tasks (i.e. deploy/monitoring).

Add the guestbook application and github repository containing the Guestbook application

argocd app create --name guestbook --repo https://github.com/argoproj/argo-cd.git --path examples/guestbook --env minikube --dest-server https://$(minikube ip):8443

Once the application is added, you can now see its status:

argocd app list
argocd app get guestbook

The application status is initially in an OutOfSync state, since the application has yet to be deployed, and no Kubernetes resources have been created. To sync (deploy) the application, run:

argocd app sync guestbook

Argo CD also allows to view and manager applications using web UI. Get the web UI URL by running:

minikube service argocd-server -n argocd --url

2.6 KiB Raw Blame History