Instalando o Portainer no Raspberry Pi

A Portainer é uma interface do usuário de gerenciamento leve para o Docker que simplifica o processo de gerenciamento de contêineres do Docker. Oferece uma interface da Web intuitiva para implantar, configurar e monitorar contêineres. Este guia orienta você a instalar e configurar o Portainer em um Raspberry Pi, permitindo que você gerencie os contêineres do Docker com facilidade.

O que você precisará

Raspberry Pi (Qualquer modelo com suporte do Docker, por exemplo, PI 3, PI 4)
Raspberry Pi OS instalado no seu Raspberry Pi
Conexão com a Internet Para baixar Portainer
Docker Instalado no seu Raspberry Pi (o Portainer exige que o Docker seja executado)

Etapa 1: Instale o Docker no Raspberry Pi

Se o Docker ainda não estiver instalado no seu Raspberry Pi, siga estas etapas para instalá -lo:

Atualize a lista de pacotes:
```
sudo apt update
sudo apt upgrade -y
```
Instale o docker usando o script oficial:
```
curl -sSL https://get.docker.com | sh
```
Após a instalação, adicione o usuário atual ao grupo Docker para permitir a execução de comandos do Docker sem sudo:
```
sudo usermod -aG docker ${USER}
```
Reinicie o Raspberry Pi para aplicar as alterações:
```
sudo reboot
```
Verifique se o Docker está instalado corretamente:
```
docker --version
```

Etapa 2: Instale o Portainer

Agora que o Docker está instalado, você pode instalar o Portainer como um contêiner do Docker.

Puxe a imagem Portainer do Docker Hub:
```
docker pull portainer/portainer-ce
```
Crie e execute um contêiner Portainer:
```
docker volume create portainer_data
docker run -d -p 9000:9000 -p 9443:9443 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
```
Aqui está o que o comando faz:
- -d: Execute o contêiner no modo destacado.
- -p 9000:9000: Exponha a interface do usuário da web na porta 9000.
- -p 9443:9443: Exponha a interface do usuário da web com HTTPS na porta 9443.
- --name portainer: Defina o nome do contêiner como "Portainer".
- --restart always: Reinicie automaticamente o portainer na inicialização ou se o contêiner travar.
- -v /var/run/docker.sock:/var/run/docker.sock: Bind Mount Docker Socket para gerenciar recipientes do Docker.
- -v portainer_data:/data: Monte um volume para persistir dados de portainer.
Aguarde o portainer começar, depois abra seu navegador da web e vá para:
```
http://<raspberry_pi_ip>:9000
```
Substituir <raspberry_pi_ip> com o endereço IP do seu Raspberry Pi.

Etapa 3: Configure portainer

Quando você acessa pela primeira vez a interface da Web Portainer, você será solicitado a criar uma conta de administrador.

Criar uma conta de administrador:
- Defina um nome de usuário e senha para a conta de administrador.
- Clique em "Criar usuário" para prosseguir.
Conecte -se ao Docker:
- Escolher Local para gerenciar o ambiente do Docker local no seu Raspberry Pi.
- Clique Conectar.

Etapa 4: Usando Portainer

Uma vez conectado, você será levado ao painel Portainer, onde poderá começar a gerenciar seus contêineres do Docker. Você pode:

Veja os contêineres em execução: Monitore o status de todos os contêineres ativos.
Implantar novos contêineres: Crie novos contêineres do Docker a partir da interface Portainer.
Gerenciar volumes e redes: Veja e configure volumes e redes do docker.
Ver logs e estatísticas: Monitore os logs e estatísticas dos contêineres em execução.

Etapa 5: Gerenciando Portainer

Acessando o Portainer remotamente:
- Para acessar com segurança o Portainer remotamente, você pode configurar o SSL usando um proxy reverso (por exemplo, nginx ou traefik) ou usar a porta 9443 para https (ativado pelo docker run comando acima).
Pare e reinicie o Portainer: Para parar o Portainer, execute:
```
docker stop portainer
```
Para reiniciar Portainer, execute:
```
docker restart portainer
```
Remoção de Portainer: Se você deseja remover o Portainer, pare e remova o recipiente:
```
docker stop portainer
docker rm portainer
```
Opcionalmente, você também pode remover o volume do Docker:
```
docker volume rm portainer_data
```

Solução de problemas

Portainer não é acessível: Certifique -se de que o firewall do seu Raspberry Pi permita o acesso às portas 9000 e 9443. Se estiver usando HTTPS, verifique se os certificados SSL estão configurados corretamente.
Docker Contêiner Crashing: Verifique os logs do contêiner quanto a erros:
```
docker logs portainer
```
Sem acesso ao Docker: Verifique se o seu usuário faz parte do grupo Docker:
```
sudo usermod -aG docker ${USER}
sudo reboot
```

Conclusão

O Portainer simplifica o gerenciamento de contêineres do Docker no Raspberry Pi, fornecendo uma interface da web fácil de usar. Com apenas alguns comandos, você pode estar em funcionamento com o Docker e o Portainer, facilitando o gerenciamento e o monitoramento de seus contêineres. Esteja você executando sistemas de automação residencial, servidores da Web ou outros serviços dockerizados, a Portainer é uma ferramenta inestimável para gerenciar o ambiente do Docker do Raspberry Pi.