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. Para configurar tu bucket y clave de acceso, consulta la Documentación de MinIO. 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 Servidor Proxy HTTP en tu instancia de GitHub Enterprise Server, debes agregar
localhost
y127.0.0.1
a la lista de Exclusión de Proxy HTTP. 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
-
SSH en tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Acceder al shell administrativo (SSH)."
$ ssh -p 122 admin@HOSTNAME
-
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". -
Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
-
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.
-
En la barra lateral izquierda, haz clic en Consola de administración.
-
En la barra lateral izquierda, da clic en Acciones.
-
Selecciona Habilitar las GitHub Actions.
-
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
yMINIO_SECRET_KEY
que se utiliza para tu instancia de MinIO. Para obtener más información, consulta la Documentación de MinIO.
- URL de servicio de AWS: La URL para tu servicio de MinIO. Por ejemplo,
-
Debajo de "Almacenamiento de artefactos & bitácoras", selecciona Forzar el estilo de la ruta.
-
Debajo de la barra lateral izquierda, da clic en Guardar configuració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.
-
Espera a que la configuración se ejecute por completo.
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".