Comment démarrer avec Portainer, une interface utilisateur Web pour Docker –

Portainer est une interface utilisateur Docker populaire qui vous aide à visualiser vos conteneurs, images, volumes et réseaux. Portainer vous aide à prendre le contrôle des ressources Docker sur votre machine, évitant de longues commandes de terminal.

Portainer a récemment atteint la version 2.0 qui a ajouté la prise en charge des clusters Kubernetes. L’outil prend également en charge les environnements Docker Swarm et Azure ACI. Dans ce tutoriel, nous allons garder les choses simples et utiliser Portainer pour gérer une installation Docker locale.

Deux éditions du logiciel sont disponibles, la CE gratuite et open-source et commerciale. Les capacités supplémentaires de Business sont principalement axées sur l’accès amélioré, la gestion des quotas et les contrôles administrateur.

Installez Portainer

Assurez-vous que Docker est installé et en cours d’exécution avant de continuer. Docker 19.01 est requis pour que toutes les fonctionnalités de Portainer soient entièrement prises en charge.

Tout d’abord, vous devrez créer un nouveau volume Docker. Portainer l’utilisera pour stocker ses données persistantes. Le nôtre va être appelé portainer_data.

docker volume create portainer_data

Ensuite, utilisez Docker pour démarrer un nouveau conteneur Portainer:

docker run -d -p 9000:9000 --name=portainer --restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Cette commande tirera le portainer/portainer-ce image et démarrez un nouveau conteneur à partir de celle-ci. Le conteneur sera détaché et s’exécutera en arrière-plan (-d).

Le volume créé précédemment est monté sur /data dans le conteneur, où Portainer stocke toutes ses données d’application. Le socket Docker de l’hôte est également monté dans le conteneur, afin que Portainer ait accès à l’instance Docker de votre machine. Enfin, le port 9000 sur l’hôte est lié au port 9000 dans le conteneur. C’est le port sur lequel Portainer expose son interface utilisateur Web.

Première exécution

Vous pouvez maintenant vous connecter à Portainer en visitant http://localhost:9000 dans votre navigateur. Vous devrez définir un mot de passe pour le admin utilisateur lors de la première utilisation. Vous arriverez ensuite sur l’écran d’accueil.

Avant de commencer à utiliser Portainer, il vaut la peine de regarder les propres options de configuration de l’application. Cliquez sur le lien « Paramètres » dans le menu de navigation de gauche. Ici, vous pouvez modifier les paramètres de sécurité de Portainer, définir un logo d’application personnalisé et désactiver la collecte de statistiques d’utilisation anonymes. La plupart des paramètres doivent être assez explicites, la majorité se concentrant sur la limitation du pouvoir accordé aux utilisateurs non administrateurs.

Le sous-menu «Authentification» de la barre de navigation vous permet de configurer la manière dont les utilisateurs se connectent à Portainer. Portainer utilise son propre système de gestion des utilisateurs interne par défaut, mais vous pouvez choisir d’utiliser un serveur LDAP ou un fournisseur OAuth existant. Sélectionnez la méthode à utiliser, puis remplissez les champs du formulaire pour configurer votre système d’authentification préféré. Lorsque vous utilisez la base de données des utilisateurs intégrée, vous pouvez utiliser le lien «Utilisateurs» dans le menu secondaire pour créer des utilisateurs supplémentaires et les trier en équipes.

Points de terminaison

Portainer vous permet de gérer plusieurs points de terminaison Docker. Pour commencer, vous verrez un seul point de terminaison «local», représentant le moteur Docker s’exécutant sur votre propre machine.

Pour ajouter un point de terminaison supplémentaire, cliquez sur le lien «Points de terminaison» dans la barre latérale. Ensuite, cliquez sur le bouton bleu «Ajouter un point de terminaison». Choisissez le type de point de terminaison que vous utiliserez et fournissez vos détails de connexion.

Tout va bien, vous pourrez ajouter votre point de terminaison. Il apparaîtra comme une nouvelle vignette sélectionnable sur l’écran d’accueil de Portainer. Des conseils détaillés sur l’ajout de points de terminaison supplémentaires sortent du cadre de ce guide d’introduction, car le succès nécessitera une configuration correcte de l’hôte auquel vous vous connectez.

Gérer les conteneurs

Vous êtes maintenant prêt à commencer à utiliser Portainer pour interagir avec Docker. Depuis l’écran d’accueil, cliquez sur votre point de terminaison «local». Il sera sélectionné dans Portainer, vous donnant accès à l’interface de gestion complète. Vous arriverez à un tableau de bord simple vous donnant un aperçu de vos conteneurs, images et volumes.

Cliquez sur «Conteneurs» sur le tableau de bord ou dans la barre latérale pour ouvrir l’écran de gestion des conteneurs. Vous verrez un tableau affichant tous vos conteneurs Docker.

Pour entreprendre une action contre un conteneur, cochez la case en regard de son nom. Vous pouvez maintenant utiliser la ligne de boutons en haut de l’écran pour démarrer, arrêter, redémarrer ou supprimer le conteneur. Les conteneurs qui sont actuellement en cours d’exécution afficheront un état vert «en cours d’exécution» tandis que les conteneurs arrêtés obtiendront un état rouge «arrêté».

Si vous utilisez une nouvelle installation de Docker, votre seul conteneur peut être Portainer lui-même. Veillez à ne pas arrêter ce conteneur, car il dessert l’interface utilisateur Web de Portainer que vous utilisez!

Cliquez sur le nom d’un conteneur pour afficher et modifier ses détails. Cet écran vous permet d’inspecter les propriétés du conteneur, de créer une nouvelle image Docker à partir de son état actuel et de gérer ses connexions réseau.

En haut de l’écran, vous trouverez cinq boutons sous «État du conteneur» qui vous permettent d’afficher les journaux du conteneur («Journaux»), d’inspecter son manifeste Docker («Inspecter»), d’afficher les statistiques d’utilisation des ressources («Statistiques» ), accédez à une console interactive («Console») ou attachez une console au processus de premier plan dans le conteneur («Joindre»).

Créer un conteneur

Pour créer un nouveau conteneur, retournez à l’écran Conteneurs et cliquez sur le bouton bleu «Ajouter un conteneur». Vous pouvez également modifier un conteneur existant – en le détruisant efficacement et en le remplaçant par un nouveau avec des propriétés modifiées – en utilisant le bouton «Dupliquer / Modifier» sur l’écran des détails du conteneur. Les deux opérations affichent la même interface.

Tout d’abord, saisissez un nom pour votre nouveau conteneur. Ensuite, spécifiez l’image Docker à utiliser. Pour les images publiques sur Docker Hub, telles que wordpress:latest, vous pouvez saisir un nom d’image sans fournir de configuration supplémentaire.

Pour utiliser des images stockées dans un registre privé, vous devez d’abord ajouter les détails du registre à Portainer. Cliquez sur le lien «Registres» sous le titre Paramètres dans la barre latérale gauche. Appuyez sur le bouton bleu «Ajouter un registre» et définissez l’URL, le nom d’utilisateur et le mot de passe de votre registre. Vous pourrez ensuite le sélectionner dans le menu déroulant «Registre» sur l’écran de création du conteneur. Vous pouvez également utiliser l’écran Registres pour définir les informations d’identification des connexions Docker Hub, ce qui vous permet d’extraire des images privées et d’éviter les limites de débit appliquées aux utilisateurs non authentifiés.

Vous êtes maintenant prêt à déployer votre conteneur en appuyant sur le bouton «Déployer le conteneur» en bas du formulaire. Avant de continuer, vérifiez les paramètres supplémentaires affichés au-dessus du bouton. Vous pouvez configurer la liaison de port, forcer Portainer à extraire l’image avant le déploiement et choisir de supprimer automatiquement le conteneur à sa sortie.

Au bas de l’écran, vous trouverez une interface utilisateur de paramètres avancés qui offre encore plus d’options – trop nombreuses pour être couvertes de manière exhaustive ici. Ceux-ci reproduisent l’intégralité des fonctionnalités du docker run Commande CLI, vous permettant de configurer la commande du conteneur, le point d’entrée, les volumes, les interfaces réseau et les variables d’environnement. Une grande partie de cette interface utilisateur devrait sembler intuitive si vous êtes déjà familiarisé avec les capacités de Docker.

Utilisation de piles de conteneurs

L’écran de création de conteneur ne vous permet de faire tourner qu’un conteneur à la fois. Portainer a une prise en charge intégrée des «piles» qui vous permettent de déployer des conteneurs liés. Cette fonctionnalité est basée sur docker-compose version 2.

Cliquez sur l’élément « Piles » dans la barre de navigation, puis appuyez sur le bouton « Ajouter une pile ». Il n’y a pas de support pour créer des piles graphiquement – vous devez coller ou télécharger un docker-compose.yml fichier. Vous pouvez également choisir de vous connecter à un référentiel Git et d’utiliser son docker-compose.yml directement.

Avant de déployer la pile, vous pouvez définir des variables d’environnement qui seront mises à la disposition des conteneurs. Choisissez le niveau de contrôle d’accès Portainer à appliquer, puis cliquez sur «Déployer la pile». Portainer extraira toutes les images et créera tous les conteneurs spécifiés par le fichier Compose.

Sélectionnez votre pile dans l’écran Piles pour gérer ses conteneurs collectivement. Vous pouvez arrêter tous les conteneurs de la pile, ou supprimer complètement la pile, à l’aide des boutons en haut de l’écran. Il existe également des contrôles pour dupliquer la pile ou créer un modèle réutilisable à partir de son état actuel.

Les modèles sont accessibles à partir de l’écran de création de pile et vous permettent de lancer rapidement de nouvelles instances de services fréquemment utilisés. Portainer est également livré avec un certain nombre de modèles intégrés, accessibles à partir du lien «Modèles d’application» dans la barre de navigation.

Commodité de Portainer

Portainer vous aide à créer, gérer et surveiller rapidement les conteneurs Docker. Il fournit une interface graphique aux commandes CLI Docker qui peuvent parfois devenir longues et lourdes. Cela rend également Docker accessible aux utilisateurs qui ne sont peut-être pas familiers avec les interfaces de ligne de commande.

Outre ses capacités de gestion de conteneurs, Portainer offre également une visibilité sur les autres ressources fondamentales de Docker. L’écran Images vous permet d’afficher, d’extraire, d’importer, d’exporter et de supprimer les images disponibles sur votre terminal. Les écrans Réseaux et Volumes agissent de la même manière, énumérant et assurant le contrôle de leurs ressources respectives. Enfin, le tableau Événements offre une liste complète de toutes les actions entreprises par le moteur Docker. Cela peut être utile lors de l’examen des actions passées et de l’identification de la création ou de la destruction de certains conteneurs.