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

# Utilizzo del Private Container Registry di Esadax
- URL: https://blog.esadax.com/it/utilizzo-del-private-container-registry-di-esadax/
- Published: 2026-11-15T04:22:09.000Z
- Updated: 2026-11-15T04:22:09.000Z
- Author: Esadax 
- Tags: #tr-platform-20-infrastructure-23-registry-02-container-registry, #it, #mdx-imported, Platform

## Introduzione

Esadax offre un registro container privato per archiviare e distribuire in modo sicuro le immagini Docker all'interno della tua organizzazione o dei tuoi progetti. Questa guida illustra la configurazione, l'autenticazione e l'utilizzo del registro in ambienti locali e pipeline CI/CD.

---

## Configurazione locale di Docker

### Accesso al Registro

Usa Docker CLI per autenticarti usando il tuo token di accesso personale:

```bash
docker login esadax-registry.esadax.sh -u your-username -p $Esadax_REGISTRY_TOKEN

```

> 💡 Puoi archiviare questo token in modo sicuro in un file `.env` o esportarlo per sessione:

```bash
export Esadax_REGISTRY_TOKEN=your_token_here

```

---

## Costruire e spingere le immagini

### 1\. Tagga l'immagine

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

```

### 2\. Spingere al Registro

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

```

### 3\. Estrazione dal Registro

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

```

---

## .docker/config.json (Facoltativo)

Puoi anche configurare Docker per ricordare il tuo login:

```json
{
  "auths": {
    "esadax-registry.esadax.sh": {
      "auth": "base64(username:Esadax_REGISTRY_TOKEN)"
    }
  }
}

```

> Utilizzare `echo -n "username:token" | base64` per generare il valore `auth`.

---

## Integrazione con GitHub Actions

Utilizzare il flusso di lavoro seguente per autenticare e prelevare/inviare immagini dal registro durante le esecuzioni CI/CD.

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

```

> Aggiungi `Esadax_REGISTRY_TOKEN` e `Esadax_USERNAME` ai segreti del tuo repository GitHub per un'autenticazione sicura.

---

## Suggerimenti per la risoluzione dei problemi

- **401 Non autorizzato**: Ricontrolla il tuo token o accedi nuovamente usando `docker logout` e poi `docker login`.
- **Tag Mismatch**: Assicurati che il tag dell'immagine corrisponda esattamente a ciò che stai spingendo o tirando.
- **Accesso privato**: assicurati che l'immagine sia accessibile nell'ambito e con le autorizzazioni del tuo progetto.

---

## Le migliori pratiche

- Utilizzare token a breve durata o token specifici per l'automazione per CI.
- Evitare di memorizzare i token direttamente nei file Dock o nel codice.
- Usa il tagging semantico (`v1.0.0`, `latest`, `dev`, ecc.) per organizzare le versioni.

---

## Conclusione

Il registro container privato di Esadax fornisce un hosting sicuro e scalabile per le tue immagini Docker. Seguendo questa guida, puoi integrarlo facilmente nel tuo flusso di sviluppo locale e nelle pipeline CI/CD. Se si verificano problemi, fare riferimento alla documentazione o contattare il supporto Esadax.