Installer Harbor (registre d'artefacts)

Ce guide vous explique comment installer et configurer Harbor sur un serveur Ubuntu 24.04 LTS. Harbor est un registre d'artefacts cloud-native de référence (projet CNCF graduated) : il permet de stocker des artefacts au format OCI (Open Container Initiative). Vous pouvez y héberger vos builds Docker (images de conteneurs), vos charts Helm pour Kubernetes, ainsi que les SBOM (Software Bill of Materials) et, depuis les versions récentes, les artefacts IA/ML. Harbor intègre Trivy pour le scan de vulnérabilités, le RBAC, l’OIDC/LDAP et la réplication entre registres.

Le déploiement décrit ici utilise l’installeur officiel (Docker Compose) sur une VM ou un serveur dédié, avec HTTPS et certificats Let's Encrypt.

Commander un serveur

Pour héberger votre instance Harbor, HostMyServers propose plusieurs offres adaptées :

VPS Performance - Idéal pour un registre de test ou petit volume
VPS NVMe - Excellent rapport qualité/prix
Serveurs dédiés Eco - Pour de nombreux projets ou images
Serveurs dédiés Performance - Performance maximale

Prérequis

Accès SSH root ou utilisateur avec sudo
Système Ubuntu 24.04 LTS 64 bits
Docker (moteur 20.10.10+) et Docker Compose (v2 ou v1.18+)
Un nom de domaine (ex. harbor.votredomaine.com) avec un enregistrement A pointant vers l’IP du serveur
Ports 80 (HTTP, pour Certbot ou redirection) et 443 (HTTPS) accessibles

Configuration requise

Composant	Minimum	Recommandé
RAM	4 Go	8 Go
CPU	2 cœurs	4 cœurs
Stockage	40 Go	160 Go
Réseau	100 Mbps	1 Gbps

HTTPS en production

En production, configurez toujours HTTPS avec des certificats valides (Let's Encrypt ou PKI d’entreprise). Harbor déprécie progressivement le HTTP.

Connexion au serveur

Connectez-vous en SSH à votre serveur :

ssh utilisateur@adresse_ip_serveur

Mise à jour du système

Mettez à jour les paquets avant de commencer :

sudo apt update
sudo apt upgrade -y

Installation de Docker et Docker Compose

Harbor s’appuie sur Docker et Docker Compose. Si ce n’est pas déjà fait, installez-les :

sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "${VERSION_CODENAME:-$VERSION}") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Vérifiez :

docker --version
docker compose version

Obtenir les certificats TLS (Let's Encrypt)

Harbor doit être configuré avec un certificat et une clé privée. Obtenez-les avec Certbot avant d’installer Harbor (port 80 doit être libre) :

sudo apt install -y certbot
sudo certbot certonly --standalone -d harbor.votredomaine.com -m votre-email@exemple.com --agree-tos --non-interactive

Les fichiers seront dans /etc/letsencrypt/live/harbor.votredomaine.com/ : fullchain.pem (certificat) et privkey.pem (clé privée). Notez ces chemins pour l’étape suivante.

Renouvellement

Certbot renouvelle automatiquement les certificats. Après renouvellement, redémarrez les conteneurs Harbor pour qu’ils rechargent les certificats : cd /opt/harbor && sudo docker compose down && sudo docker compose up -d.

Téléchargement et extraction de Harbor

Harbor propose un installeur offline (contenant les images) ou online (télécharge les images au premier lancement). Nous utilisons l’installeur offline pour plus de fiabilité.

Consultez les releases Harbor sur GitHub pour la dernière version stable (ex. v2.14.2). Adaptez l’URL et le nom du fichier si besoin :

cd /opt
sudo wget https://github.com/goharbor/harbor/releases/download/v2.14.2/harbor-offline-installer-v2.14.2.tgz
sudo tar xzvf harbor-offline-installer-v2.14.2.tgz
cd harbor

Configuration de Harbor

Copiez le fichier de configuration modèle et éditez-le :

sudo cp harbor.yml.tmpl harbor.yml
sudo nano harbor.yml

Paramètres essentiels à modifier (remplacez les valeurs par les vôtres) :

# Nom d'hôte ou domaine (jamais localhost)
hostname: harbor.votredomaine.com

# HTTPS (obligatoire en production)
https:
  port: 443
  certificate: /etc/letsencrypt/live/harbor.votredomaine.com/fullchain.pem
  private_key: /etc/letsencrypt/live/harbor.votredomaine.com/privkey.pem

# Mot de passe admin (à changer impérativement)
harbor_admin_password: VotreMotDePasseSecurise

# Répertoire de données
data_volume: /data/harbor

# Scan de vulnérabilités avec Trivy (recommandé)
trivy:
  ignore_unfixed: false
  security_check: vuln,config,secret
  skip_update: false
  insecure: false

Paramètre	Description
`hostname`	Domaine ou FQDN utilisé pour accéder à Harbor (doit correspondre au certificat)
`https.certificate` / `private_key`	Chemins vers le certificat et la clé TLS
`harbor_admin_password`	Mot de passe du compte admin (à changer au premier accès)
`data_volume`	Répertoire de stockage des données Harbor
`trivy.*`	Options du scanner Trivy (CVE, config, secrets)

Mot de passe admin

Le mot de passe par défaut dans le template est Harbor12345. Remplacez-le par un mot de passe fort avant le premier démarrage.

Lancement de l’installation

Lancez le script d’installation avec l’option Trivy pour activer le scan de vulnérabilités sur les images :

sudo ./install.sh --with-trivy

Le script vérifie les prérequis, prépare les fichiers Docker Compose et démarre les conteneurs. À la fin, vous devriez voir :

✔ ----Harbor has been installed and started successfully.----

Pare-feu

Ouvrez les ports HTTP et HTTPS si nécessaire :

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

Accès à Harbor

Ouvrez un navigateur et allez à : https://harbor.votredomaine.com
Connectez-vous avec les identifiants par défaut : admin / mot de passe défini dans harbor_admin_password
Changez immédiatement le mot de passe admin : Administration → Utilisateurs → modifier le compte admin
Créez un projet (ex. monprojet) pour y pousser vos images

Pousser une image vers Harbor

Depuis une machine où Docker est installé et qui peut joindre votre Harbor :

# Connexion au registre
docker login harbor.votredomaine.com
# Saisir : admin et le mot de passe

# Taguer une image (remplacer par votre projet et votre image)
docker tag nginx:alpine harbor.votredomaine.com/monprojet/nginx:alpine

# Pousser l'image
docker push harbor.votredomaine.com/monprojet/nginx:alpine

Dans l’interface Harbor, l’image apparaît dans le projet. Si Trivy est activé, un scan peut être lancé automatiquement ou manuellement pour afficher les vulnérabilités (CVE).

Harbor supporte aussi le stockage de charts Helm (format OCI). Après avoir configuré Helm avec votre registre Harbor, vous pouvez pousser et tirer des charts avec helm push / helm pull depuis le même projet. Ainsi, un même registre OCI peut centraliser vos images Docker et vos charts Helm pour Kubernetes.

Gestion et arrêt de Harbor

Les conteneurs sont gérés par Docker Compose dans /opt/harbor :

cd /opt/harbor

# Voir les conteneurs
sudo docker compose ps

# Arrêter Harbor
sudo docker compose down

# Redémarrer Harbor
sudo docker compose up -d

En cas de problème

La page Harbor ne s’affiche pas ou erreur HTTPS

Vérifiez que le hostname dans harbor.yml correspond exactement au domaine utilisé dans le navigateur et au nom commun du certificat.
Vérifiez les chemins des certificats : sudo ls -la /etc/letsencrypt/live/harbor.votredomaine.com/
Consultez les logs : cd /opt/harbor && sudo docker compose logs -f proxy

Les conteneurs ne démarrent pas

Vérifiez les logs : cd /opt/harbor && sudo docker compose logs
Vérifiez l’espace disque : df -h (Harbor et les images nécessitent de l’espace)
Vérifiez que les ports 80 et 443 ne sont pas utilisés par un autre service : ss -tlnp | grep -E ':80|:443'

En développement, vous pouvez ajouter le registre en insecure dans /etc/docker/daemon.json (non recommandé en production).
En production, assurez-vous que le certificat Let's Encrypt est valide et que le client Docker fait bien confiance au CA (souvent le cas avec Let's Encrypt).

Commander un serveur​

Prérequis​

Configuration requise​

Connexion au serveur​

Mise à jour du système​

Installation de Docker et Docker Compose​

Obtenir les certificats TLS (Let's Encrypt)​

Téléchargement et extraction de Harbor​

Configuration de Harbor​

Lancement de l’installation​

Pare-feu​

Accès à Harbor​

Pousser une image vers Harbor​

Gestion et arrêt de Harbor​

En cas de problème​

La page Harbor ne s’affiche pas ou erreur HTTPS​

Les conteneurs ne démarrent pas​

Docker login échoue (x509, certificat)​

Références​