Cómo instalar Rancher en un servidor Debian 12

Rancher es una plataforma de gestión de contenedores de código abierto diseñada para facilitar el despliegue, gestión y gobernanza de clústeres de Kubernetes. A diferencia de una distribución de Kubernetes que reemplaza a Kubernetes mismo, Rancher actúa como una solución de gestión que se sitúa por encima de uno o más clústeres de Kubernetes, proporcionando una plataforma centralizada desde la cual los administradores pueden supervisar toda su infraestructura de contenedores.

En este tutorial, aprenderás cómo instalar Rancher en un servidor Debian 12. Instalarás Rancher como un solo nodo a través de Docker, que también despliega el nodo único de Kubernetes encima de él.

Prerrequisitos

Para comenzar con esta guía, asegúrate de tener lo siguiente:

• Un servidor Debian 12 con un mínimo de 4GB de RAM o memoria
• Un usuario no root con privilegios de administrador

Instalando Docker

Antes de instalar Rancher, necesitas asegurarte de que Docker esté instalado en tu sistema. En esta sección, instalarás Docker Engine a través del repositorio oficial de Docker en el sistema Debian.

Primero, ejecuta el siguiente comando para actualizar tu índice de paquetes e instalar paquetes como ‘ca-certificates’ y ‘curl’.

sudo apt update && sudo apt install ca-certificates curl -y

Ahora ejecuta el siguiente comando para agregar la clave GPG para el repositorio de Docker.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

A continuación, ejecuta el siguiente comando para agregar el repositorio de Docker a tu sistema Debian. Esto detectará automáticamente tu versión de Debian.

echo \  
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \  
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Ahora que has agregado el repositorio de Docker y la clave GPG, ejecuta el comando a continuación para refrescar tu índice de paquetes e instalar Docker Engine en tu sistema. En este ejemplo, instalarás Docker Engine con paquetes adicionales como Docker Compose y el plugin Docker Buildx.

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Ingresa ‘Y’ para continuar con la instalación.

Una vez que la instalación haya finalizado, verifica el estado del servicio Docker utilizando el comando ‘systemctl’ a continuación. Verás que Docker está en ejecución y habilitado en tu máquina Debian.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Por último, puedes ejecutar el comando ‘docker’ a continuación para ejecutar el contenedor ‘hello-word’.

sudo docker run hello-world

Si es exitoso, recibirás el siguiente mensaje ‘ Hello World ‘ de Docker.

Instalando Rancher

Ahora que Docker está instalado, estás listo para instalar Rancher. En esta sección, descargarás la imagen de Rancher y luego ejecutarás el contenedor de Rancher a través de Docker. En este ejemplo, utilizaremos los certificados autofirmados que son generados automáticamente por el contenedor de Rancher. También utilizaremos la última versión de la imagen de Rancher.

Descarga la imagen de Rancher utilizando el comando ‘docker pull’ a continuación. En este ejemplo, utilizaremos la última versión de Rancher.

sudo docker pull rancher/rancher:latest

Una vez que la imagen de Rancher esté descargada, ejecuta el comando ‘docker run’ para ejecutar Rancher. Con esto, el contenedor de Rancher se ejecutará en segundo plano y exportará los puertos 80 y 443 en el servidor Debian host.

sudo docker run -d --restart=unless-stopped \  
-p 80:80 -p 443:443 \  
--privileged \  
rancher/rancher:latest

Verifica el estado del contenedor utilizando el comando a continuación.

sudo docker ps

En la salida a continuación, puedes ver que Rancher se está ejecutando en el puerto 443. También puedes ver el ID del contenedor y los nombres del contenedor.

Además, si tienes un error, puedes verificar el registro de Rancher con el siguiente comando ‘docker’.

docker ps -a  
docker log container-name or container id

La opción ‘ps -a’ te mostrará los contenedores que están en ejecución y los que han salido, y el comando ‘docker log’ se utiliza para verificar los registros del contenedor.

Configurando Rancher

En este punto, Rancher se está ejecutando en tu sistema Debian como un contenedor. Para el siguiente paso, iniciarás sesión en el panel de control de Rancher para ver el nodo único de Kubernetes que se está ejecutando sobre tu instalación de Rancher.

Abre el navegador web y visita la dirección IP de tu servidor Debian seguida del puerto 8080 como https://192.168.10.41:8080/. Si tu instalación es exitosa, verás la siguiente página de inicio de sesión de Rancher.

Regresa a tu terminal y ejecuta el comando a continuación para obtener la contraseña de Rancher. Asegúrate de cambiar el ID del contenedor por tu instalación y copia tu contraseña.

sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"

Ahora ingresa tu contraseña y haz clic en Iniciar sesión con usuario local.

A continuación, copia la contraseña generada para tu Rancher y asegúrate de aceptar los términos y la licencia.

Ahora verás el siguiente panel de control de Rancher. En el ejemplo a continuación, puedes ver el clúster de Kubernetes de nodo único creado con K3s.

Haz clic en el clúster de Kubernetes local y obtendrás más información sobre tu clúster de Kubernetes.

Accediendo al clúster de Kubernetes con kubectl

Primero, descarga el KubeConfig a tu computadora local. Desde el panel de control de Rancher, haz clic en el menú de archivos a continuación.

Instala el ‘kubectl’ en tu sistema con el comando a continuación. En Debian 12, puedes instalar el paquete ‘ kubernetes-client ‘ a través de APT.

sudo apt install kubernetes-client -y

Establece el KUBECONFIG predeterminado a tu archivo. En este ejemplo, el archivo KubeConfig es ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Por último, ejecuta el comando ‘kubectl’ a continuación para obtener la lista de pods en todos los espacios de nombres de Kubernetes.

kubectl get pods --all-namespaces

Verás que cada pod para el clúster de Kubernetes bajo Rancher está en ejecución.

Conclusión

¡Felicidades! Has completado la instalación de Rancher con Docker en el servidor Debian 12. Has aprendido cómo configurar Rancher y crear un clúster de Kubernetes sobre él. Por último, también has aprendido cómo interactuar con tu clúster de Kubernetes a través del cliente de Kubernetes ‘kubectl’. Además, puedes desplegar tus aplicaciones en contenedores en el clúster de Kubernetes a través de ‘kubectl’.