I. INTRODUCTION
Esadax propose un registre de conteneurs privés pour stocker et distribuer en toute sécurité des images Docker au sein de votre organisation ou de vos projets. Ce guide vous explique comment configurer, authentifier et utiliser le registre dans les environnements locaux et les pipelines CI/CD.
Configuration locale de Docker
Se connecter au registre
Utilisez Docker CLI pour vous authentifier à l'aide de votre jeton d'accès personnel:
docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN
💡 Vous pouvez stocker ce jeton en toute sécurité dans un fichier .env ou l’exporter par session :export Esadax_REGISTRY_TOKEN=your_token_here
Construire et pousser des images
1. Développement durable Marquer l'image
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest
2. Pousser vers le registre
docker push esadax-registry.esadax.sh/my-project/my-app:latest
3. Développement Tirer à partir du registre
docker pull esadax-registry.esadax.sh/my-project/my-app:latest
.docker/config.json (facultatif)
Vous pouvez également configurer Docker pour qu'il se souvienne de votre connexion:
{
"auths": {
"esadax-registry.esadax.sh": {
"auth": "base64(username:Esadax_REGISTRY_TOKEN)"
}
}
}
Utilisezecho -n "username:token" | base64pour générer la valeurauth.
Intégration de GitHub Actions
Utilisez le flux de travail suivant pour authentifier et extraire/insérer des images à partir du registre pendant les exécutions CI/CD.
.github/workflows/registry.yml
name: Docker Registry CI
on:
push:
branches: [ main ]
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: Log in to Esadax Registry
run: echo "${{ secrets.Esadax_REGISTRY_TOKEN }}" | docker login esadax-registry.esadax.sh -u ${{ secrets.Esadax_USERNAME }} --password-stdin
- name: Build Docker image
run: docker build -t esadax-registry.esadax.sh/my-project/my-app:latest .
- name: Push to Registry
run: docker push esadax-registry.esadax.sh/my-project/my-app:latest
AjoutezEsadax_REGISTRY_TOKENetEsadax_USERNAMEaux secrets de votre dépôt GitHub pour une authentification sécurisée.
Conseils de dépannage
- 401 Non autorisé : Vérifiez votre jeton ou reconnectez-vous en utilisant
docker logoutpuisdocker login. - Tag Mismatch: Assurez-vous que votre balise d'image correspond exactement à ce que vous poussez ou tirez.
- Accès privé : Assurez-vous que l'image est accessible dans le cadre de votre projet et de vos autorisations.
Les meilleures pratiques
- Utilisez des jetons à courte durée de vie ou des jetons spécifiques à l'automatisation pour CI.
- Évitez de stocker des jetons directement dans des fichiers Dock ou du code.
- Utilisez le balisage sémantique (
v1.0.0,latest,dev, etc.) pour organiser les versions.
IV. CONCLUSION
Le registre de conteneurs privés d’Esadax fournit un hébergement sécurisé et évolutif pour vos images Docker. En suivant ce guide, vous pouvez facilement l'intégrer à votre flux de développement local et à vos pipelines CI/CD. Si vous rencontrez des problèmes, reportez-vous à la documentation ou contactez le support Esadax.
