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)"
    }
  }
}

Utilisez echo -n "username:token" | base64 pour générer la valeur auth.

---

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

Ajoutez Esadax_REGISTRY_TOKEN et Esadax_USERNAME aux 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 logout puis docker 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.