Esta guía instala Argo CD en un clúster y te deja con la sesión iniciada en la interfaz web. Necesitas kubectl configurado para un clúster con el que puedas experimentar libremente. Un clúster local con kind o minikube es ideal.

Crea un namespace y aplica el manifiesto de instalación

Argo CD se ejecuta en su propio namespace. Créalo y luego aplica el manifiesto de instalación oficial:

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts \
  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

Las versiones recientes de Argo CD recomiendan server-side apply porque algunos de los CRD incluidos son demasiado grandes para el límite de anotaciones de client-side apply. Consulta la página Getting Started para ver el comando exacto de la versión que instales. Si prefieres revisar lo que vas a ejecutar, descarga primero el manifiesto y léelo.

Espera a que los componentes se levanten

kubectl get pods -n argocd
kubectl wait --for=condition=Ready pods --all -n argocd --timeout=300s

Deberías ver el controlador de aplicaciones, el repo server, el servidor de la API, Redis y algunos controladores de apoyo. Algunos Pods tardan un minuto en estar listos, así que es normal ver ContainerCreating al principio.

Accede a la interfaz web

El servidor de la API se expone mediante un servicio ClusterIP llamado argocd-server. En un clúster local, haz un port-forward:

kubectl port-forward svc/argocd-server -n argocd 8080:443

Abre https://localhost:8080. Tu navegador mostrará una advertencia por el certificado, ya que Argo CD genera uno autofirmado por defecto. Acepta la advertencia para esta configuración local.

Obtén la contraseña inicial de admin e inicia sesión

El usuario es admin. La contraseña inicial se genera durante la instalación y se guarda en un Secret:

kubectl -n argocd get secret argocd-initial-admin-secret \
  -o jsonpath="{.data.password}" | base64 -d; echo

Pégala en el formulario de inicio de sesión. La interfaz estará vacía porque aún no hay aplicaciones registradas. Eso es lo que sigue en la próxima guía.

Antes de llevar esto más allá de un experimento local, haz dos cosas: cambia la contraseña de admin y elimina el Secret con la contraseña inicial, y expón Argo CD mediante un Ingress o LoadBalancer con un certificado TLS real en lugar de depender del port-forwarding.