Habilitar las GitHub Actions con el almacenamiento de Amazon S3

Prerrequisitos

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

• Crea tu bucket de Amazon S3 para almacenar artefactos que generan las ejecuciones 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 Servidor Proxy HTTP en tu instancia de GitHub Enterprise Server, debes agregar localhost y 127.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 GitHub Actions con almacenamiento de Amazon S3

1. 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

2. Run the ghe-actions-precheck command to test your blob storage configuration. 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 .

   

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.

   

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

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

7. Selecciona 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 de servicio de tu bucket. Por ejemplo, si tu bucket de S3 se creó en la región us-west-2, este valor deberá ser https://s3.us-west-2.amazonaws.com.

     Para obtener más información, consulta la sección "terminales de servicio de AWS" en la documentación de AWS.

   • AWS S3 Bucket: El nombre de tu bucket de S3.

   • Clave de acceso de AWS S3 y Clave secreta de AWS S3: La ID de clave de acceso y clave secreta para tu bucket. Para obtener más información sobre cómo administrar las claves de acceso de AWS, consulta la "Documentación para la Administración de Accesos e Identidad de AWS".

   

9. 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.

10. 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".