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
- Allez dans votre projet
- Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet dans la barre latérale
- Sélectionnez l'onglet Docker Registry
- Cliquez sur Ajouter un Registre
- 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
- URL du Registre : Le nom d'hôte du registre (ex :
- 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 :
| Statut | Signification |
|---|---|
| Installing | Stocké, en cours de déploiement dans le projet |
| In use | Actif et disponible pour les workloads |
| Not installed | Impossible à installer (nouvelle tentative automatique) |
| Removing | Suppression 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).
| Registre | Format d'URL |
|---|---|
| Docker Hub | docker.io |
| GitHub | ghcr.io |
| GitLab | registry.gitlab.com |
| AWS ECR | <compte>.dkr.ecr.<région>.amazonaws.com |
| GCR | gcr.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
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)
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
- Vérifier les registres du projet pour une URL correspondante
- Revenir aux identifiants par défaut (si configurés)
- 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 :
| Image | Registre Correspondant |
|---|---|
nginx:latest | Docker Hub |
ghcr.io/org/app:v1 | GitHub |
registry.internal.entreprise.com/app:v1 | Privé |
Gérer les Registres
Voir les Registres
- Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet
- Sélectionnez l'onglet Docker Registry
- 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
- Ouvrez la modale Ajouter un Registre ou Modifier
- Renseignez l'URL du registre, le nom d'utilisateur et le mot de passe
- 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. - Cliquez sur Tester la Connexion
Tester un identifiant enregistré
- Cliquez sur Test sur la ligne de l'identifiant
- Renseignez éventuellement une référence d'image à vérifier
- 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:packagesetread_registryrespectivement) - 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)
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.
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
- Cliquez sur Modifier sur le registre
- Mettez à jour le nom d'utilisateur, le mot de passe/token ou l'email
- 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.
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
- Cliquez sur Supprimer sur le registre
- 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.
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 :
| Registre | Scope Minimum |
|---|---|
| Docker Hub | Token d'accès en lecture seule |
| GitHub | read:packages |
| GitLab | read_registry |
| AWS ECR | ecr: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
- Vérifiez que l'URL du registre correspond à l'image
- Vérifiez que les identifiants sont valides
- Testez la connexion dans les paramètres
Erreur : unauthorized: authentication required
- Mettez à jour le mot de passe/token du registre
- Assurez-vous que le token a les scopes requis
- Vérifiez que le token n'a pas expiré
Erreur : manifest unknown
- Vérifiez que le tag de l'image existe
- Vérifiez l'architecture de l'image (amd64 requis)
- Assurez-vous que l'image est poussée sur le registre
Token ECR Expiré
Pour AWS ECR :
- Vérifiez que les identifiants IAM sont valides
- Vérifiez que les permissions IAM incluent l'accès ECR
- 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 :
- Ajoutez les identifiants Docker Hub
- Mirrorez les images vers un registre privé
- Mettez à niveau votre plan Docker Hub