> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Verwendung der privaten Container-Registrierung von Esadax
- URL: https://blog.esadax.com/de/verwendung-der-privaten-container-registrierung-von-esadax-2/
- Published: 2025-08-21T00:00:00.000Z
- Updated: 2026-11-15T05:35:32.000Z
- Author: Esadax 
- Tags: #tr-platform-20-infrastructure-23-registry-02-container-registry, #de, #mdx-imported, Platform

## 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:

```bash
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:

```bash
export Esadax_REGISTRY_TOKEN=your_token_here

```

---

## Bilder aufbauen und pushen

### 1 SGB V. Markieren Sie das Bild

```bash
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest

```

### Zwei. Push an die Registrierung

```bash
docker push esadax-registry.esadax.sh/my-project/my-app:latest

```

### 3\. Aus der Registrierung ziehen

```bash
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:

```json
{
  "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`

```yaml
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.