Aller au contenu principal

Docker Registry

Récupérez des images de conteneurs depuis des registres privés pour vos déploiements.

Vue d'Ensemble​

SailOps prend en charge la connexion à des Docker Registries privés, vous permettant de déployer des conteneurs depuis :

  • Docker Hub (dépôts privés)
  • GitHub Container Registry (ghcr.io)
  • GitLab Container Registry
  • AWS ECR
  • Google Container Registry (GCR)
  • Azure Container Registry (ACR)
  • Registres auto-hébergés

Ajouter un Registre​

Étapes​

  1. Allez dans votre projet
  2. Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet dans la barre latérale
  3. Sélectionnez l'onglet Docker Registry
  4. Cliquez sur Ajouter un Registre
  5. Remplissez les détails :
    • URL du Registre : Le nom d'hôte du registre (ex : docker.io, ghcr.io). Il ne peut pas être modifié par la suite.
    • Nom d'utilisateur : Nom d'utilisateur pour l'authentification
    • Mot de passe/Token : Secret d'authentification
    • Email : Email optionnel pour l'authentification au registre
  6. Cliquez sur Enregistrer

L'identifiant est stocké immédiatement et le pull secret apparaît dans votre projet en quelques secondes. La colonne Statut suit la progression :

StatutSignification
InstallingStocké, en cours de déploiement dans le projet
In useActif et disponible pour les workloads
Not installedImpossible à installer (nouvelle tentative automatique)
RemovingSuppression en cours

Format d'URL du Registre​

Saisissez le registre sous forme de nom d'hôte ou d'URL HTTPS. SailOps normalise automatiquement les variantes courantes (par exemple index.docker.io et registry-1.docker.io sont résolus en docker.io).

RegistreFormat d'URL
Docker Hubdocker.io
GitHubghcr.io
GitLabregistry.gitlab.com
AWS ECR<compte>.dkr.ecr.<région>.amazonaws.com
GCRgcr.io ou <région>-docker.pkg.dev
ACR<registre>.azurecr.io
Auto-hébergéregistry.exemple.com

Configuration du Registre​

Docker Hub​

URL: docker.io
Username: votre-nom-utilisateur-docker
Password: votre-token-acces
Token d'Accès

Utilisez un Token d'Accès Docker Hub au lieu de votre mot de passe. Créez-en un sur hub.docker.com/settings/security.

GitHub Container Registry​

URL: ghcr.io
Username: votre-nom-utilisateur-github
Password: ghp_xxxxxxxxxxxx

Créez un Personal Access Token avec le scope read:packages.

GitLab Container Registry​

URL: registry.gitlab.com
Username: votre-nom-utilisateur-gitlab
Password: glpat-xxxxxxxxxxxx

Créez un Project Access Token avec le scope read_registry.

AWS ECR​

URL: 123456789.dkr.ecr.eu-west-1.amazonaws.com
Username: AWS
Password: (token d'authentification ECR)
Authentification ECR

Les tokens AWS ECR expirent après 12 heures. SailOps les rafraîchit automatiquement lors de l'utilisation des identifiants IAM.

Pour ECR, vous pouvez également utiliser :

  • Clé d'Accès IAM + Clé Secrète
  • Rôle IAM (pour les clusters gérés SailOps)

Google Container Registry​

URL: gcr.io
Username: _json_key
Password: (JSON du compte de service)

Créez un compte de service avec le rôle Storage Object Viewer.

Azure Container Registry​

URL: monregistre.azurecr.io
Username: id-du-service-principal
Password: secret-du-service-principal

Créez un service principal avec le rôle AcrPull.

Utiliser des Images Privées​

Dans la Configuration du Conteneur​

Lors de la création d'un conteneur, référencez votre image privée :

Image: ghcr.io/monorg/monapp:latest

SailOps utilise automatiquement les identifiants du registre correspondant.

Priorité de Récupération d'Image​

  1. Vérifier les registres du projet pour une URL correspondante
  2. Revenir aux identifiants par défaut (si configurés)
  3. Tenter une récupération anonyme (images publiques)

Registres Multiples​

Vous pouvez ajouter plusieurs registres à un projet :

Projet : Production
├── Docker Hub (docker.io)
├── GitHub (ghcr.io)
└── Privé (registry.internal.entreprise.com)

Correspondance de Registre​

SailOps fait correspondre les registres par préfixe d'URL :

ImageRegistre Correspondant
nginx:latestDocker Hub
ghcr.io/org/app:v1GitHub
registry.internal.entreprise.com/app:v1Privé

Gérer les Registres​

Voir les Registres​

  1. Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet
  2. Sélectionnez l'onglet Docker Registry
  3. Voir tous les registres configurés et leur statut de connexion

Tester la Connexion​

Il existe deux façons de tester les identifiants :

Tester lors de l'ajout ou de la modification​

  1. Ouvrez la modale Ajouter un Registre ou Modifier
  2. Renseignez l'URL du registre, le nom d'utilisateur et le mot de passe
  3. Renseignez éventuellement une Image à tester (ex : ghcr.io/team/app:1.0). L'image doit être sur le même registre que l'identifiant. Lorsqu'elle est fournie, SailOps demande au registre le manifeste de cette image pour prouver que l'identifiant peut la récupérer.
  4. Cliquez sur Tester la Connexion

Tester un identifiant enregistré​

  1. Cliquez sur Test sur la ligne de l'identifiant
  2. Renseignez éventuellement une référence d'image à vérifier
  3. Cliquez sur Run test

Le mot de passe enregistré est utilisé directement — vous n'avez pas besoin de le saisir à nouveau.

Résultats du test​

Les deux tests rapportent :

  • Détection du fournisseur (Docker Hub, GitHub, GitLab ou générique)
  • Statut d'authentification auprès du registre
  • Vérification des scopes pour les tokens GitHub et GitLab (vérifie read:packages et read_registry respectivement)
  • Scopes manquants si le token ne dispose pas des permissions de lecture requises

Lorsqu'une image est fournie, deux résultats supplémentaires sont possibles :

  • Image introuvable — les identifiants fonctionnent mais le registre n'a pas ce tag ou ce digest
  • Image interdite — les identifiants fonctionnent mais ne peuvent pas récupérer cette image (elle n'existe pas, ou le compte n'y a pas accès)
Test avec une image

Le test avec une image fonctionne sur n'importe quel registre. Sans image, seuls les tokens GitHub et GitLab peuvent voir leurs permissions vérifiées au-delà de l'authentification de base.

Vérification des scopes

Pour les registres GitHub et GitLab, SailOps vérifie que votre token possède les scopes nécessaires pour récupérer des images. Si des scopes sont manquants, le résultat du test les liste afin que vous puissiez mettre à jour le token.

Mettre à Jour les Identifiants​

  1. Cliquez sur Modifier sur le registre
  2. Mettez à jour le nom d'utilisateur, le mot de passe/token ou l'email
  3. Cliquez sur Enregistrer

Le registre auquel un identifiant s'authentifie ne peut pas être modifié. Pour changer de registre, supprimez l'identifiant et ajoutez-en un nouveau.

Rotation des Identifiants

Lors de la rotation des identifiants, mettez-les à jour dans SailOps avant de révoquer les anciens pour éviter les échecs de déploiement.

Supprimer un Registre​

  1. Cliquez sur Supprimer sur le registre
  2. Confirmez la suppression

L'identifiant passe au statut Removing pendant que le pull secret est supprimé du projet. Une fois terminé, l'identifiant disparaît de la liste et le registre redevient disponible pour un nouvel identifiant.

Conteneurs Actifs

Assurez-vous qu'aucun conteneur en cours d'exécution n'utilise des images de ce registre avant de le supprimer. Un workload en cours d'exécution conserve l'image qu'il a déjà récupérée, mais ne pourra plus en récupérer une fois l'identifiant supprimé.

Bonnes Pratiques de Sécurité​

1. Utiliser des Tokens d'Accès​

N'utilisez jamais les mots de passe de compte :

✓ Tokens d'Accès Docker Hub
✓ Personal Access Tokens GitHub
✓ Project Access Tokens GitLab

✗ Mots de passe de compte

2. Permissions Minimales​

N'accordez que les permissions requises :

RegistreScope Minimum
Docker HubToken d'accès en lecture seule
GitHubread:packages
GitLabread_registry
AWS ECRecr:GetAuthorizationToken, ecr:BatchGetImage

3. Identifiants Séparés par Environnement​

Projet Production → Identifiants registre production
Projet Staging → Identifiants registre staging

4. Rotation Régulière​

Faites tourner les identifiants périodiquement :

  • Tous les 90 jours pour une utilisation standard
  • Immédiatement après le départ d'un membre de l'équipe
  • Après tout incident de sécurité

Dépannage​

Erreurs de Récupération d'Image​

Erreur : ImagePullBackOff

  1. Vérifiez que l'URL du registre correspond à l'image
  2. Vérifiez que les identifiants sont valides
  3. Testez la connexion dans les paramètres

Erreur : unauthorized: authentication required

  1. Mettez à jour le mot de passe/token du registre
  2. Assurez-vous que le token a les scopes requis
  3. Vérifiez que le token n'a pas expiré

Erreur : manifest unknown

  1. Vérifiez que le tag de l'image existe
  2. Vérifiez l'architecture de l'image (amd64 requis)
  3. Assurez-vous que l'image est poussée sur le registre

Token ECR Expiré​

Pour AWS ECR :

  1. Vérifiez que les identifiants IAM sont valides
  2. Vérifiez que les permissions IAM incluent l'accès ECR
  3. SailOps rafraîchit automatiquement les tokens

Limitation de Débit​

Docker Hub a des limites de débit :

  • Anonyme : 100 pulls/6 heures
  • Authentifié : 200 pulls/6 heures
  • Payant : Illimité

Solutions :

  1. Ajoutez les identifiants Docker Hub
  2. Mirrorez les images vers un registre privé
  3. Mettez à niveau votre plan Docker Hub

Sujets Connexes​