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. Users with the "Manage organization runners and runner groups" permission can manage larger runners at the organization level.

Note

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

Agregar un ejecutor más grande a una empresa

Los propietarios de empresa pueden agregar ejecutor más grandes a una empresa y asignarlos a organizaciones. De forma predeterminada, cuando se crea un ejecutor más grande para una empresa, se agrega a un grupo de ejecutores predeterminado al que todas las organizaciones de la empresa tienen acceso. Aunque todas las organizaciones tienen acceso al ejecutor, los repositorios de cada organización no tienen acceso. En cada organización, un propietario de la organización debe configurar el grupo de ejecutores para especificar qué repositorios tienen acceso al ejecutor de empresa. Para más información, consulta "Permitir que los repositorios accedan a ejecutor más grandes".

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 la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.

  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.

  3. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Directivas.

  4. En " Policies," haz clic en Acciones.

  5. Haz clic en la pestaña Ejecutores.

  6. Haz clic en New runner y, a continuación, en New GitHub-hosted runner.

  7. Complete los detalles necesarios para configurar el nuevo ejecutor:

    • Nombre: escriba 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 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, seleccione una imagen en esta pestaña. Las imágenes de escritorio de Windows 11 y optimizadas para GPU 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 que hayas seleccionado 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: elija el grupo del que será miembro el ejecutor. Este grupo hospedará varias instancias del ejecutor, ya que se escalan y reducen verticalmente para satisfacer la demanda.

    • Redes: elija si se asignará intervalos de direcciones IP estáticas a instancias del ejecutor más grande. Puede usar hasta 10 direcciones IP estáticas en total en todos los ejecutor más grande.

    Note

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

  8. Haga clic en Crear ejecutor.

  9. Para permitir que las organizaciones accedan a los ejecutor más grande, especifica qué organizaciones pueden usar el grupo de ejecutores al que está asignado el ejecutor. Para obtener más información, vea «Control del acceso a los ejecutores más grandes».

Agregar un ejecutor más grande a una empresa

Los propietarios de la organización y los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" 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, navega a la página principal de tu 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 New runner y, a continuación, en New GitHub-hosted runner.

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

    • Nombre: escriba 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 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, seleccione una imagen en esta pestaña. Las imágenes de escritorio de Windows 11 y optimizadas para GPU 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 que hayas seleccionado 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: elija el grupo del que será miembro el ejecutor. Este grupo hospedará varias instancias del ejecutor, ya que se escalan y reducen verticalmente para satisfacer la demanda.

    • Redes: elija si se asignará intervalos de direcciones IP estáticas a instancias del ejecutor más grande. Puede usar hasta 10 direcciones IP estáticas en total en todos los ejecutor más grande.

    Note

    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. Haga 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 y los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" 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. Los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" solo pueden administrar grupos de ejecutores de nivel de organización. Para más información, consulta "Acerca de los roles personalizados de organización".

  • 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 y los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" 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. Haz clic en Settings.
  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.

Warning

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 más información, consulta "Control del acceso a los ejecutores más grandes".

Cambio del nombre de un ejecutor más grande

Note

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

Puedes editar el nombre de los ejecutor más grandes.

Cambio del nombre de un ejecutor de organización

  1. En GitHub, navega a la página principal de tu 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).

Cambio del nombre de un ejecutor de empresa

  1. En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.
  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.
  3. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Directivas.
  4. En " Policies," haz clic en Acciones.
  5. Haz clic en la pestaña Ejecutores.
  6. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.
  7. Escribe un nuevo nombre para el ejecutor en el campo de texto "Nombre".
  8. 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.

Configuración del escalado automático para un ejecutor de organización

  1. En GitHub, navega a la página principal de tu 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).

Configuración del escalado automático para un ejecutor de empresa

  1. En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.
  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.
  3. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Directivas.
  4. En " Policies," haz clic en Acciones.
  5. Haz clic en la pestaña Ejecutores.
  6. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.
  7. 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.
  8. Haga clic en Save(Guardar).

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

Note

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. Todas las direcciones IP del intervalo asignado se pueden usar y no en la notación CIDR. 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.

Creación de direcciones IP estáticas para ejecutores de organización

  1. En GitHub, navega a la página principal de tu 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).

Creación de direcciones IP estáticas para ejecutores de empresa

  1. En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.
  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.
  3. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Directivas.
  4. En " Policies," haz clic en Acciones.
  5. Haz clic en la pestaña Ejecutores.
  6. En la lista de ejecutores, selecciona el ejecutor que te gustaría editar.
  7. 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.
  8. Haga clic en Save(Guardar).