Installation de Portainer sur le Raspberry Pi

Portainener est une interface utilisateur de gestion légère pour Docker qui simplifie le processus de gestion des conteneurs Docker. Il propose une interface Web intuitive pour déployer, configurer et surveiller les conteneurs. Ce guide vous guide dans l'installation et la configuration de Portainer sur un Raspberry Pi, vous permettant de gérer facilement les conteneurs Docker.

Ce dont vous aurez besoin

Raspberry Pi (Tout modèle avec le support Docker, par exemple, PI 3, PI 4)
Raspberry Pi OS Installé sur votre Raspberry Pi
Connexion Internet pour télécharger Portainener
Docker Installé sur votre Raspberry Pi (Portainer exige que Docker s'exécute)

Étape 1: Installez Docker sur le Raspberry Pi

Si Docker n'est pas déjà installé sur votre Raspberry Pi, suivez ces étapes pour l'installer:

Mettre à jour la liste des packages:
```
sudo apt update
sudo apt upgrade -y
```
Installez Docker à l'aide du script officiel:
```
curl -sSL https://get.docker.com | sh
```
Après l'installation, ajoutez l'utilisateur actuel au groupe Docker pour permettre l'exécution des commandes Docker sans sudo:
```
sudo usermod -aG docker ${USER}
```
Redémarrez le Raspberry Pi pour appliquer les modifications:
```
sudo reboot
```
Vérifiez que Docker est installé correctement:
```
docker --version
```

Étape 2: Installer Portainer

Maintenant que Docker est installé, vous pouvez installer Portainer en tant que conteneur Docker.

Tirez l'image Portainer de Docker Hub:
```
docker pull portainer/portainer-ce
```
Créer et exécuter un conteneur de 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
```
Voici ce que fait la commande:
- -d: Exécutez le conteneur en mode détaché.
- -p 9000:9000: Exposez l'interface utilisateur Web sur le port 9000.
- -p 9443:9443: Exposez l'interface utilisateur Web avec HTTPS sur le port 9443.
- --name portainer: Définissez le nom du conteneur comme "Portainer".
- --restart always: Redémarrez automatiquement Portainer sur le démarrage ou si le conteneur se bloque.
- -v /var/run/docker.sock:/var/run/docker.sock: Bind Mount Docker Socket pour gérer les conteneurs Docker.
- -v portainer_data:/data: Montez un volume pour persister les données de Portainer.
Attendez que Portainer commence, puis ouvrez votre navigateur Web et allez à:
```
http://<raspberry_pi_ip>:9000
```
Remplacer <raspberry_pi_ip> avec l'adresse IP de votre Raspberry Pi.

Étape 3: configurer Portainer

Lorsque vous accédez d'abord à l'interface Web Portainer, vous serez invité à créer un compte administrateur.

Créer un compte d'administration:
- Définissez un nom d'utilisateur et un mot de passe pour le compte d'administration.
- Cliquez sur "Créer un utilisateur" pour continuer.
Connectez-vous à Docker:
- Choisir Locale Pour gérer l'environnement Docker local sur votre Raspberry Pi.
- Faire un clic Connecter.

Étape 4: Utilisation de Portainer

Une fois connecté, vous serez emmené au tableau de bord Portainer, où vous pouvez commencer à gérer vos conteneurs Docker. Tu peux:

Afficher les conteneurs en cours d'exécution: Surveiller l'état de tous les conteneurs actifs.
Déployer de nouveaux conteneurs: Créez de nouveaux conteneurs Docker à partir de l'interface Portainer.
Gérer les volumes et les réseaux: Afficher et configurer les volumes et réseaux Docker.
Afficher les journaux et les statistiques: Surveiller les journaux et les statistiques des conteneurs en cours d'exécution.

Étape 5: Gérer le portainer

Accéder à Portainer à distance:
- Pour accéder à la Portainer à distance à distance, vous pouvez configurer SSL à l'aide d'un proxy inversé (par exemple, Nginx ou Trafik) ou utiliser le port 9443 pour HTTPS (activé par le docker run commande ci-dessus).
Arrêtez et redémarrez Portainer: Pour arrêter Portainer, exécuter:
```
docker stop portainer
```
Pour redémarrer Portainer, exécutez:
```
docker restart portainer
```
Suppression de Portainer: Si vous souhaitez supprimer le portainer, arrêtez et supprimez le conteneur:
```
docker stop portainer
docker rm portainer
```
Facultativement, vous pouvez également supprimer le volume Docker:
```
docker volume rm portainer_data
```

Dépannage

Portainer non accessible: Assurez-vous que le pare-feu de votre Raspberry Pi permet d'accéder aux ports 9000 et 9443. Si vous utilisez HTTPS, vérifiez que les certificats SSL sont configurés correctement.
Docker Container s'écraser: Vérifiez les journaux des conteneurs pour les erreurs:
```
docker logs portainer
```
Aucun accès à docker: Assurez-vous que votre utilisateur fait partie du groupe Docker:
```
sudo usermod -aG docker ${USER}
sudo reboot
```

Conclusion

Portainer simplifie la gestion des conteneurs Docker sur le Raspberry Pi en fournissant une interface Web facile à utiliser. Avec seulement quelques commandes, vous pouvez être opérationnel avec Docker et Portainer, ce qui facilite la gestion et le suivi de vos conteneurs. Que vous exécutiez des systèmes de domaine domestique, des serveurs Web ou d'autres services docking, Portainener est un outil inestimable pour gérer l'environnement Docker de votre Raspberry Pi.