Introduzione

Esadax offre un registro container privato per archiviare e distribuire in modo sicuro le immagini Docker all'interno della tua organizzazione o dei tuoi progetti. Questa guida illustra la configurazione, l'autenticazione e l'utilizzo del registro in ambienti locali e pipeline CI/CD.

---

Configurazione locale di Docker

Accesso al Registro

Usa Docker CLI per autenticarti usando il tuo token di accesso personale:

docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN

💡 Puoi archiviare questo token in modo sicuro in un file .env o esportarlo per sessione:

export Esadax_REGISTRY_TOKEN=your_token_here

---

Costruire e spingere le immagini

1. Tagga l'immagine

docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest

2. Spingere al Registro

docker push esadax-registry.esadax.sh/my-project/my-app:latest

3. Estrazione dal Registro

docker pull esadax-registry.esadax.sh/my-project/my-app:latest

---

.docker/config.json (Facoltativo)

Puoi anche configurare Docker per ricordare il tuo login:

{
  "auths": {
    "esadax-registry.esadax.sh": {
      "auth": "base64(username:Esadax_REGISTRY_TOKEN)"
    }
  }
}

Utilizzare echo -n "username:token" | base64 per generare il valore auth.

---

Integrazione con GitHub Actions

Utilizzare il flusso di lavoro seguente per autenticare e prelevare/inviare immagini dal registro durante le esecuzioni 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

Aggiungi Esadax_REGISTRY_TOKEN e Esadax_USERNAME ai segreti del tuo repository GitHub per un'autenticazione sicura.

---

Suggerimenti per la risoluzione dei problemi

• 401 Non autorizzato: Ricontrolla il tuo token o accedi nuovamente usando docker logout e poi docker login.
• Tag Mismatch: Assicurati che il tag dell'immagine corrisponda esattamente a ciò che stai spingendo o tirando.
• Accesso privato: assicurati che l'immagine sia accessibile nell'ambito e con le autorizzazioni del tuo progetto.

---

Le migliori pratiche

• Utilizzare token a breve durata o token specifici per l'automazione per CI.
• Evitare di memorizzare i token direttamente nei file Dock o nel codice.
• Usa il tagging semantico (v1.0.0, latest, dev, ecc.) per organizzare le versioni.

---

Conclusione

Il registro container privato di Esadax fornisce un hosting sicuro e scalabile per le tue immagini Docker. Seguendo questa guida, puoi integrarlo facilmente nel tuo flusso di sviluppo locale e nelle pipeline CI/CD. Se si verificano problemi, fare riferimento alla documentazione o contattare il supporto Esadax.