Skip to main content

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

Puedes habilitar GitHub Actions en GitHub Enterprise Server y utilizar la puerta de enlace de MinIO para el almacenamiento en NAS a fin de almacenar datos que generan las ejecuciones del flujo de trabajo.

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

Advertencia: MinIO ha anunciado la eliminación de puertas de enlace de MinIO. A partir del 1 de junio de 2022, el soporte técnico y las correcciones de errores para la implementación actual de la puerta de enlace NAS de MinIO solo estarán disponibles para los clientes de pago a través de su contrato de soporte técnico LTS. Si quieres seguir usando puertas de enlace de MinIO con GitHub Actions, se recomienda pasar a la compatibilidad con MinIO LTS. Para obtener más información, consulta Eliminación programada de la puerta de enlace MinIO para GCS, Azure, HDFS en el repositorio de 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 your GitHub Enterprise Server instance.

  • Crea un cubo para almacenar los datos del 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 ha habilitado el cifrado de Key Management Service [KMS])
  • Revisa los requisitos de hardware de las GitHub Actions. Para obtener más información, consulte "Introducción a GitHub Actions para GitHub Enterprise Server".

  • Se debe configurar el TLS para el dominio de your GitHub Enterprise Server instance. Para obtener más información, consulte "Configuración de 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 un servidor proxy HTTP configurado en your GitHub Enterprise Server instance:

    • Debes agregar localhost y 127.0.0.1 a la lista de exclusión de proxy HTTP.
    • Si el cubo BYOS no es enrutable, también debes agregar la dirección URL del cubo a la lista de exclusión.

    Para más información sobre cómo cambiar la configuración del proxy, vea "Configuración de un servidor proxy web saliente".

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

  1. SSH en your GitHub Enterprise Server instance. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Para obtener más información acerca del acceso a SSH, consulta "Acceso al shell administrativo (SSH)".

    $ ssh -p 122 admin@HOSTNAME
    1. Ejecuta el comando `ghe-actions-precheck` para probar tu configuración de almacenamiento de blobs. Para más información, vea "[Utilidades de línea de comandos](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-actions-precheck)". 1. 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

  2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

    Captura de pantalla del vínculo "Administrador del sitio" 1. En la barra lateral de la izquierda, haga clic en Consola de administración . Pestaña Consola de administración en la barra lateral de la izquierda 1. En la barra lateral de la izquierda, haga clic en Actions (acciones).

    Pestaña de acciones en la barra lateral de configuración 1. Seleccione Habilitar Acciones de GitHub. Casilla para habilitar Acciones de GitHub

  3. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione Amazon S3 y escriba los detalles del cubo de almacenamiento:

    • AWS Service URL (URL del servicio AWS): dirección URL del servicio MinIO. Por ejemplo, https://my-minio.example:9000.
    • AWS S3 Bucket (Cubo de AWS S3): nombre del cubo de S3.
    • AWS S3 Access Key (Clave de acceso de AWS S3) y AWS S3 Secret Key (Clave de secreto de AWS S3): se usan MINIO_ACCESS_KEY y MINIO_SECRET_KEY para la instancia de MinIO.

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

  4. En "Artifact & Log Storage" (Almacenamiento de artefactos y registros), seleccione Force path style (Forzar estilo de ruta de acceso). Casilla Force path style (Forzar estilo de ruta de acceso) 1. En la barra lateral de la izquierda, haga clic en Guardar configuración.

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

    Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

  5. Espera que se complete la fase de configuración.

    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 your GitHub Enterprise Server instance. Para los pasos siguientes, como administrar los permisos de acceso de GitHub Actions y agregar ejecutores autohospedados, vuelva a "Introducción a GitHub Actions para GitHub Enterprise Server".