Installazione di portainer su Raspberry Pi

Portainer è un'interfaccia utente di gestione leggera per Docker che semplifica il processo di gestione dei contenitori Docker. Offre un'interfaccia Web intuitiva per distribuire, configurare e monitorare i contenitori. Questa guida ti guida attraverso l'installazione e l'impostazione di Portainer su un Raspberry Pi, consentendo di gestire facilmente i contenitori Docker.

Cosa avrai bisogno

1. Raspberry Pi (Qualsiasi modello con supporto Docker, ad esempio PI 3, PI 4)
2. Raspberry Pi OS installato sul tuo Raspberry Pi
3. Connessione Internet Per il download di Portainer
4. Docker Installato su Raspberry Pi (Portainer richiede l'esecuzione di Docker)

Passaggio 1: installa Docker su Raspberry Pi

Se Docker non è già installato su Raspberry Pi, segui questi passaggi per installarlo:

1. Aggiorna l'elenco dei pacchetti:

   sudo apt update
   sudo apt upgrade -y
   

2. Installa Docker usando lo script ufficiale:

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

3. Dopo l'installazione, aggiungi l'utente corrente al gruppo Docker per consentire l'esecuzione dei comandi Docker senza sudo:

   sudo usermod -aG docker ${USER}
   

4. Riavvia il Raspberry Pi per applicare le modifiche:

   sudo reboot
   

5. Verificare che Docker sia installato correttamente:

   docker --version
   

Passaggio 2: installa Portainer

Ora che Docker è installato, è possibile installare Portainer come contenitore Docker.

1. Estrarre l'immagine Portainer da Docker Hub:

   docker pull portainer/portainer-ce
   

2. Crea ed esegui un contenitore 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
   

   Ecco cosa fa il comando:

   • -d: Eseguire il contenitore in modalità distaccata.
   • -p 9000:9000: Esporre l'interfaccia utente Web sulla porta 9000.
   • -p 9443:9443: Esporre l'interfaccia utente Web con HTTPS sulla porta 9443.
   • --name portainer: Imposta il nome del contenitore come "Portainer".
   • --restart always: Riavvia automaticamente Portainer su avvio o se il contenitore si blocca.
   • -v /var/run/docker.sock:/var/run/docker.sock: Bind Mount Docker Docket per la gestione dei contenitori Docker.
   • -v portainer_data:/data: Montare un volume per persistere ai dati portainer.

3. Attendi l'inizio di Portainer, quindi apri il tuo browser web e vai a:

   http://<raspberry_pi_ip>:9000
   

   Sostituire <raspberry_pi_ip> Con l'indirizzo IP del tuo Raspberry Pi.

Passaggio 3: imposta Portainer

Quando accedi per la prima volta all'interfaccia Web Portainer, ti verrà richiesto di creare un account amministratore.

1. Crea un account amministratore:

   • Imposta un nome utente e una password per l'account amministratore.
   • Fai clic su "Crea utente" per procedere.

2. Connettiti a Docker:

   • Scegliere Locale Per gestire l'ambiente Docker locale sul tuo Raspberry Pi.
   • Clic Collegare.

Passaggio 4: usando Portainer

Una volta connesso, verrai portato alla dashboard Portainer, dove puoi iniziare a gestire i tuoi contenitori Docker. Puoi:

• Visualizza contenitori in esecuzione: Monitorare lo stato di tutti i contenitori attivi.
• Distribuire nuovi contenitori: Crea nuovi contenitori Docker dall'interfaccia Portainer.
• Gestisci volumi e reti: Visualizza e configura volumi e reti Docker.
• Visualizza registri e statistiche: Monitorare i registri e le statistiche di contenitori in esecuzione.

Passaggio 5: gestione del portainer

1. Accesso a Portainer da remoto:

   • Per accedere in modo sicuro a portainer in remoto, è possibile configurare SSL utilizzando un proxy inverso (ad esempio, NGINX o traefik) o utilizzare la porta 9443 per HTTPS (abilitato dal docker run comando sopra).

2. Ferma e riavvia Portainer: Per fermare Portainer, eseguire:

   docker stop portainer
   

   Per riavviare Portainer, eseguire:

   docker restart portainer
   

3. Rimozione di portainer: Se si desidera rimuovere Portainer, arrestare e rimuovere il contenitore:

   docker stop portainer
   docker rm portainer
   

   Facoltativamente, puoi anche rimuovere il volume Docker:

   docker volume rm portainer_data
   

Risoluzione dei problemi

• Portainer non accessibile: Assicurati che il firewall di Raspberry Pi consenta l'accesso alle porte 9000 e 9443. Se si utilizzano HTTPS, verificare che i certificati SSL siano impostati correttamente.
• Docker Container Crashing: Controllare i registri del contenitore per gli errori:

  docker logs portainer
  

• Nessun accesso per docker: Assicurati che il tuo utente faccia parte del gruppo Docker:

  sudo usermod -aG docker ${USER}
  sudo reboot
  

Conclusione

Portainer semplifica la gestione dei container Docker su Raspberry Pi fornendo un'interfaccia Web di facile utilizzo. Con pochi comandi, puoi salire e funzionare con Docker e Portainer, rendendo più facile gestire e monitorare i tuoi contenitori. Che tu stia gestendo sistemi di automazione domestica, server Web o altri servizi dockeri, Portainer è uno strumento inestimabile per gestire l'ambiente Docker di Raspberry Pi.