Despliegue de la Toolchain de Kubernetes
Este procedimiento describe la instalación de los binarios fundamentales en todos los nodos del clúster. Para garantizar la consistencia, utilizamos el script de provisión alojado en la raíz del repositorio.
1. Sincronización de Repositorios Oficiales
Utilizamos la arquitectura de Single Source of Truth importando el script de setup:
scripts/setup/k8s-repo-setup.sh
#!/bin/bash
# Protocolo de provisión de Repositorios Oficiales de Kubernetes (v1.35)
set -e
K8S_VERSION="v1.35"
echo "==> Configurando Repositorio de Kubernetes $K8S_VERSION..."
sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates curl gpg
sudo mkdir -p -m 755 /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/$K8S_VERSION/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/$K8S_VERSION/deb/ /" | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
echo "==> Repositorios sincronizados correctamente."
2. Provisión de Herramientas Core
Instalamos los tres componentes base y aplicamos una política de Versioning Pinning para evitar actualizaciones no controladas que puedan comprometer la disponibilidad del clúster.
Instalación y Bloqueo de Versión
sudo apt install -y kubelet kubeadm kubectl
# Prevención de actualizaciones accidentales vía apt upgrade
sudo apt-mark hold kubelet kubeadm kubectl
3. Matriz de Componentes
| Herramienta | Función Arquitectónica | Modo de Operación |
|---|---|---|
| kubeadm | Orquestador de Bootstrap | CLI Temporal |
| kubelet | Agente de Nodo (Cerebro local) | Daemon (Systemd) |
| kubectl | Interfaz de API Management | Usuario Final / CI/CD |
Verificación de Salud
Tras la instalación, valide que el servicio kubelet esté en estado active (running) o en bucle de reinicio (esperando el kubeadm init), pero nunca en estado masked o disabled.
Documentación Relacionada: