Prerrequisitos
Advertencia: Los únicos proveedores de almacenamiento de S3 compatibles son Amazon� S3 y MinIO Gateway for NAS. No hay soporte para otros proveedores de almacenamiento compatibles con la API de S3. Para más información sobre los proveedores de almacenamiento admitidos, vea "Introducción a Acciones de GitHub para GitHub Enterprise Server".
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
y127.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".
- Debes agregar
Habilitar GitHub Actions con almacenamiento de Amazon S3
-
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)".
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 .$ ssh -p 122 admin@HOSTNAME
-
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
1. En la barra lateral de la izquierda, haga clic en Consola de administración . 1. En la barra lateral de la izquierda, haga clic en Actions (acciones).
1. Seleccione Habilitar Acciones de GitHub.
-
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 serhttps://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".
1. En la barra lateral de la izquierda, haga clic en Guardar configuració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.
-
-
Espera que se complete la fase de configuración.
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".