Skip to main content

Habilitar las GitHub Actions con la puerta de enlace de MinIO para el almacenamiento en NAS

Puedes habilitar las GitHub Actions en GitHub Enterprise Server y utilizar MinIO Gateway para almacenamiento de NAS para almacenar los datos que generan las ejecuciones de flujo de trabajo.

Site administrators can enable GitHub Actions and configure enterprise settings.

Advertencia: MinIO anunció la eliminación de MinIO Gateways. Desde el 1 de junio de 2022, tanto el soporte como las correcciones de errores para la implementación de la puerta de enlace de la NAS de MinIO estarán disponibles únicamente para los clientes con suscripciones de pago a través de su contrato de soporte LTS. Si quieres seguir utilizando MinIO Gateways con GitHub Actions, te recomendamos migrarte al soporte LTS de MinIO. Para obtener más información, consulta el programa para eliminar a MinIO Gateway para GCS, Azure, HDFS en el repositorio minio/minio.

Prerrequisitos

Antes de que habilites las GitHub Actions, asegúrate de que has completado los siguientes pasos:

  • Para evitar la contención de recursos en el aplicativo, te recomendamos que hospedes a MinIO separado de tu instancia de GitHub Enterprise Server.

  • Crea tu bucket para almacenar datos de flujo de trabajo. GitHub Actions requiere los siguientes permisos para la clave de acceso que accederá al bucket:

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey (si se habilitó el cifrado del servicio de administración de llaves (KMS))
  • Revisa los requisitos de hardware de las GitHub Actions. Para obtener más información, consulta la sección "Iniciar con las GitHub Actions para GitHub Enterprise Server".

  • Se debe configurar el TLS para el dominio de tu instancia de GitHub Enterprise Server. Para obtener más información, consulta la sección "Configurar el TLS".

    Nota:Te recomendamos ampliamente que configures el TLS en GitHub Enterprise Server con un certificado que firme una autoridad confiable. Aunque un certificado auto-firmado podría funcionar, se requeriría una configuración adicional para tus ejecutores auto-hospedados y esto no se recomienda para los ambientes productivos.

  • Si tienes configurado un HTTP Proxy Server en tu instancia de GitHub Enterprise Server:

    • Debes agregar localhost y 127.0.0.1 a la lista HTTP Proxy Exclusion.
    • Si el bucket de BYOS no es enrutable, entonces también debes agregar la URL del bucket a la lista de exclusión.

    Para obtener más información sobre cómo cambiar tu configuración de proxy, consulta la sección "Configurar un servidor de proxy web saliente".

Habilitar las GitHub Actions con la puerta de enlace de MinIO para almacenamiento en NAS

  1. SSH en tu instancia de GitHub Enterprise Server. Si tu instancia comprende nodos múltiples, por ejemplo, si se configuraron la disponibilidad alta o la geo-replicación, ingresa por SSH al nodo primario. Si utilizas un clúster, puedes ingresar por SSH a cualquier nodo. Para obtener más información sobre el acceso por SSH, consulta la sección "Acceder al shell administrativo (SSH)".

    $ ssh -p 122 admin@HOSTNAME
  2. Ejecuta el comando ghe-actions-precheck para probar tu configuración de almacenamiento de blobs. Para obtener más información, consulta la sección "Utilidades de línea de comandos".

  3. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

    Captura de pantalla del icono de cohete para acceder a los ajustes administrativos

  4. Si aún no estás en la página de "Administrador de sitio", en la esquina inferior izquierda, haz clic en Administrador de sitio.

    Captura de pantalla del enlace de "Administrador de sitio"

  5. En la barra lateral izquierda, haz clic en Consola de administración. pestaña Consola de administración en la barra lateral izquierda

  6. En la barra lateral izquierda, da clic en Acciones.

    Pestaña de acciones en la barra lateral de configuración

  7. Selecciona Habilitar las GitHub Actions. Casilla de verificación para habilitar las GitHub Actions

  8. Debajo de "Almacenamiento de artefactos & bitácoras", selecciona Amazon S3, e ingresa los detalles de tu bucket de almacenamiento:

    • URL de servicio de AWS: La URL para tu servicio de MinIO. Por ejemplo, https://my-minio.example:9000.
    • AWS S3 Bucket: El nombre de tu bucket de S3.
    • Clave de AWS S3 Access y Clave de AWS S3 Secret: La MINIO_ACCESS_KEY y MINIO_SECRET_KEY que se utiliza para tu instancia de MinIO.

    Botón radial para seleccionar el almacenamiento de Amazon S3 y los campos para la configuración de MinIO

  9. Debajo de "Almacenamiento de artefactos & bitácoras", selecciona Forzar el estilo de la ruta. Casilla de verificación para forzar el estilo de ruta

  10. Debajo de la barra lateral izquierda, da clic en Guardar configuración.

    Captura de pantalla del botón para guardar los ajustes en la Consola de administración

    Nota: El guardar los ajustes en la Consola de administración restablece los servicios de sistema, lo cual podría dar como resultado un tiempo de inactividad visible.

  11. Espera a que la configuración se ejecute por completo.

    Configurar tu instancia

Pasos siguientes

Después de que la ejecución de configuración se haya completado con éxito, GitHub Actions se habilitará en tu instancia de GitHub Enterprise Server. Para tus siguientes pasos, tales como adminsitrar los permisos de acceso para las GitHub Actions y agregar ejecutores auto-hospedados, regresa a "Iniciar con GitHub Actions para GitHub Enterprise Server".