Inleiding
Esadax biedt een privé-containerregister voor het veilig opslaan en distribueren van Docker-afbeeldingen binnen uw organisatie of projecten. Deze handleiding leidt u door het instellen, verifiëren en gebruiken van het register in lokale omgevingen en CI/CD-pijplijnen.
Lokale Docker-instellingen
Aanmelden bij het register
Gebruik Docker CLI om te verifiëren met behulp van uw persoonlijke toegangstoken:
docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN
💡 U kunt dit token veilig opslaan in een .env-bestand of exporteren per sessie:export Esadax_REGISTRY_TOKEN=your_token_here
Afbeeldingen bouwen en pushen
1.1. Tag de afbeelding
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest
2. Push naar het register
docker push esadax-registry.esadax.sh/my-project/my-app:latest
Drie. Pull uit het register
docker pull esadax-registry.esadax.sh/my-project/my-app:latest
.docker/config.json (Optioneel)
U kunt Docker ook configureren om uw aanmelding te onthouden:
{
"auths": {
"esadax-registry.esadax.sh": {
"auth": "base64(username:Esadax_REGISTRY_TOKEN)"
}
}
}
Gebruikecho -n "username:token" | base64om de waardeauthte genereren.
Integratie met GitHub Actions
Gebruik de volgende workflow om afbeeldingen te verifiëren en te pull/push vanuit het register tijdens CI/CD-runs.
.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
VoegEsadax_REGISTRY_TOKENenEsadax_USERNAMEtoe aan je GitHub repository geheimen voor veilige authenticatie.
Tips voor probleemoplossing
- 401 Ongeautoriseerd: Controleer uw token of log opnieuw in met
docker logouten vervolgensdocker login. - Tag Mismatch: Zorg ervoor dat uw afbeeldingstag precies overeenkomt met wat u duwt of trekt.
- Privétoegang: Zorg ervoor dat de afbeelding toegankelijk is binnen het bereik en de machtigingen van uw project.
De beste praktijken
- Gebruik tokens met een korte levensduur of automatiseringsspecifieke tokens voor CI.
- Sla tokens niet rechtstreeks op in Dock-bestanden of code.
- Gebruik semantische tagging (
v1.0.0,latest,dev, enz.) om versies te organiseren.
Conclusie
De private container registry van Esadax biedt veilige, schaalbare hosting voor uw Docker images. Door deze handleiding te volgen, kunt u deze eenvoudig integreren in uw lokale ontwikkelingsstroom en CI / CD-pijplijnen. Als u problemen ondervindt, raadpleegt u de documentatie of neemt u contact op met de ondersteuning van Esadax.
