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á

1. Raspberry Pi (Qualquer modelo com suporte do Docker, por exemplo, PI 3, PI 4)
2. Raspberry Pi OS instalado no seu Raspberry Pi
3. Conexão com a Internet Para baixar Portainer
4. 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:

1. Atualize a lista de pacotes:

   sudo apt update
   sudo apt upgrade -y
   

2. Instale o docker usando o script oficial:

   curl -sSL https://get.docker.com | sh
   

3. 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}
   

4. Reinicie o Raspberry Pi para aplicar as alterações:

   sudo reboot
   

5. 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.

1. Puxe a imagem Portainer do Docker Hub:

   docker pull portainer/portainer-ce
   

2. 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.

3. 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.

1. 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.

2. 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

1. 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).

2. Pare e reinicie o Portainer: Para parar o Portainer, execute:

   docker stop portainer
   

   Para reiniciar Portainer, execute:

   docker restart portainer
   

3. 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.