Skip to main content

Administración de ejecutores más grandes

Puedes configurar ejecutor más grandes para tu organización o empresa.

¿Quién puede utilizar esta característica?

Los Ejecutor más grande solo están disponibles para organizaciones y empresas que usan los planes GitHub Team o GitHub Enterprise Cloud.

Enterprise or organization owners can manage larger runners.

Nota: La información e instrucciones de este artículo solo se aplican a ejecutor más grandes con sistemas operativos Linux y Windows.

Nota: los ejecutores de la GPU están actualmente en versión beta y están sujetos a cambios.

Agregar un ejecutor más grande a una empresa

Los propietarios de la organización pueden agregar un ejecutor más grande a un control de organización que los repositorios pueden usar. Al crear un nuevo ejecutor para una organización, de forma predeterminada, todos los repositorios de la organización tienen acceso a él. Para limitar qué repositorios pueden usar el ejecutor, asígnalo a un grupo de ejecutores con acceso a repositorios específicos. Para más información, consulte "Permitir que los repositorios accedan a ejecutadores de mayor capacidad".

Puedes elegir un sistema operativo y una configuración de hardware en la lista de opciones disponibles. Cuando se implementan nuevas instancias de este ejecutor mediante el escalado automático, usarán el mismo sistema operativo y la misma configuración de hardware que has definido aquí.

Los nuevos ejecutores se asignan automáticamente al grupo predeterminado o puedes elegir qué grupo deben unirse los ejecutores durante el proceso de creación del ejecutor. Además, puedes modificar los miembros del grupo del ejecutor después de que lo hayas registrado. Para obtener más información, vea «Control del acceso a los ejecutores más grandes».

  1. En GitHub.com, ve a la página principal de la organización.

  2. En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. Haz clic en Nuevo ejecutor y, después, en Nuevo ejecutor hospedado en GitHub .

  5. Completa los detalles necesarios para configurar el nuevo ejecutor:

    • Nombre: escribe un nombre para el nuevo ejecutor. Para facilitar la identificación, esto debe indicar su configuración de hardware y funcionamiento, como ubuntu-20.04-16core.
    • Plataforma: elija una plataforma de entre las opciones disponibles. Una vez que haya seleccionado una plataforma, podrá elegir una imagen específica.
    • Imagen: elija una imagen de las opciones disponibles. Una vez que haya seleccionado una imagen, podrá elegir un tamaño específico.
      • Propiedad de GitHub: en el caso de las imágenes administradas por GitHub, seleccione una imagen en esta pestaña.
      • Asociado: en el caso de las imágenes administradas por un asociado, selecciona una imagen en esta pestaña. Las imágenes optimizadas para GPU y escritorio de Windows 11 se encuentran en esta pestaña.
    • Tamaño: elija una configuración de hardware de la lista de opciones disponibles. Los tamaños disponibles dependen de la imagen seleccionada en un paso anterior. Para ejecutores de GPU, seleccione un tamaño en la pestaña Impulsado por GPU.
    • Simultaneidad máxima: elija el número máximo de trabajos que pueden estar activos en cualquier momento.
    • Grupo de ejecutores: elije el grupo del que serás miembro el ejecutor. Este grupo hospedará varias instancias del ejecutor, ya que se escalan y reducen verticalmente para satisfacer la demanda.

    Nota: Los nombres de ejecutores más grandes pueden dictar su funcionalidad. Por ejemplo, para usar un ejecutor más grande para la configuración predeterminada de code scanning, el ejecutor debe tener el nombre code-scanning. Para obtener más información sobre code scanning con ejecutores más grandes, consulta "Configuración de ejecutores más grandes para la configuración predeterminada".

  6. Haz clic en Crear ejecutor.

  7. Para permitir que los repositorios accedan a ejecutor más grande, agrégalos a la lista de repositorios que pueden usarlos. Para más información, consulta "Permitir que los repositorios accedan a ejecutor más grandes".

Permitir que los repositorios accedan a ejecutor más grandes

Los repositorios tienen acceso a ejecutor más grandes mediante grupos de ejecutores. Los administradores de empresa pueden elegir qué organizaciones tienen acceso a grupos de ejecutores de nivel empresarial y los propietarios de la organización controlan el acceso de nivel de repositorio a todos los ejecutor más grande.

Los propietarios de la organización pueden usar y configurar grupos de ejecutores de nivel empresarial para los repositorios de su organización, o bien pueden crear grupos de ejecutores de nivel de organización para controlar el acceso.

  • Para los grupos de ejecutores de nivel empresarial: De forma predeterminada, los repositorios de una organización no tienen acceso a grupos de ejecutores de nivel empresarial. Para conceder a los repositorios acceso a grupos de ejecutores de empresa, los propietarios de la organización deben configurar cada grupo de ejecutores de empresa y elegir qué repositorios tienen acceso.
  • Para los grupos de ejecutores de nivel de organización: De forma predeterminada, a todos los repositorios de una organización se les concede acceso a los grupos de ejecutores de nivel de organización. Para restringir qué repositorios tienen acceso, los propietarios de la organización deben configurar grupos de ejecutores de la organización y elegir qué repositorios tienen acceso.

Una vez que un repositorio tiene acceso a ejecutor más grandes, los ejecutor más grandes se pueden agregar a archivos de flujo de trabajo. Para obtener más información, vea «Ejecución de trabajos en ejecutores más grandes».

  1. Ve a la página principal de la organización donde se encuentran tus grupos de ejecutores.
  2. Haga clic en Settings (Configuración).
  3. En la barra lateral izquierda, haz clic en Acciones y, luego, en Grupos de ejecutores.
  4. Selecciona un grupo de ejecutores de cualquiera de las listas de la página. Los grupos de ejecutores de nivel de organización se muestran en la parte superior de la página y los grupos de ejecutores de nivel empresarial aparecen en "Compartidos por la empresa".
  5. En la página del grupo de ejecutores, en "Acceso al repositorio", selecciona Todos los repositorios o Repositorios seleccionados. Si decides conceder acceso a repositorios específicos, haz clic en y, en la lista, selecciona los repositorios a los que quieres conceder acceso.

Advertencia:

Si usas un intervalo IP fijo, te recomendamos que solo uses ejecutor más grande con repositorios privados. Las bifurcaciones de tu repositorio pueden ejecutar código potencialmente peligroso en tu ejecutor más grande creando una solicitud de extracción que ejecute el código en un flujo de trabajo.

Para obtener más información, vea «Control del acceso a los ejecutores más grandes».

Cambio del nombre de un ejecutor más grande

Nota: Los nombres de ejecutores más grandes pueden dictar su funcionalidad. Por ejemplo, para usar un ejecutor más grande para la configuración predeterminada de code scanning, el ejecutor debe tener el nombre code-scanning. Para obtener más información sobre code scanning con ejecutores más grandes, consulta "Configuración de ejecutores más grandes para la configuración predeterminada".

  1. En GitHub.com, ve a la página principal de la organización.

  2. En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.

  5. Escribe un nuevo nombre para el ejecutor en el campo de texto "Nombre".

  6. Haga clic en Save(Guardar).

Configuración del escalado automático de ejecutor más grande

Puedes controlar el número máximo de trabajos que se pueden ejecutar simultáneamente para conjuntos de ejecutores específicos. Establecer este campo en un valor más alto puede ayudar a evitar que los flujos de trabajo se bloqueen debido al paralelismo.

  1. En GitHub.com, ve a la página principal de la organización.

  2. En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.

  5. En la sección "Escalado automático", en "Máxima simultaneidad de trabajos", escribe el número máximo de trabajos que quieres permitir que se ejecuten al mismo tiempo.

  6. Haga clic en Save(Guardar).

Creación de direcciones IP estáticas para ejecutor más grandes

Nota: Para usar direcciones IP estáticas, la organización debe utilizar GitHub Enterprise Cloud. Para más información sobre cómo probar GitHub Enterprise Cloud de forma gratuita, vea "Configuración de una versión de prueba de GitHub Enterprise Cloud".

Puedes habilitar direcciones IP estáticas para ejecutor más grandes. Al hacerlo, a los ejecutor más grande se les asigna intervalos de direcciones IP estáticas. De manera predeterminada, puede configurar hasta 10 ejecutor más grande diferentes con intervalos IP para la cuenta. Si quiere usar más de 10 ejecutores grandes con intervalos de direcciones IP estáticas, póngase en contacto con con nosotros a través del Soporte técnico de GitHub.

El número de direcciones IP disponibles en los intervalos asignados no restringe el número de trabajos simultáneos especificados para el escalado automático. Dentro de un grupo de ejecutores, hay un equilibrador de carga que permite una gran reutilización de las direcciones IP de los intervalos asignados. Esto garantiza que los flujos de trabajo se pueden ejecutar simultáneamente a gran escala mientras cada máquina tiene asignada una dirección IP estática.

  1. En GitHub.com, ve a la página principal de la organización.

  2. En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.

  5. Para asignar una dirección IP estática al ejecutor, en "Redes", marque la opción Asignar intervalos de direcciones IP públicas, estáticas y únicas para este ejecutor.

  6. Haga clic en Save(Guardar).