Introdução
PimpMyPi é uma série em volta do Raspeberry Pi e de como tirar partido do mesmo. A série vai ter um inicio mas sem um fim programado, uma vez que, durante o tempo vamos adicionado novas funcionalidades ao que será o nosso servidor. Fiquem atentos ao canal e ativem as notificações para não perderem o próximo episódio.
Pré-requisitos
Para poderes seguir este tutorial será necessário ter um Raspberry Pi. Aconselho o modelo B 8GB pelo simples fato que vamos adicionando diferentes serviços na nossa Pi e assim terá poder necessário para as nossas tarefas e se possível com SSD. Neste vídeo podes ver a minha configuração.
1 – Preparar o SO no nosso Pi com RPi Imager
Vamos começar por aceder ao site do Raspberry Pi e fazer download da ferramenta.
Depois podemos seguir os passos nas imagens abaixo para configurar a nossa imagem.
2 – Ligar por SSH ao RPi
Antes de mais temos saber qual o IP que foi atribuído ao nosso Pi.
No meu caso, o mais simples é acessar às definições do router e ordenar pelos mais recentes conectados à rede (isto pode variar entre routers o melhor é uma pesquisa rápida no Google caso não saibam como o fazer).
Uma vez que já sabemos o o endereço de IP podemos abrir o Terminal (Mac) ou a Linha de Comandos (Windows) ou outro software que já utilizem e acessar com o nosso login.
ssh [o teu utilizador]@[o ip do rpi]
Quando se ligam pela primeira vez a um novo IP surge uma mensagem se querem adicionar/conectarem-se aquela ‘fingerprint’ ao qual escrevemos “yes” e primir ‘enter’.
De seguida será solicitada a password.
3 – Instalar o Docker
Existem diversas formas de se instalar o Docker, uma delas podemos assistir no vídeo NGINX, Docker e Portainer em Proxmox 7.0 em que utilizámos um ‘script’ mas, desta vez outro método rápido e simples, também pode ser utilizado.
Depois de conectados ao nosso RPi vamos começar por atualizar o SO:
sudo apt update && sudo apt upgrade -y
Após o término das atualizações instalamos o Docker:
sudo apt install docker.io -y
Vamos reniciar o nosso Pi:
sudo reboot
Podemos agora confirmar que o nosso Docker está a correr e até criar o nosso primeiro contentor de teste:
sudo systemctl status docker
sudo docker run hello-world
Vamos dar acesso ao nosso utilizador ao grupo Docker e reniciar o nosso RPi:
sudo usermod -aG docker [o teu utilizador]
sudo reboot
NOTA: se já tiverem uma instalação do Portainer a correr utilizem o método no passo 4(b).
4 (a) – Instalar o Portainer (nova instalação)
Duas maneiras distintas de instalar o Portainer (a e b).
A primeira, caso esta seja a primeira instalação do Portainer, será instalar de raiz este GUI da seguinte forma.
Primeiro, crie o volume que o Portainer Server usará para armazenar a sua base de dados:
docker volume create portainer_data
Depois vamos fazer download e instalar o contentor do Portainer Server:
docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
Podemos agora aceder ao nosso RPi mais a porta 9443 (https://192.168.30.114:9443) e criar o nosso utilizador.
Posteriormente selecionam a opção “Get Started” e parabéns, está assim concluída a instalação do nosso GUI Portainer.
4 (b) – Instalar o Portainer (agente)
Este segundo método destina-se a quem já tenha inicialmente uma instalação do Portainer numa máquina, ou outro RPi, e pretenda adicionar outro ambiente sem ter que andar a instalar sempre o Portainer vezes sem conta e gerir todas as instalações no mesmo local.
Vamos aceder à instalação existente do Portainer.
No menu vamos escolher a opção “Environments” e depois do lado direito, no botão azul, em “+ Add environment”:
Selecionamos “Docker Standalone” e avançamos com o botão “Start Wizard”:
Vamos dividir o próximo passo em duas fazes.
Primeiro vamos copiar o código fornecido e correr o mesmo na ligação por SSH ao nosso RPi para instalar o Agente no Docker. (Podemos reparar no código que ele atribui uma porta diferente para não entrar em conflito com a nossa instalação já existente):
Nota: não esquecer de adicionar ‘sudo’ antes do comando docker
Como podemos ver pela imagem acima, o nosso agente foi instalado com sucesso e podemos agora dar um nome ao nosso novo ambiente assim como o IP mais a porta onde foi instalado e clicar em ‘Connect’ que irá surgir uma mensagem no topo direito a informar que foi adicionado com sucesso:
Podemos voltar agora ao menu inicial e constatar que temos adicionado ao nosso Portainer um novo ambiente (agente) e temos agora acesso no mesmo local às nossas instalações do Docker.
Estes passos podem ser replicados quantas vezes necessárias conforme as necessidades de cada um.
