Managed Azure Kubernetes Service
ArgoCD UI
Quickly expose the Argo CD server UI in your Kubernetes cluster and authenticate using the initial admin account.
On this page
Overview
This guide explains how to quickly expose the Argo CD server UI in your Kubernetes cluster and authenticate using the initial admin account.
Expose argocd-server service
Change Argo CD Service Type
Edit the Argo CD server service to change its type to LoadBalancer:
kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "LoadBalancer"}}'Retrieve the External IP
Once the service is exposed, get the external IP:
kubectl get svc argocd-server -n argocd -o=jsonpath='{.status.loadBalancer.ingress[0].ip}'The external IP needs to be generated and it can take a couple of seconds before its visible.
Access Argo CD UI
Copy and paste the external IP to access the Argo CD UI through a web browser.
The ArgoCD UI will not be secured with a certificate using this approach. You will get a warning stating Your connection is not private. You can ignore this and proceed by clicking Advanced and Proceed to IP (unsafe).
Use the automatically installed ingress-nginx controller in your cluster to issue an ingress resource for your ArgoCD UI and remove this warning.
Retrieve Initial Admin Password
Get the initial admin password from the argocd-initial-admin-secret in the Argo CD namespace:
kubectl get secret argocd-initial-admin-secret -n argocd -o jsonpath="{.data.password}" | base64 -d$decodedPassword = kubectl get secret argocd-initial-admin-secret -n argocd -o jsonpath='{.data.password}' | ForEach-Object { [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($_)) }
Write-Output "Decoded Password: $decodedPassword"Log In
Use the username admin and the retrieved password to log in to the Argo CD UI.
Conclusion
You can now access and manage your Argo CD deployments through the UI with the initial admin credentials.
Next step
If your Github repository is public, you can skip directly to deploying your workloads.
5.1 Use Ingress
Overview
This small guide will show you how to use ArgoCD itself to create the ingress resources required to issue certificates for the argocd-server and securely handle tls for your UI. The ingress resource for the UI will be controlled by the ArgoCD application.
Deploy ingress using ArgoCD
Prerequisites:
- Your own domain
- AAA Record pointing to Ingress IP
You can fetch your Ingress IP by running the following command in your terminal:
kubectl get svc ingress-nginx-controller -n ingress-nginx -o=jsonpath='{.status.loadBalancer.ingress[0].ip}'Manifests
Push the following files (with your own values) to your github repository.
Ingress setup manifests:
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt-prod
spec:
acme:
server: https://acme-v02.api.letsencrypt.org/directory
email: <your-email>
privateKeySecretRef:
name: letsencrypt-prod
solvers:
- http01:
ingress:
class: nginx
podTemplate:
metadata:
labels:
podtype: acme-solver
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: argocd-server-ingress
namespace: argocd
annotations:
cert-manager.io/cluster-issuer: letsencrypt-prod
nginx.ingress.kubernetes.io/ssl-passthrough: "true"
kubernetes.io/tls-acme: "true"
spec:
ingressClassName: nginx
rules:
- host: argo.yourdomain.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: argocd-server
port:
name: https
tls:
- hosts:
- argo.yourdomain.com
secretName: argocd-server-tls # Dont change thisUse ArgoCD to deploy its own ingress as application
Apply the following ArgoCD application manifest to deploy your ingress resources.
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: argocd-ingress
namespace: argocd
spec:
project: default
source:
repoURL: https://github.com/your-github-username/your-repo-name.git # change this to your repostiroy url
path: path/to/your/kubernetes/manifests # change this to the location of your ingress manifests that you pushed to git earlier
targetRevision: HEAD
destination:
server: https://kubernetes.default.svc
namespace: argocd
syncPolicy:
automated:
prune: false
selfHeal: true
syncOptions:
- CreateNamespace=truePropagation can take some time depending on your DNS provider. Because of this, the UI might not be available directly after applying these manifests. Give it a couple of minutes.
- Check your ArgoCD UI in the browser by going to
argo.yourdomain.com. - You can also verify the status of your ArgoCD Ingress application by running the following command:
kubectl get applications --namespace argocdConclusion
- You have successfully exposed the ArgoCD UI with a Kubernetes Ingress resource, using Ingress NGINX, Cert-manager and Lets Encrypt.