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, la gestión y el gobierno de clústeres Kubernetes. A diferencia de una distribución de Kubernetes que sustituye al propio Kubernetes, Rancher actúa como una solución de gestión que se sitúa por encima de uno o más clusters de Kubernetes, proporcionando una plataforma centralizada desde la que los administradores pueden supervisar toda su infraestructura de contenedores.

En este tutorial, aprenderás a instalar Rancher en un servidor Debian 12. Instalarás Rancher como nodo único mediante Docker, que también despliega el nodo único de Kubernetes sobre él.

Requisitos previos

Para empezar con esta guía, asegúrate de que tienes lo siguiente:

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

Instalación de Docker

Antes de instalar Rancher, debes 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.

En primer lugar, 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 añadir la clave GPG para el repositorio 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 añadir el repositorio 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 añadido el repositorio Docker y la clave GPG, ejecuta el comando siguiente para actualizar 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

Introduce «Y» para proceder a la instalación.

Una vez finalizada la instalación, comprueba el estado del servicio Docker utilizando el comando ‘systemctl’ que aparece a continuación. Verás que Docker se está ejecutando y está habilitado en tu máquina Debian.

sudo systemctl is-enabled docker
sudo systemctl status docker

Por último, puedes ejecutar el siguiente comando «docker» para ejecutar el contenedor «hello-word».

sudo docker run hello-world

Si se ejecuta correctamente, obtendrás el siguiente mensaje«Hola Mundo» de Docker.

Instalar Rancher

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

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

sudo docker pull rancher/rancher:latest

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

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

Comprueba el estado del contenedor utilizando el siguiente comando.

sudo docker ps

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

Además, si tienes algún error, puedes comprobar 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 se están ejecutando y los que han salido, y el comando ‘docker log’ se utiliza para comprobar los registros del contenedor.

Configurar Rancher

Llegados a este punto, Rancher se está ejecutando en tu sistema Debian como un contenedor. En el siguiente paso, accederás al panel de control de Rancher para ver el nodo único de Kubernetes que se ejecuta 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 la instalación se realiza correctamente, obtendrás la siguiente página de inicio de sesión de Rancher.

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

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

Ahora introduce 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 Rancher. En el ejemplo siguiente, puedes ver el clúster Kubernetes de nodo único creado con K3s.

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

Acceder al clúster Kubernetes con kubectl

En primer lugar, descarga el KubeConfig en tu ordenador local. Desde el panel de control de Rancher, haz clic en el menú de archivos que aparece a continuación.

Instala «kubectl» en tu sistema con el comando que aparece a continuación. En Debian 12, puedes instalar el paquete‘kubernetes-client‘ mediante APT.

sudo apt install kubernetes-client -y

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

export KUBECONFIG=~/kubeconfig.yaml

Por último, ejecuta el siguiente comando ‘kubectl’ para obtener una lista de pods en todos los espacios de nombres de Kubernetes.

kubectl get pods --all-namespaces

Verás que cada pod del clúster de Kubernetes bajo Rancher se está ejecutando.

Conclusión

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