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änd echo -n "username:token" | base64 för att generera värdet auth.

---

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 till Esadax_REGISTRY_TOKEN och Esadax_USERNAME till 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 logout och sedan docker 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, dev osv.) 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.