Como Instalar o Rancher no Servidor Debian 12

Rancher é uma plataforma de gerenciamento de contêineres de código aberto projetada para facilitar a implantação, gerenciamento e governança de clusters Kubernetes. Ao contrário de uma distribuição Kubernetes que substitui o próprio Kubernetes, o Rancher atua como uma solução de gerenciamento que fica acima de um ou mais clusters Kubernetes, fornecendo uma plataforma centralizada a partir da qual os administradores podem supervisionar toda a sua infraestrutura de contêineres.

Neste tutorial, você aprenderá como instalar o Rancher em um servidor Debian 12. Você instalará o Rancher como um único nó via Docker, que também implanta o nó único do Kubernetes em cima dele.

Pré-requisitos

Para começar este guia, certifique-se de ter o seguinte:

• Um servidor Debian 12 com um mínimo de 4GB de RAM ou memória
• Um usuário não-root com privilégios de administrador

Instalando o Docker

Antes de instalar o Rancher, você precisa garantir que o Docker esteja instalado em seu sistema. Nesta seção, você instalará o Docker Engine via o repositório oficial do Docker no sistema Debian.

Primeiro, execute o comando abaixo para atualizar seu índice de pacotes e instalar pacotes como ‘ca-certificates’ e ‘curl’.

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

Agora execute o seguinte comando para adicionar a chave GPG para o repositório do 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

Em seguida, execute o seguinte comando para adicionar o repositório do Docker ao seu sistema Debian. Isso detectará automaticamente sua versão do 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

Agora que você adicionou o repositório do Docker e a chave GPG, execute o comando abaixo para atualizar seu índice de pacotes e instalar o Docker Engine em seu sistema. Neste exemplo, você instalará o Docker Engine com pacotes adicionais como Docker Compose e o plugin Docker Buildx.

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

Digite ‘Y’ para prosseguir com a instalação.

Uma vez que a instalação esteja concluída, verifique o status do serviço Docker usando o comando ‘systemctl’ abaixo. Você verá que o Docker está em execução e habilitado em sua máquina Debian.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Por fim, você pode executar o comando ‘docker’ abaixo para rodar o contêiner ‘hello-word’.

sudo docker run hello-world

Se bem-sucedido, você receberá a seguinte mensagem ‘Hello World‘ do Docker.

Instalando o Rancher

Agora que o Docker está instalado, você está pronto para instalar o Rancher. Nesta seção, você fará o download da imagem do Rancher e, em seguida, executará o contêiner do Rancher via Docker. Neste exemplo, usaremos os certificados autoassinados que são gerados automaticamente pelo contêiner do Rancher. Também usaremos a versão mais recente da imagem do Rancher.

Baixe a imagem do Rancher usando o comando ‘docker pull’ abaixo. Neste exemplo, usaremos a versão mais recente do Rancher.

sudo docker pull rancher/rancher:latest

Uma vez que a imagem do Rancher esteja baixada, execute o comando ‘docker run’ para rodar o Rancher. Com isso, o contêiner do Rancher estará em execução em segundo plano e exportará as portas 80 e 443 no servidor Debian host.

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

Verifique o status do contêiner usando o comando abaixo.

sudo docker ps

Na saída abaixo, você pode ver que o Rancher está em execução na porta 443. Além disso, você pode ver o ID do contêiner e os nomes do contêiner.

Além disso, se você tiver um erro, pode verificar o log do Rancher com o seguinte comando ‘docker’.

docker ps -a  
docker log nome-do-contêiner ou id do contêiner

A opção ‘ps -a’ mostrará contêineres que estão em execução e que saíram, e o comando ‘docker log’ é usado para verificar os logs do contêiner.

Configurando o Rancher

Neste ponto, o Rancher está em execução em seu sistema Debian como um contêiner. Para o próximo passo, você fará login no painel do Rancher para ver o nó único do Kubernetes que está em execução em cima da sua instalação do Rancher.

Abra o navegador da web e visite o endereço IP do seu servidor Debian seguido da porta 8080, como https://192.168.10.41:8080/. Se sua instalação for bem-sucedida, você verá a seguinte página de login do Rancher.

Volte ao seu terminal e execute o comando abaixo para obter a senha do Rancher. Certifique-se de trocar o ID do contêiner pela sua instalação e copie sua senha.

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

Agora insira sua senha e clique em Login com Usuário Local.

Em seguida, copie a senha gerada para o seu Rancher e certifique-se de aceitar os termos e a licença.

Agora você verá o seguinte Painel do Rancher. No exemplo abaixo, você pode ver o cluster Kubernetes de nó único criado com K3s.

Clique no cluster Kubernetes local e você obterá mais informações sobre seu cluster Kubernetes.

Acessando o Cluster Kubernetes com kubectl

Primeiro, baixe o KubeConfig para o seu computador local. A partir do painel do Rancher, clique no menu de arquivos abaixo.

Instale o ‘kubectl’ em seu sistema com o comando abaixo. No Debian 12, você pode instalar o pacote ‘kubernetes-client‘ via APT.

sudo apt install kubernetes-client -y

Defina o KUBECONFIG padrão para o seu arquivo. Neste exemplo, o arquivo KubeConfig é ‘kubeconfig.yaml’.

export KUBECONFIG=~/kubeconfig.yaml

Por fim, execute o comando ‘kubectl’ abaixo para obter a lista de pods em todos os namespaces do Kubernetes.

kubectl get pods --all-namespaces

Você verá que cada pod para o cluster Kubernetes sob o Rancher está em execução.

Conclusão

Parabéns! Você completou a instalação do Rancher com Docker no servidor Debian 12. Você aprendeu como configurar o Rancher e criar um cluster Kubernetes em cima dele. Por fim, você também aprendeu como interagir com seu cluster Kubernetes via cliente Kubernetes ‘kubectl’. Além disso, você pode implantar suas aplicações em contêiner no cluster Kubernetes via ‘kubectl’.