Publicación de imágenes en registros

Un registro de contenedores es un servicio seguro de almacenamiento en línea para sus imágenes de Docker. Considérelo como una unidad en la nube diseñada específicamente para los paquetes de su aplicación.

• Almacena distintas versiones de sus imágenes.
• Facilita compartir imágenes con otras personas.
• Es fundamental para realizar despliegues en distintos entornos.

Los registros son esenciales para el desarrollo de software moderno. Ofrecen varias ventajas importantes:

• Compartir imágenes: distribuir fácilmente las imágenes de su aplicación.
• Control de versiones: almacenar y gestionar distintas versiones de su aplicación.
• Despliegues fiables: garantizar despliegues coherentes en distintos entornos.
• Seguridad: muchos registros ofrecen análisis de vulnerabilidades.

Hay muchos servicios de registro de contenedores disponibles. Dos opciones populares con las que se encontrará a menudo son:

• Docker Hub: un registro público muy utilizado. Es ideal para compartir imágenes públicas y para proyectos personales.
• GitHub Container Registry (GHCR): está estrechamente integrado con los repositorios de GitHub. Es excelente para imágenes privadas y organizaciones que ya utilizan GitHub.

Otros proveedores importantes de servicios en la nube también ofrecen sus propios registros, como AWS ECR o Google Container Registry.

Antes de poder enviar una imagen a un registro, debe demostrar quién es. Este proceso se denomina autenticación o «iniciar sesión».

Normalmente, deberá proporcionar un nombre de usuario y un token de acceso personal (PAT) o una contraseña. Estas credenciales garantizan que solo los usuarios autorizados puedan enviar o extraer imágenes de sus repositorios privados.

En GitHub Actions, la mejor forma de autenticarse en la mayoría de los registros compatibles con Docker es utilizar docker/login-action.

Esta acción inicia sesión de forma segura en el registro especificado desde su workflow, lo que permite que los pasos posteriores envíen imágenes. Recibe username y password como entradas.

Para enviar una imagen a Docker Hub, su workflow debe:

1. Iniciar sesión: utilizar docker/login-action con su nombre de usuario de Docker Hub y un token de acceso personal (PAT) almacenado como GitHub Secret.
2. Crear y enviar: utilizar docker/build-push-action para crear la imagen y establecer push: true. Asegúrese de que la etiqueta de la imagen incluya su nombre de usuario de Docker Hub, por ejemplo, your_username/my-app:latest.

A continuación se muestra un ejemplo de workflow de GitHub Actions para crear y enviar una imagen de Docker a Docker Hub. Recuerde configurar DOCKER_USERNAME y DOCKER_TOKEN como GitHub Secrets en su repositorio.

GitHub Container Registry (GHCR) ofrece una integración fluida. Estas son las principales diferencias de GHCR:

• Autenticación: puede utilizar el GITHUB_TOKEN integrado para autenticarse. Establezca username: ${{ github.actor }} y password: ${{ secrets.GITHUB_TOKEN }}.
• Permisos: su job necesita el permiso packages: write.
• Etiquetado de imágenes: las imágenes se etiquetan como ghcr.io/<OWNER>/<REPOSITORY>:<TAG>.

Este workflow muestra cómo enviar una imagen a GitHub Container Registry. Observe el bloque de permissions y el formato de la etiqueta de la imagen.

¡Excelente trabajo! Ha aprendido a publicar imágenes de Docker en registros de contenedores mediante GitHub Actions.

• Los registros de contenedores almacenan y gestionan sus imágenes de Docker.
• La autenticación es un primer paso fundamental que requiere credenciales.
• docker/login-action le ayuda a iniciar sesión de forma segura.
• Ha visto ejemplos tanto de Docker Hub como de GitHub Container Registry, y ha comprendido sus requisitos específicos de autenticación y etiquetado.

A continuación, aprenderá a implementar estas imágenes en Kubernetes.