Dans le monde numérique d’aujourd’hui, les technologies de conteneurisation sont essentielles pour déployer et dimensionner efficacement les applications. L’un des aspects importants de ces technologies est l’utilisation d’un registre d’images Docker sûr et fiable. Dans cet article, je vais vous guider à travers le processus d’installation du Harbor Docker Image Registry sur un serveur Ubuntu 22.04.
Installation de Docker CE (Community Edition)
Pour installer Harbor via Docker, nous devons d’abord installer Docker CE (Community Edition) sur notre serveur Ubuntu. Docker CE propose plusieurs options d’installation, et dans ce guide, nous l’installerons à partir du dépôt officiel Docker.
sudo apt install ca-certificates curl gnupg sb-release
Une fois les dépendances installées, nous devons télécharger la clé GPG pour le dépôt Docker et ajouter le dépôt officiel Docker à notre système. Pour ce faire, 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, mettez à jour l’index du paquet avec la commande apt
:
sudo apt update
Nous pouvons maintenant installer Docker CE et Docker Compose :
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 avec la commande systemctl
:
sudo systemctl is-enabled docker
sudo systemctl status docker
Téléchargement du programme d’installation de Harbor et configuration de l’installation
Maintenant que Docker est installé, nous pouvons commencer le téléchargement du paquet d’installation de Harbor et la configuration de l’installation. Harbor propose des programmes d’installation en ligne et hors ligne, et pour ce guide, nous utiliserons le programme d’installation hors ligne.
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 paquet d’installation avec 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 paquet d’installation de Harbor téléchargé et extrait, nous pouvons maintenant configurer l’installation. Naviguez vers le répertoire d’installation de Harbor :
cd /opt/harbor
Copiez le modèle de configuration de Harbor “harbor.yml.tmpl” vers “harbor.yml” avec la commandecp
:
cp harbor.yml.tmpl harbor.yml
Ouvrez le fichier “harbor.yml” avec un éditeur de texte comme nano :
sudo nano harbor.yml
Dans le fichier de configuration, configurez le nom de domaine pour l’installation de Harbor, activez HTTPS sécurisé, définissez un mot de passe administrateur et configurez la base de données. Faites les modifications suivantes dans le fichier :
- Définissez le nom d’hôte sur votre nom de domaine ou adresse IP souhaitée. Par exemple,
registry.shapehost.io
. - Décommentez la section “https” et indiquez le chemin vers vos fichiers de clé privée et de certificat SSL.
- Définissez le “harbor admin password” sur un mot de passe fort de votre choix.
- Configurez la section de la base de données en fonction de vos besoins.
Sauvegardez le fichier et quittez l’éditeur. Votre installation de Harbor est maintenant configurée et prête à être déployée.
Installation de Harbor via le script d’installation et Docker Compose
Avec le programme d’installation hors ligne de Harbor téléchargé et le fichier de configuration configuré, nous pouvons maintenant installer Harbor avec 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 les droits sudo :
sudo./install.sh
Le script d’installation effectue une série de vérifications pour s’assurer que le système répond aux exigences pour l’installation de Harbor. Il vérifie la présence de Docker Engine et Docker Compose. Si des dépendances manquent, le programme d’installation vous invite à les installer.
Une fois que les prérequis sont satisfaits, le programme d’installation commence à extraire les images nécessaires pour le déploiement de Harbor. Il prépare ensuite l’environnement système et génère les configurations requises. Enfin, le processus d’installation commence.
Une fois l’installation terminée, vous devriez voir une sortie indiquant que les services de conteneur de Harbor sont en cours d’exécution. Vérifiez l’état des services de conteneur avec la commande suivante :
docker compose ps
Cette commande affiche les services de conteneur de Harbor en cours d’exécution et en bonne santé.
Accès au registre d’images Harbor et administration de base
Maintenant que Harbor est installé, nous allons vérifier 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 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 administrateur 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 pourrez gérer vos projets et dépôts.
Pour créer un nouvel utilisateur, accédez à la section “Administration”, cliquez sur “Users” puis sur le bouton “NEW USER”. Remplissez les détails du nouvel utilisateur et enregistrez les modifications. Le nouvel utilisateur peut maintenant se connecter à Harbor avec ses identifiants.
Harbor organise les images de conteneur en projets. Par défaut, il propose un projet appelé “Bibliothèque”. Pour ajouter un utilisateur à un projet, allez au menu “Project” et cliquez sur le projet souhaité, par exemple “Bibliothèque”. Cliquez ensuite sur “Members” puis sur le bouton “USER” pour ajouter un utilisateur au projet. Attribuez à l’utilisateur le rôle approprié, par exemple “Project Admin”, et enregistrez les modifications.
Connexion à Harbor via le client Docker et téléchargement d’images
Pour interagir avec Harbor via l’interface de ligne de commande Docker (CLI), vous devez vous connecter à Harbor depuis votre terminal. Assurez-vous que Docker est installé sur votre ordinateur local et exécutez la commande suivante :
docker login https://registry.shapehost.io/
Entrez le nom d’utilisateur et le mot de passe de l’utilisateur que vous avez créé à l’étape précédente. Une fois authentifié, vous pouvez maintenant télécharger et télécharger des images vers le registre d’images Harbor.
Pour télécharger une image vers Harbor, commencez par tirer une image d’un dépôt public avec la 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 la commande suivante :
docker images
Ensuite, taggez 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 dans le registre Harbor avec la commande suivante :
docker push registry.shapehost.io/library/nginx:alpine
L’image est maintenant téléchargée dans le registre d’images Harbor et liée au projet spécifié.
Pour des solutions d’hébergement cloud fiables et évolutives, vous devriez considérer les services VPS SSD Linux de Shape.host. Shape.host offre une infrastructure cloud de pointe pour assurer que vos applications et données sont hébergées avec des performances élevées et une sécurité robuste. Visitez Shape.host pour plus d’informations et commencez à exploiter la puissance du cloud pour votre entreprise.