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)"
}
}
}
Utilizzareecho -n "username:token" | base64per generare il valoreauth.
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
AggiungiEsadax_REGISTRY_TOKENeEsadax_USERNAMEai 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 logoute poidocker 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.
