Christian WellsLa technologie de la conteneurisation est de plus en plus utilisée par les entreprises. Pour gérer efficacement les images Docker, une solution fiable et sécurisée est de plus en plus nécessaire. Harbor est un projet open-source qui offre une solution robuste pour stocker et distribuer des images de conteneurs dans des environnements natifs du cloud. Dans cet article, nous vous guiderons pas à pas dans l’installation de Harbor Docker Image Registry sur un serveur Ubuntu 22.04.
Installer Docker CE (Community Edition)
Pour déployer Harbor via Docker, nous devons d’abord installer Docker CE (Community Edition) sur notre serveur Ubuntu. Docker CE offre une gamme d’options d’installation, et dans ce guide, nous l’installerons à partir du référentiel Docker officiel. Commencez par installer quelques dépendances de base à l’aide de la commande apt :
sudo apt install ca-certificates curl gnupg lsb-release
Une fois les dépendances installées, nous devons télécharger la clé GPG pour le référentiel Docker et ajouter le référentiel Docker officiel à notre système. Exécutez les commandes suivantes :
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Ensuite, rafraîchissez et mettez à jour l’index des packages à l’aide de la commande apt :
sudo apt update
Avec le référentiel Docker ajouté, nous pouvons maintenant procéder à l’installation de Docker CE et de Docker Compose en utilisant la commande suivante :
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Après l’installation, vérifiez l’état actuel du service Docker en utilisant la commande systemctl :
sudo systemctl is-enabled docker
sudo systemctl status docker
Télécharger le programme d’installation Harbor et configurer l’installation
Maintenant que Docker est installé, nous pouvons passer au téléchargement du package d’installation de Harbor et à la configuration de l’installation. Harbor propose des installateurs en ligne et hors ligne, et pour ce guide, nous utiliserons l’installateur hors ligne. Téléchargez l’installateur hors ligne dans le répertoire ‘/tmp’ à l’aide de la commande curl :
cd /tmp curl -s https://api.github.com/repos/goharbor/harbor/releases/latest | grep browser_download_url | cut -d '"' -f4 | grep'.tgz
Une fois le téléchargement terminé, extrayez le package d’installation à l’aide de la commande tar :
tar -xzvf harbor-offline-installer-v2.6.1.tgz
Déplacez maintenant le répertoire ‘harbor’ vers ‘/opt’ pour définir le répertoire d’installation comme ‘/opt/harbor’ :
sudo mv harbor /opt/
Avec le package d’installation de Harbor téléchargé et extrait, nous pouvons maintenant configurer l’installation. Allez dans le répertoire d’installation de Harbor :
cd /opt/harbor
Copiez le modèle de configuration de harbor ‘harbor.yml.tmpl’ en ‘harbor.yml’ à l’aide de la commande cp :
cp harbor.yml.tmpl harbor.yml
Ouvrez le fichier ‘harbor.yml’ à l’aide d’un éditeur de texte comme nano :
sudo nano harbor.yml
Dans le fichier de configuration, vous allez définir le nom de domaine pour l’installation de Harbor, activer le HTTPS sécurisé, définir un mot de passe admin, et configurer la base de données. Faites les modifications suivantes dans le fichier :
- Définissez le nom d’hôte sur le nom de domaine ou l’adresse IP de votre choix. Par exemple,
registry.shapehost.io. - Décommentez la section ‘https’ et fournissez le chemin vers vos fichiers de certificat SSL et de clé privée.
- Définissez le ‘harbor admin password’ sur un mot de passe fort de votre choix.
- Configurez la section de la base de données selon vos besoins.
Enregistrez le fichier et quittez l’éditeur. Votre installation de Harbor est maintenant configurée et prête à être déployée.
Installer Harbor via le script d’installation et Docker Compose
Avec l’installateur hors ligne de Harbor téléchargé et le fichier de configuration configuré, nous pouvons maintenant procéder à l’installation de Harbor en utilisant le script d’installation et Docker Compose. Avant de commencer l’installation, assurez-vous que votre répertoire de travail actuel est ‘/opt/harbor’. Pour installer Harbor, exécutez la commande suivante avec des privilèges sudo :
sudo ./install.sh
Le script d’installation effectuera une série de vérifications pour s’assurer que le système répond aux exigences de l’installation de Harbor. Il vérifiera la présence du moteur Docker et de Docker Compose. Si des dépendances manquent, l’installateur vous invitera à les installer.
Une fois que les prérequis sont remplis, l’installateur extraira les images nécessaires pour le déploiement de Harbor. Ensuite, il préparera l’environnement système et générera les configurations requises. Enfin, le processus d’installation commencera.
Une fois l’installation terminée, vous devriez voir une sortie indiquant que les services de conteneur Harbor sont en cours d’exécution. Pour vérifier l’état des services de conteneur, utilisez la commande suivante :
docker compose ps
Cette commande affichera les services de conteneur Harbor en cours d’exécution et en bonne santé.
Accéder au registre d’images Harbor et à l’administration de base
Maintenant que Harbor est installé, vérifions son fonctionnement en accédant au registre d’images Harbor et en effectuant des tâches administratives de base.
Pour accéder à l’interface web de Harbor, ouvrez votre navigateur web et visitez le nom de domaine ou l’adresse IP associée à votre installation de Harbor, en utilisant HTTPS. Par exemple, https://registry.shapehost.io/. Vous devriez voir la page de connexion de Harbor.
Pour vous connecter, utilisez l’utilisateur admin par défaut et le mot de passe que vous avez configuré dans le fichier ‘harbor.yml’. Une fois connecté, vous serez accueilli par le tableau de bord de Harbor, où vous pouvez gérer vos projets et vos dépôts.
Pour créer un nouvel utilisateur, allez dans la section ‘Administration’, cliquez sur ‘Utilisateurs’, puis sur le bouton ‘NOUVEL UTILISATEUR’. Remplissez les détails pour le nouvel utilisateur et enregistrez les modifications. Le nouvel utilisateur pourra désormais se connecter à Harbor avec ses identifiants.
Harbor organise les images de conteneurs en projets. Par défaut, il fournit un projet nommé ‘library’. Pour ajouter un utilisateur à un projet, allez dans le menu ‘Projet’ et cliquez sur le projet souhaité, comme ‘library’. De là, cliquez sur ‘Membres’ puis sur le bouton ‘UTILISATEUR’ pour ajouter un utilisateur au projet. Attribuez le rôle approprié à l’utilisateur, comme ‘Admin du projet’, et enregistrez les modifications.
Se connecter à Harbor via le client Docker et pousser des images
Pour interagir avec Harbor en utilisant l’interface de ligne de commande Docker (CLI), vous devez vous connecter à Harbor depuis votre terminal. Assurez-vous que Docker est installé sur votre machine locale et exécutez la commande suivante :
docker login https://registry.shapehost.io/
Entrez le nom d’utilisateur et le mot de passe pour l’utilisateur que vous avez créé à l’étape précédente. Une fois authentifié, vous pouvez maintenant tirer et pousser des images vers le registre d’images Harbor.
Pour pousser une image vers Harbor, commencez par tirer une image d’un dépôt public en utilisant le CLI Docker. Par exemple, tirons la dernière version de l’image ‘nginx’ avec le tag ‘alpine’ :
docker pull nginx:alpine
Vérifiez que l’image a été téléchargée avec succès en exécutant :
docker images
Ensuite, marquez l’image avec l’adresse du registre Harbor et le nom du projet. Par exemple :
docker tag nginx:alpine registry.shapehost.io/library/nginx:alpine
Enfin, poussez l’image vers le registre Harbor en utilisant la commande suivante :
docker push registry.shapehost.io/library/nginx:alpine
L’image sera maintenant téléchargée vers le registre d’images Harbor et associée au projet spécifié.
Félicitations ! Vous avez réussi à installer le registre d’images Docker Harbor sur votre serveur Ubuntu 22.04. Avec Harbor, vous pouvez stocker et distribuer de manière sécurisée des images de conteneurs dans votre environnement natif du cloud. En suivant ce guide, vous avez appris comment configurer Harbor, créer des utilisateurs et des projets, vous connecter à Harbor via le CLI Docker, et pousser des images vers le registre.
Pour des solutions d’hébergement cloud fiables et évolutives, envisagez les services Linux SSD VPS de Shape.host. Shape.host fournit une infrastructure cloud de premier plan, garantissant que vos applications et données sont hébergées avec des performances et une sécurité élevées. Visitez Shape.host pour plus d’informations et commencez à exploiter la puissance du cloud pour votre entreprise.
