Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
 

 

Habilitar las GitHub Actions con el almacenamiento de Amazon S3

In this article

Puedes habilitar GitHub Actions en GitHub Enterprise Server y utilizar el almacenamiento de Amazon S3 para almacenar datos generados por ejecuciones de flujos de trabajo.

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

Acerca del almacenamiento externo de GitHub Actions

GitHub Actions usa el almacenamiento de blobs externo para almacenar los datos que se generan con las ejecuciones de flujo de trabajo, como registros de flujo de trabajo, cachés, y artefactos de compilación cargados por el usuario. Para obtener más información, consulta Introducción a GitHub Actions para GitHub Enterprise Server.

Prerrequisitos

Advertencia: Los únicos proveedores de almacenamiento de S3 compatibles con GitHub son Amazon S3 y MinIO Gateway for NAS.

Hay otros productos de almacenamiento compatibles con la API de S3 que los partners de GitHub han autovalidado como compatibles con GitHub Actions en GitHub Enterprise Server. Para obtener más información, consulta el repositorio de partners de almacenamiento de GHES.

En el caso de los productos de almacenamiento validados a través del programa de asociación tecnológica GitHub, el proveedor de almacenamiento es responsable del soporte técnico y la documentación para usar el producto de almacenamiento con GitHub Actions.

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

  • Crea tu cubo de Amazon S3 para almacenar los datos 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 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 la ubicación del almacenamiento externo no es enrutable, también debes agregar la dirección URL del almacenamiento externo 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 GitHub Actions con almacenamiento de Amazon S3

  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 Management Console . Pestaña Management Console 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:

    • URL del servicio de AWS: la dirección URL del servicio del cubo. Por ejemplo, si el cubo de S3 se ha creado en la región us-west-2, este valor debe ser https://s3.us-west-2.amazonaws.com.

      Para más información, vea "Puntos de conexión del servicio AWS" en la documentación de AWS.

    • AWS S3 Bucket (Cubo de AWS S3): nombre del cubo de S3.

    • AWS S3 Access Key y AWS S3 Secret Key: el identificador de clave de acceso de AWS y la clave secreta para el cubo. Para más información sobre cómo administrar las claves de acceso de AWS,vea la "documentación sobre administración de identidades y accesos de AWS".

    Botón de radio para seleccionar Amazon S3 Storage y campos para la configuración de S3 1. Haz clic en el botón Probar configuración de almacenamiento para validar la configuración de almacenamiento.

    Si hay algún error al validar la configuración de almacenamiento, comprueba la configuración con el proveedor de almacenamiento e inténtalo de nuevo. 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 Management Console

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

  4. 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 correctamente, 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".