Habilitación del acceso automático a acciones de GitHub.com mediante GitHub Connect

Para permitir que GitHub Actions en la empresa use acciones desde GitHub.com, puede conectar la instancia empresarial a GitHub Enterprise Cloud.

¿Quién puede utilizar esta característica?

Enterprise owners can enable access to public GitHub.com actions.

En este artículo

Nota:

Actualmente los ejecutores hospedados por GitHub Enterprise Server no se admiten en GitHub.

Acerca del acceso automático a GitHub.com las acciones

De forma predeterminada, GitHub Actions los flujos de trabajo de GitHub Enterprise Server no pueden usar acciones directamente desde GitHub.com o GitHub Marketplace. Para que las acciones públicas estén GitHub.com disponibles en la instancia empresarial, puede usar GitHub Connect para integrarse GitHub Enterprise Server con GitHub Enterprise Cloud.

Para utilizar acciones de GitHub.com,, tanto GitHub Enterprise Server como tus runners autohospedados deben poder establecer conexiones salientes con GitHub.com. No se requieren conexiones entrantes de GitHub.com . Para más información, consulta Referencia de ejecutores autohospedados.

Como alternativa, si quieres un control más estricto sobre qué acciones se permiten en la empresa, puedes descargar y sincronizar las acciones manualmente en la instancia empresarial mediante la herramienta actions-sync. Para más información, consulta Sincronización manual de acciones desde GitHub.com.

Acerca de la resolución de acciones mediante GitHub Connect

Cuando un flujo de trabajo usa una acción mediante una referencia al repositorio donde se almacena la acción, GitHub Actions intentará buscar primero el repositorio en tu instancia de GitHub Enterprise Server. Si el repositorio no existe en tu instancia de GitHub Enterprise Server y has habilitado el acceso automático a GitHub.com, GitHub Actions intentará buscar el repositorio en GitHub.com.

Si un usuario ya ha creado una organización y un repositorio en la empresa que coincida con un nombre de organización y repositorio en GitHub.com, el repositorio de la empresa se usará en lugar del GitHub.com repositorio. Para obtener más información, consulte Retirada automática de espacios de nombres para las acciones a las que se accede en GitHub.com.

Habilitación del acceso automático a acciones públicas GitHub.com

Antes de habilitar el acceso a acciones públicas desde GitHub.com para su empresa, debe hacer lo siguiente:

  1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.
  2. En la parte superior de la página, haga clic en GitHub Connect.
  3. En "Los usuarios pueden usar acciones de GitHub.com en ejecuciones de flujo de trabajo", use el menú desplegable y seleccione Enabled.
  4. Después de habilitar GitHub Connect, puede usar directivas para restringir qué acciones públicas se pueden usar en los repositorios de la empresa. Para más información, consulta Aplicación de directivas para Acciones de GitHub en la empresa.

Retirada automática de espacios de nombres para las acciones a las que se accede GitHub.com

Al habilitar GitHub Connect, los usuarios no ven ningún cambio en el comportamiento de los flujos de trabajo existentes porque GitHub Actions busca tu instancia de GitHub Enterprise Server cada acción antes de revertir a GitHub.com. Esto garantiza que las versiones personalizadas de las acciones que haya creado la empresa se usen en preferencia para sus homólogos en GitHub.com.

Para asegurarte de que los flujos de trabajo usan sus acciones previstas y bloquear la posibilidad de abuso, una vez que se usa una acción en GitHub.com por primera vez, el espacio de nombres asociado a esa acción se retira en la empresa. Esto impide que los usuarios creen una organización y un repositorio en la empresa que coincidan con el espacio de nombres de la acción en GitHub.com.

Después de usar una acción de GitHub.com, si desea crear una acción con tu instancia de GitHub Enterprise Server el mismo nombre, primero debe hacer que el espacio de nombres de esa organización y repositorio esté disponible.

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

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

  3. En la barra lateral izquierda, en Administrador del sitio, haga clic en Espacios de nombres retirados.

  4. A la derecha del espacio de nombres que desea usar en , haga clic en tu instancia de GitHub Enterprise ServerUnretire.

  5. Ve a la organización relevante y crea un repositorio nuevo.

    Sugerencia

    Cuando se anula la retirada de un espacio de nombres, debe crear lo antes posible el repositorio nuevo con el mismo nombre. Si un flujo de trabajo llama a la acción asociada antes GitHub.com de crear el repositorio local, el espacio de nombres se retirará de nuevo. En el caso de las acciones que se utilizan en los flujos de trabajo que se ejecutan con frecuencia, es posible que encuentres que el espacio de nombres se haya retirado nuevamente antes de que tengas tiempo para crear el repositorio local. En este caso, puedes inhabilitar los flujos de trabajo relevantes temporalmente hasta que hayas creado el repositorio nuevo.