Einleitung
Esadax bietet eine private Container-Registrierung zur sicheren Speicherung und Verteilung von Docker-Images innerhalb Ihrer Organisation oder Ihrer Projekte. Dieser Leitfaden führt Sie durch das Einrichten, Authentifizieren und Verwenden der Registrierung in lokalen Umgebungen und CI/CD-Pipelines.
Lokale Docker-Einrichtung
Anmeldung bei der Registrierung
Verwenden Sie Docker CLI, um sich mit Ihrem persönlichen Zugriffstoken zu authentifizieren:
docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN
💡 Sie können dieses Token sicher in einer .env-Datei speichern oder pro Sitzung exportieren:export Esadax_REGISTRY_TOKEN=your_token_here
Bilder aufbauen und pushen
1 SGB V. Markieren Sie das Bild
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest
Zwei. Push an die Registrierung
docker push esadax-registry.esadax.sh/my-project/my-app:latest
3. Aus der Registrierung ziehen
docker pull esadax-registry.esadax.sh/my-project/my-app:latest
.docker/config.json (Optional)
Sie können Docker auch so konfigurieren, dass er sich Ihre Anmeldung merkt:
{
"auths": {
"esadax-registry.esadax.sh": {
"auth": "base64(username:Esadax_REGISTRY_TOKEN)"
}
}
}
Verwenden Sieecho -n "username:token" | base64, um den Wertauthzu generieren.
Integration von GitHub Actions
Verwenden Sie den folgenden Workflow, um Images während CI/CD-Ausführungen aus der Registrierung zu authentifizieren und zu ziehen/zu senden.
.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
Fügen SieEsadax_REGISTRY_TOKENundEsadax_USERNAMEzu Ihren GitHub-Repository-Geheimnissen für eine sichere Authentifizierung hinzu.
Tipps zur Fehlerbehebung
- 401 Unauthorized: Überprüfen Sie Ihren Token oder melden Sie sich mit
docker logoutund danndocker loginerneut an. - Tag Mismatch: Stellen Sie sicher, dass Ihr Bild-Tag genau mit dem übereinstimmt, was Sie schieben oder ziehen.
- Privater Zugriff: Stellen Sie sicher, dass das Bild unter Ihrem Projektumfang und Ihren Berechtigungen zugänglich ist.
Best Practices für Unternehmen
- Verwenden Sie kurzlebige Token oder automatisierungsspezifische Token für CI.
- Speichern Sie Token nicht direkt in Dockerfiles oder Code.
- Verwenden Sie semantisches Tagging (
v1.0.0,latest,devusw.), um Versionen zu organisieren.
Schlussfolgerung
Die private Container-Registrierung von Esadax bietet sicheres, skalierbares Hosting für Ihre Docker-Images. Wenn Sie diesen Leitfaden befolgen, können Sie ihn problemlos in Ihren lokalen Entwicklungsablauf und Ihre CI/CD-Pipelines integrieren. Wenn Probleme auftreten, lesen Sie die Dokumentation oder wenden Sie sich an den Esadax-Support.
