Come installare Rancher su un server Debian 12

Rancher è una piattaforma di gestione dei container open-source progettata per facilitare il deployment, la gestione e la governance dei cluster Kubernetes. A differenza di una distribuzione Kubernetes che sostituisce Kubernetes stesso, Rancher funge da soluzione di gestione che si trova sopra uno o più cluster Kubernetes, fornendo una piattaforma centralizzata da cui gli amministratori possono supervisionare l’intera infrastruttura dei container.

In questo tutorial, imparerai come installare Rancher su un server Debian 12. Installerai Rancher come un singolo nodo tramite Docker, che distribuisce anche il nodo singolo di Kubernetes sopra di esso.

Prerequisiti

Per iniziare con questa guida, assicurati di avere i seguenti requisiti:

• Un server Debian 12 con un minimo di 4GB di RAM o memoria
• Un utente non root con privilegi di amministratore

Installazione di Docker

Prima di installare Rancher, devi assicurarti che Docker sia installato sul tuo sistema. In questa sezione, installerai Docker Engine tramite il repository ufficiale di Docker sul sistema Debian.

Per prima cosa, esegui il comando qui sotto per aggiornare l’indice dei pacchetti e installare pacchetti come ‘ca-certificates’ e ‘curl’.

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

Ora esegui il seguente comando per aggiungere la chiave GPG per il repository 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

Successivamente, esegui il seguente comando per aggiungere il repository Docker al tuo sistema Debian. Questo rileverà automaticamente la tua versione di 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

Ora che hai aggiunto il repository Docker e la chiave GPG, esegui il comando qui sotto per aggiornare l’indice dei pacchetti e installare Docker Engine sul tuo sistema. In questo esempio, installerai Docker Engine con pacchetti aggiuntivi come Docker Compose e il plugin Docker Buildx.

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

Inserisci ‘Y’ per procedere con l’installazione.

Una volta completata l’installazione, controlla lo stato del servizio Docker utilizzando il comando ‘systemctl’ qui sotto. Vedrai che Docker è in esecuzione e abilitato sulla tua macchina Debian.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Infine, puoi eseguire il comando ‘docker’ qui sotto per eseguire il container ‘hello-word’.

sudo docker run hello-world

Se tutto va a buon fine, riceverai il seguente messaggio ‘Hello World‘ da Docker.

Installazione di Rancher

Ora che Docker è installato, sei pronto per installare Rancher. In questa sezione, scaricherai l’immagine di Rancher e poi eseguirai il container di Rancher tramite Docker. In questo esempio, utilizzeremo i certificati auto-firmati che vengono generati automaticamente dal container di Rancher. Utilizzeremo anche l’ultima versione dell’immagine di Rancher.

Scarica l’immagine di Rancher utilizzando il comando ‘docker pull’ qui sotto. In questo esempio, utilizzeremo l’ultima versione di Rancher.

sudo docker pull rancher/rancher:latest

Una volta scaricata l’immagine di Rancher, esegui il comando ‘docker run’ per eseguire Rancher. Con questo, il container di Rancher sarà in esecuzione in background ed esporrà le porte 80 e 443 nel server Debian host.

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

Controlla lo stato del container utilizzando il comando qui sotto.

sudo docker ps

Nell’output qui sotto, puoi vedere che Rancher è in esecuzione sulla porta 443. Inoltre, puoi vedere l’ID del container e i nomi del container.

In aggiunta, se hai un errore, puoi controllare il log di Rancher con il seguente comando ‘docker’.

docker ps -a  
docker log nome-container o id-container

L’opzione ‘ps -a’ ti mostrerà i container che sono in esecuzione e quelli usciti, e il comando ‘docker log’ viene utilizzato per controllare i log del container.

Configurazione di Rancher

A questo punto, Rancher è in esecuzione sul tuo sistema Debian come un container. Per il passo successivo, accederai al dashboard di Rancher per vedere il nodo singolo di Kubernetes che è in esecuzione sopra la tua installazione di Rancher.

Apri il browser web e visita l’indirizzo IP del tuo server Debian seguito dalla porta 8080 come https://192.168.10.41:8080/. Se la tua installazione è andata a buon fine, vedrai la seguente pagina di accesso di Rancher.

Torna al tuo terminale ed esegui il comando qui sotto per ottenere la password di Rancher. Assicurati di sostituire l’ID del container con la tua installazione e copia la tua password.

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

Ora inserisci la tua password e clicca su Login with Local User.

Successivamente, copia la password generata per il tuo Rancher e assicurati di accettare i termini e la licenza.

Ora vedrai il seguente Dashboard di Rancher. Nell’esempio qui sotto, puoi vedere il cluster Kubernetes a nodo singolo creato con K3s.

Clicca sul cluster Kubernetes locale e otterrai maggiori informazioni sul tuo cluster Kubernetes.

Accesso al cluster Kubernetes con kubectl

Per prima cosa, scarica il KubeConfig sul tuo computer locale. Dalla dashboard di Rancher, clicca sul menu file qui sotto.

Installa ‘kubectl’ sul tuo sistema con il comando qui sotto. Su Debian 12, puoi installare il pacchetto ‘kubernetes-client‘ tramite APT.

sudo apt install kubernetes-client -y

Imposta il KUBECONFIG predefinito sul tuo file. In questo esempio, il file KubeConfig è ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Infine, esegui il comando ‘kubectl’ qui sotto per ottenere l’elenco dei pod in tutti i namespace di Kubernetes.

kubectl get pods --all-namespaces

Vedrai che ogni pod per il cluster Kubernetes sotto Rancher è in esecuzione.

Conclusione

Congratulazioni! Hai completato l’installazione di Rancher con Docker sul server Debian 12. Hai imparato come configurare Rancher e creare un cluster Kubernetes sopra di esso. Infine, hai anche imparato come interagire con il tuo cluster Kubernetes tramite il client Kubernetes ‘kubectl’. Inoltre, puoi distribuire le tue applicazioni containerizzate nel cluster Kubernetes tramite ‘kubectl’.