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

# Uso del registro de contenedores privados de Esadax
- URL: https://blog.esadax.com/es/uso-del-registro-de-contenedores-privados-de-esadax/
- Published: 2026-11-15T04:21:25.000Z
- Updated: 2026-11-15T04:21:25.000Z
- Author: Esadax 
- Tags: #tr-platform-20-infrastructure-23-registry-02-container-registry, #es, #mdx-imported, Platform

## I. INTRODUCCIÓN 1 - 2 3

Esadax ofrece un registro privado de contenedores para almacenar y distribuir imágenes de Docker de forma segura dentro de su organización o proyectos. En esta guía se explica cómo configurar, autenticar y usar el registro en entornos locales y canalizaciones de CI/CD.

---

## Configuración local de Docker

### Iniciar sesión en el Registro

Usa la CLI de Docker para autenticarte con tu token de acceso personal:

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

```

> 💡 Puedes almacenar este token de forma segura en un archivo `.env` o exportarlo por sesión:

```bash
export Esadax_REGISTRY_TOKEN=your_token_here

```

---

## Construyendo y empujando imágenes

### 1\. Aplicación. Etiqueta la imagen

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

```

### 2\. Empujar al Registro

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

```

### 3\. Extraer desde el Registro

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

```

---

## .docker/config.json (Opcional)

También puedes configurar Docker para que recuerde tu inicio de sesión:

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

```

> Utilice `echo -n "username:token" | base64` para generar el valor `auth`.

---

## Integración de GitHub Actions

Utilice el siguiente flujo de trabajo para autenticar y extraer/enviar imágenes desde el registro durante las ejecuciones de 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

```

> Agregue `Esadax_REGISTRY_TOKEN` y `Esadax_USERNAME` a los secretos de su repositorio de GitHub para una autenticación segura.

---

## Consejos de solución de problemas

- **401 No autorizado**: Compruebe dos veces su token o vuelva a iniciar sesión usando `docker logout` y luego `docker login`.
- **Tag Mismatch**: Asegúrate de que tu etiqueta de imagen coincida exactamente con lo que estás empujando o tirando.
- **Acceso privado**: Asegúrese de que la imagen sea accesible bajo el alcance y los permisos de su proyecto.

---

## Las mejores prácticas

- Utilice tokens de corta duración o tokens específicos de automatización para CI.
- Evite almacenar tokens directamente en Dockerfiles o código.
- Use el etiquetado semántico (`v1.0.0`, `latest`, `dev`, etc.) para organizar las versiones.

---

## IV. Conclusión

El registro de contenedores privados de Esadax proporciona un alojamiento seguro y escalable para sus imágenes de Docker. Siguiendo esta guía, puedes integrarlo fácilmente en tu flujo de desarrollo local y en tus canalizaciones de CI/CD. Si experimenta problemas, consulte la documentación o póngase en contacto con el soporte de Esadax.