Portainer¶

Dans cet article

• Portainer. Fonctionnalités clés
• Fonctionnalités de déploiement
• Prise en main après le déploiement de Portainer
• Ajouter un nouvel environnement
• Commander un serveur Portainer via API

Portainer. Fonctionnalités clés¶

Portainer offre un contrôle total sur votre infrastructure de conteneurs. Voici les fonctionnalités clés que nous proposons :

• Gestion des conteneurs : Créez, démarrez, arrêtez, redémarrez et supprimez des conteneurs avec un minimum d'effort.
• Gestion des images : Travaillez avec les images utilisées pour la création de conteneurs. Avec nous, vous pouvez créer, stocker et gérer des images via une interface pratique.
• Isolation des ressources : Nous assurons l'isolation des ressources entre les applications et les conteneurs pour maintenir votre système stable et sécurisé.
• Gestion du réseau : Configurez et gérez les interfaces réseau des conteneurs, y compris le routage et la surveillance.
• Gestion du stockage : Gérez les données utilisées par les conteneurs avec des outils intégrés à Portainer.
• Contrôle de version : Nous vous aidons à gérer les versions des images et des conteneurs, simplifiant ainsi le processus de mise à jour des applications.
• Gestion de la sécurité : Définissez les droits d'accès, surveillez la sécurité et chiffrez les données pour sécuriser votre infrastructure.

Fonctionnalités de déploiement¶

• Temps d'installation - 10 minutes en même temps que l'OS.
• Logiciels installés:
  • Docker CE ;
  • Docker Compose ;
  • Portainer

Prise en main après le déploiement de Portainer¶

Après le paiement, une notification sera envoyée à l'adresse e-mail fournie lors de l'inscription indiquant que le serveur est prêt à être utilisé. Le message inclura l'adresse IP du VPS, ainsi que les détails de connexion (identifiant et mot de passe). Les clients de notre entreprise gèrent leur équipement via le panneau de contrôle du serveur et l'API — Invapi.

Les données d'authentification peuvent se trouver soit dans l'onglet Configuration >> Tags du panneau de gestion du serveur, soit dans l'e-mail envoyé :

• Lien pour accéder à l'interface web de Docker : http://<server_ip>:9000/.

L'adresse IP du serveur peut être consultée dans l'onglet Network.

Accédez au lien et créez un compte administrateur dans les 30 minutes suivant le déploiement du serveur. Remplissez les champs Username, Password et Confirm password, puis cliquez sur le bouton :

docker restart portainer

Une fois l'authentification réussie, vous pouvez commencer à utiliser le service. Les paramètres de Portainer sont regroupulés dans le menu latéral sous la section Administration comme suit :

• User-related — gérez les utilisateurs, les équipes et les rôles avec les droits d'accès ;
• Environment-related — gérez les environnements, c'est-à-dire les hôtes connectés et les clusters, leurs groupes et leurs tags ;
• Registries — configurez et gérez l'accès aux registres de conteneurs (Docker registry) ;
• Logs — journaux des événements d'authentification et de l'activité des utilisateurs ;
• Notifications — configurez et visualisez les notifications système ;
• Settings — paramètres généraux de Portainer (General), paramètres d'authentification (Authentication), Edge Compute, et un lien vers l'aide (Get Help).

Le serveur sur lequel Portainer est déployé est déjà connecté et apparaît sur l'onglet Home en tant qu'environnement local. Pour commencer à travailler avec les conteneurs, les images, les volumes et les réseaux, cliquez simplement sur sa carte — pour un serveur unique, rien d'autre n'a besoin d'être connecté.

Ajouter un nouvel environnement¶

Si vous avez plusieurs serveurs, Portainer vous permet de tous les gérer depuis un panneau unique — chaque hôte Docker supplémentaire est connecté en tant qu'environnement distinct.

Sur l'onglet Home, cliquez sur le bouton Add environment (ou allez dans Environment-related >> Environments). L'assistant Environment Wizard s'ouvrira. Sélectionnez le type d'environnement Docker Standalone et cliquez sur le bouton Start Wizard :

Dans l'étape suivante, Portainer propose une méthode de connexion. Par défaut, Edge Agent Standard est sélectionné — il fonctionne via un tunnel inverse sécurisé et est destiné aux hôtes qui ne sont pas directement joignables (par exemple, derrière un NAT). Pour une connexion directe, développez le bloc More options et choisissez Agent : dans ce cas, le serveur Portainer lui-même se connecte à l'agent à l'adresse et au port spécifiés. Portainer affiche immédiatement une commande d'installation prête à l'emploi — cliquez sur le bouton Copy command :

Connectez-vous via SSH à l'hôte que vous ajoutez :

ssh root@<server_ip>

Collez la commande copiée dans le terminal — cela démarre le conteneur portainer_agent et ouvre le port 9001 (la commande est liée à votre version de Portainer) :

docker run -d \
  -p 9001:9001 \
  --name portainer_agent \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  -v /:/host \
  portainer/agent:2.39.3

Retournez dans l'assistant et remplissez deux champs : Name — un nom d'environnement arbitraire (par exemple, docker-agent), et Environment URL — l'adresse de l'agent au format <server_ip>:9001. Cliquez ensuite sur le bouton Connect.

Après la connexion, l'environnement apparaît dans la liste et vous pouvez le gérer depuis l'onglet Dashboard : conteneurs, images, volumes, réseaux et stacks de l'hôte sélectionné. Vous pouvez visualiser tous les environnements et basculer entre eux sur l'onglet Home de l'interface web.

Des informations détaillées sur les paramètres de base de Portainer sont disponibles dans la documentation pour les développeurs.

Commander un serveur Portainer via API¶

Pour installer ce logiciel via l'API, suivez ces instructions.