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:
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:export Esadax_REGISTRY_TOKEN=your_token_here
Construyendo y empujando imágenes
1. Aplicación. Etiqueta la imagen
docker tag my-app:latest esadax-registry.esadax.sh/my-project/my-app:latest
2. Empujar al Registro
docker push esadax-registry.esadax.sh/my-project/my-app:latest
3. Extraer desde el Registro
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:
{
"auths": {
"esadax-registry.esadax.sh": {
"auth": "base64(username:Esadax_REGISTRY_TOKEN)"
}
}
}
Utiliceecho -n "username:token" | base64para generar el valorauth.
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
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
AgregueEsadax_REGISTRY_TOKENyEsadax_USERNAMEa 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 logouty luegodocker 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.
