DEV Community: Cynthia Vázquez

Guía completa: Cómo instalé Jenkins X en un clúster K3s

Cynthia Vázquez — Wed, 10 Dec 2025 21:22:57 +0000

¿Por qué escribí este manual?

¿Recuerdan mi primer post? Bueno, pues parece que soy experta en encontrar errores poco comunes.

Así que me tocó hacerlo “a la antigua” :D
probar, fallar, romper, investigar, reparar, probar otra vez.

Y como me costó bastante, decidí documentarlo todo para que no tengan que sufrir lo mismo 💛✨

¿Qué encontrarás en este post?

Cómo instalar Jenkins X en un clúster K3s
Cómo configurar las variables de entorno para GitHub
Cómo instalar el CLI en Linux o macOS
Cómo resolver errores como:
- ingress-nginx Pending
- Pods de webhook bloqueados
Cómo acceder al dashboard y configurar credenciales
Comandos útiles para diagnóstico y limpieza

📄 También puedes descargar mi manual completo en PDF aquí 👉 Manual de Instalacion Jenkins X

Requisitos previos

Clúster K3s funcionando (1 master + 2 workers mínimo)
kubectl funcionando
4GB de RAM libres
20GB de disco disponible
Cuenta de GitHub
Un token de GitHub con permisos:
- repo
- admin:repo_hook
- admin:org_hook (si usas organización)

Instalar el CLI de Jenkins X

En Linux

curl -L https://github.com/jenkins-x/jx/releases/latest/download/jx-linux-amd64.tar.gz | tar xzv
sudo mv jx /usr/local/bin/
jx version

En Mac

brew install jenkins-x/jx/jx
jx version

Configurar variables de entorno (GitHub)

export GIT_USERNAME="tu_usuario"
export GIT_TOKEN="token"
export GIT_SERVER="https://github.com"
export GIT_KIND="github"
export GIT_ORGANISATION="tu_organizacion"

Instalación de Jenkins X en el clúster

Instalación básica

jx install --provider=kubernetes

Con dominio personalizado

jx install --provider=kubernetes --domain=tu-dominio.com

Sin dominio (desarrollo)

jx install --provider=kubernetes \
  --ingress-service=LoadBalancer \
  --no-default-environments=false

Monitorea:

kubectl get pods -n jx

Errores comunes y cómo los solucioné

1. Pod ingress-nginx en estado Pending

Causa común: El cluster no tiene LoadBalancer real (K3s carece de uno).
Solución: usar Traefik, que viene por defecto con K3s.

kubectl get pods -n kube-system | grep traefik

2. Pods de webhook o controllers bloqueados

Solución:

kubectl get pods -n jx | grep -E 'webhook|controller'
kubectl delete pod <nombre> -n jx
watch kubectl get pods -n jx

Los pods se recrearán solos ✨

Acceso al dashboard

Obtener URL:

jx get urls -n jx

Si no tienes dominio:

kubectl port-forward -n jx svc/jx-pipelines-visualizer 8080:80

Abrir:
👉 http://localhost:8080

Probar que Jenkins X funciona

Crear un quickstart:

jx create quickstart

Ver actividad:

jx get activity -w
jx get build logs

Reflexión final

Y recuerda si estás aprendiendo, documenta todo.
Tu “error raro del día” podría ser la solución que alguien más necesita mañana 💡

Recursos útiles

Documentación oficial de Jenkins X
Troubleshooting FAQ
Mi guía

Cómo logré montar mi primer clúster K3s (sin morir en el intento)

Cynthia Vázquez — Thu, 23 Oct 2025 17:59:42 +0000

Una guía práctica basada en errores reales para montar un clúster K3s en Ubuntu 22.04.
Si alguna vez quisiste instalar un clúster Kubernetes ligero en Ubuntu y terminaste con errores que ni Google conocía... este post es para ti :D

¿Por qué escribí esta guía?

Hace poco comencé a trabajar con servidores durante mis prácticas profresionales.
Tenía que montar un clúster Kubernetes, pero me encontré con un gran problema:

-> La mayoría de guías eran muy básicas o estaban incompletas.

-> Los errores que me salían eran tan específicos que ni StackOverflow los tenía.

-> Y bueno… entender documentación técnica en inglés no es mi fuerte :c

Así que decidí anotar cada error, comando y solución que encontraba.

Un amigo me dijo: “¿Por qué no lo subes a Dev.to? Seguro ayudas a más gente”

Y bueno, aquí estamos 💻💙

Qué encontrarás en este post

Cómo instalar K3s en Ubuntu 22.04
Cómo conectar 1 master y 2 nodos workers
Configuración de firewall, SSH y transferencia de archivos
Solución a errores raros como el port 6444 already in use
Un resumen rápido de comandos útiles

📄 Puedes descargar la guía completa en PDF aquí 👉 K3s Installation Manual

Requisitos previos

3 servidores con Ubuntu 22.04
Conectividad entre todos los nodos
Acceso sudo
Paciencia (y café, mucho café)

Instalación del nodo master

curl -sfL https://get.k3s.io | sh -
sudo systemctl status k3s
sudo kubectl get nodes

Si todo va bien, deberías ver tu nodo master con estado “Ready”.

Para usar kubectl sin sudo, recomiendo crear un grupo k8s-admins y reinstalar K3s con permisos correctos (lo explico a detalle en el PDF)

Añadiendo los worker nodes

En cada worker node ejecuta:

curl -sfL https://get.k3s.io | \
K3S_URL=https://MASTER_IP:6443 \
K3S_TOKEN=YOUR_TOKEN_HERE sh -

Luego, desde el master:

kubectl get nodes

¡Y listo! Si todo aparece como “Ready”, tienes tu primer clúster K3s funcionando

Solución de errores comunes

El worker no aparece en el clúster

Revisa los logs:

sudo journalctl -u k3s-agent.service --no-pager

Si aparece address already in use, significa que el puerto 6444 está ocupado.

sudo lsof -i :6444
sudo kill -9 <PID>

Y si eso no basta, la guía incluye pasos para reinstalar desde cero sin romper todo.

Configuración de firewall

En el master:

sudo ufw allow 6443/tcp
sudo ufw allow 10250/tcp
sudo ufw allow 8472/udp
sudo ufw allow 2379:2380/tcp
sudo ufw allow 22/tcp
sudo ufw enable

⚠️ No cierres el puerto 22 o perderás acceso SSH. (Lo aprendí a la mala 💀)

Administración de contenedores

kubectl get pods -A
sudo k3s crictl ps

Usa kubectl para ver el clúster y crictl para depurar contenedores.

Reflexión final

Documentar mis errores me enseñó más que seguir tutoriales paso a paso.
Cada fallo que resolvía me ayudaba a entender realmente cómo funciona Kubernetes.

Si estás aprendiendo DevOps: documenta todo.
Tu “error raro del día” podría ser la solución que alguien más necesita mañana 💡