Startseite/Artikel
Esadax JournalPlatform

Verwendung der privaten Container-Registrierung von Esadax

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

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 Sie echo -n "username:token" | base64, um den Wert auth zu 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 Sie Esadax_REGISTRY_TOKEN und Esadax_USERNAME zu 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 logout und dann docker login erneut 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, dev usw.), 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.

Abonnieren