Inledning
Esadax erbjuder ett privat behållarregister för säker lagring och distribution av Docker-bilder inom din organisation eller dina projekt. Den här guiden hjälper dig att konfigurera, autentisera och använda registret i lokala miljöer och CI/CD-pipelines.
Lokal Docker-inställning
Logga in i registret
Använd Docker CLI för att autentisera med din personliga åtkomsttoken:
docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN
💡 Du kan lagra denna token säkert i en .env-fil eller exportera den per session:export Esadax_REGISTRY_TOKEN=your_token_here
Bygga och skjuta bilder
100 mg två gånger dagligen. Tagga bilden
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest
2. Tryck till registret
docker push esadax-registry.esadax.sh/my-project/my-app:latest
3. Dra från registret
docker pull esadax-registry.esadax.sh/my-project/my-app:latest
.docker/config.json (valfritt)
Du kan också konfigurera Docker för att komma ihåg din inloggning:
{
"auths": {
"esadax-registry.esadax.sh": {
"auth": "base64(username:Esadax_REGISTRY_TOKEN)"
}
}
}
Användecho -n "username:token" | base64för att generera värdetauth.
Integrering av GitHub Actions
Använd följande arbetsflöde för att autentisera och dra/skjuta bilder från registret under CI/CD-körningar.
.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
Lägg tillEsadax_REGISTRY_TOKENochEsadax_USERNAMEtill dina GitHub-förrådshemligheter för säker autentisering.
Tips för felsökning
- 401 Unauthorized: Dubbelkolla din token eller logga in igen med
docker logoutoch sedandocker login. - Tag Mismatch: Se till att din bildtagg exakt matchar det du trycker eller drar.
- Privat åtkomst: Se till att bilden är tillgänglig enligt projektets omfattning och behörigheter.
De bästa metoderna
- Använd kortlivade tokens eller automationsspecifika tokens för CI.
- Undvik att lagra tokens direkt i Dock-filer eller kod.
- Använd semantisk märkning (
v1.0.0,latest,devosv.) för att organisera versioner.
Slutsats
Esadax privata behållarregister ger säker, skalbar hosting för dina Docker-bilder. Genom att följa den här guiden kan du enkelt integrera den i ditt lokala utvecklingsflöde och CI/CD-pipelines. Om du upplever problem, se dokumentationen eller nå ut till Esadax support.
