An example Ksonnet guestbook application is provided to demonstrates how Argo CD works.
- Installed minikube
- Installed the kubectl command-line tool
- Have a kubeconfig file (default location is
~/.kube/config).
Download the latest Argo CD version from the releases page.
$ argocd install
This will create a new namespace, argocd, where Argo CD services and application resources will live.
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.
- Register the minikube cluster to Argo CD:
$ 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 sync guestbook
The application status is initially in an OutOfSync state, since the application has yet to be
deployed, and no Kubernetes resouces 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
