Masquer les derniers auteurs
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | Interface web de gestion de Docker. Un Portainer central sur le serveur principal pilote les deux machines : son propre Docker directement, et celui du Raspberry Pi par un agent. |
| 2 | |||
| 3 | == Architecture == | ||
| 4 | |||
| 5 | |=Machine|=Composant|=Image|=Rôle | ||
| 6 | |Serveur principal|Portainer CE|##portainer/portainer-ce:lts##|Instance centrale | ||
| 7 | |Raspberry Pi|Portainer Agent|##portainer/agent:latest##|Donne accès au Docker du Pi depuis l'instance centrale | ||
| 8 | |Raspberry Pi|Portainer CE|##portainer/portainer-ce:sts##|Instance locale, en doublon de l'instance centrale | ||
| 9 | |||
| 10 | == Instance centrale (serveur principal) == | ||
| 11 | |||
| 12 | {{code language="bash"}} | ||
| 13 | docker volume create portainer_data | ||
| 14 | docker run -d --name portainer --restart=always \ | ||
| 15 | -p 9443:9443 -p 8000:8000 \ | ||
| 16 | -v /var/run/docker.sock:/var/run/docker.sock \ | ||
| 17 | -v portainer_data:/data \ | ||
| 18 | portainer/portainer-ce:lts | ||
| 19 | docker network connect proxy portainer | ||
| 20 | {{/code}} | ||
| 21 | |||
| 22 | |=Port|=Rôle | ||
| 23 | |9443|Interface web en HTTPS | ||
| 24 | |8000|Tunnel des agents Edge ; inutile sans agent Edge | ||
| 25 | |||
| 26 | Premier accès : ##https:~/~/<IP_SERVEUR>:9443##, création du compte administrateur dans les minutes qui suivent le démarrage. | ||
| 27 | |||
| 28 | Le conteneur est aussi sur le réseau ##proxy## pour être publié par SWAG. Pour les redéploiements longs, passer par l'accès direct (voir [[Dépannage>>Wiki Batcave John.Infrastructure.ServeurPrincipal.Depannage.WebHome]]). | ||
| 29 | |||
| 30 | == Agent (Raspberry Pi) == | ||
| 31 | |||
| 32 | {{code language="bash"}} | ||
| 33 | docker run -d --name portainer_agent --restart=always \ | ||
| 34 | -p 9001:9001 \ | ||
| 35 | -v /var/run/docker.sock:/var/run/docker.sock \ | ||
| 36 | -v /var/lib/docker/volumes:/var/lib/docker/volumes \ | ||
| 37 | portainer/agent:lts | ||
| 38 | {{/code}} | ||
| 39 | |||
| 40 | * Utiliser le tag qui correspond au canal du serveur (##lts## ici) plutôt que ##latest##. | ||
| 41 | * Options : ##-e AGENT_SECRET=<SECRET>## (même valeur côté serveur) pour que seul ce serveur puisse piloter l'agent ; ##-v /:/host## pour la gestion des fichiers de l'hôte. | ||
| 42 | |||
| 43 | Puis, sur l'instance centrale : Environments > Add environment > Docker Standalone > Agent, adresse ##<IP_RASPBERRY>:9001##. | ||
| 44 | |||
| 45 | {{info}} | ||
| 46 | Portainer présente désormais l'agent Docker Standalone comme une option historique et recommande l'Edge Agent pour les nouvelles installations. L'agent classique reste adapté à un réseau local. | ||
| 47 | {{/info}} | ||
| 48 | |||
| 49 | == Personnalisation == | ||
| 50 | |||
| 51 | Settings > General : | ||
| 52 | |||
| 53 | |=Réglage|=Valeur | ||
| 54 | |Logo personnalisé|##https:~/~/raw.githubusercontent.com/pi-hosted/pi-hosted/master/images/pi-hosted-logo.png## | ||
| 55 | |Modèles d'applications|##https:~/~/raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json## | ||
| 56 | |||
| 57 | La liste de Lissy93 est bien plus fournie que celle d'origine. Un conteneur déployé depuis un modèle n'est pas une stack : sa configuration se relit avec ##docker inspect##. | ||
| 58 | |||
| 59 | == Limites connues == | ||
| 60 | |||
| 61 | * ##build: .## ne fonctionne pas dans une stack : construire l'image sur l'hôte puis la référencer par son nom. | ||
| 62 | * Une stack lancée en ligne de commande (##docker compose##) apparaît comme « créée hors de Portainer » : elle est visible mais non modifiable depuis l'interface. | ||
| 63 | |||
| 64 | == Sauvegarde == | ||
| 65 | |||
| 66 | Les données de Portainer (stacks, variables d'environnement, utilisateurs, réglages) sont dans le volume ##portainer_data##. Settings > General > Backup Portainer produit une archive téléchargeable, protégeable par mot de passe, à conserver hors du serveur. |