adding features

2025-04-02 23:14:12 +02:00
parent a79c335b73
commit 01c81bfb1a
10 changed files with 2450 additions and 0 deletions
@@ -0,0 +1,54 @@
+# Configuración para Docker Hub y GitHub Actions
+
+Este documento explica cómo configurar los secretos necesarios para publicar imágenes de Docker en Docker Hub usando GitHub Actions.
+
+## Requisitos previos
+
+1. Una cuenta en [Docker Hub](https://hub.docker.com/)
+2. Un repositorio en Docker Hub donde subir la imagen
+3. Un token de acceso personal (PAT) de Docker Hub
+
+## Pasos para configurar los secretos en GitHub
+
+1. Genera un token de acceso en Docker Hub
+   - Inicia sesión en [Docker Hub](https://hub.docker.com/)
+   - Ve a tu perfil (esquina superior derecha) → Account Settings → Security
+   - Haz clic en "New Access Token"
+   - Proporciona una descripción como "GitHub Actions"
+   - Selecciona los permisos apropiados (normalmente "Read, Write, Delete")
+   - Haz clic en "Generate"
+   - **IMPORTANTE**: Copia el token generado, ya que no podrás verlo de nuevo
+
+2. Configura los secretos en tu repositorio de GitHub
+   - Ve a tu repositorio en GitHub
+   - Haz clic en "Settings" → "Secrets and variables" → "Actions"
+   - Haz clic en "New repository secret"
+   - Añade los siguientes secretos:
+     - Nombre: `DOCKERHUB_USERNAME` 
+       Valor: Tu nombre de usuario de Docker Hub
+     - Nombre: `DOCKERHUB_TOKEN`
+       Valor: El token de acceso que generaste en el paso anterior
+
+## Uso
+
+Una vez configurados los secretos, los flujos de trabajo de GitHub Actions podrán autenticarse con Docker Hub y publicar imágenes. 
+
+Cuando crees una nueva [release en GitHub](https://docs.github.com/es/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release), el flujo de trabajo `docker-publish.yml` se activará automáticamente y:
+
+1. Construirá la imagen de Docker
+2. La etiquetará con el número de versión de la release
+3. La subirá a Docker Hub
+
+## Verificación
+
+Para verificar que la configuración está correcta:
+
+1. Crea una nueva release en GitHub
+2. Ve a la pestaña "Actions" y observa el progreso del flujo de trabajo
+3. Una vez completado, verifica que la imagen aparezca en tu repositorio de Docker Hub
+
+## Notas adicionales
+
+- Para entornos de producción, considera usar un usuario de servicio en Docker Hub en lugar de tu cuenta personal
+- Rota regularmente los tokens de acceso para mayor seguridad
+- Considera agregar escaneo de vulnerabilidades en las imágenes como parte del flujo de trabajo