Skip to main content

Uso de ejecutores autohospedados en un flujo de trabajo

Para usar ejecutores autohospedados en un flujo de trabajo, puedes usar etiquetas o grupos para especificar el ejecutor de un trabajo.

Puedes establecer como destino ejecutores autohospedados para usarlos en un flujo de trabajo en función de las etiquetas asignadas a los ejecutores, su pertenencia a grupos o una combinación de estos.

Acerca de las etiquetas de ejecutor autohospedado

Las etiquetas te permiten enviar jobs de flujo de trabajo a tipos específicos de ejecutores auto-hospedados, de acuerdo con sus características compartidas. Por ejemplo, si tu job requiere una componente de hardware o paquete de software específico, puedes asignar una etiqueta personalizada a un ejecutor y después configurar tu job para que solo se ejecute en los ejecutores con esta etiqueta.

A fin de especificar un ejecutor autohospedado para el trabajo, configure runs-on en el archivo de flujo de trabajo con las etiquetas de ejecutor autohospedado.

Todos los ejecutores autohospedados tienen la etiqueta self-hosted. El utilizar únicamente esta etiqueta seleccionará cualquier ejecutor auto-hospedado. Para seleccionar los ejecutores que cumplen con determinados criterios, como el sistema operativo o la arquitectura, se recomienda proporcionar una serie de etiquetas que comience con self-hosted (debe estar en primer lugar) y que luego incluya etiquetas adicionales según sea necesario. Cuando especifiques un arreglo de etiquetas, los jobs se pondrán en cola cuando se trate de ejecutores que tengan todas las etiquetas que especificas.

Aunque la etiqueta self-hosted no es obligatoria, se recomienda encarecidamente especificarla cuando se usen ejecutores autohospedados, para garantizar que el trabajo no especifique un ejecutor hospedado en GitHub futuro o actual por accidente.

Para obtener información sobre cómo crear etiquetas personalizadas y predeterminadas, consulta "Uso de etiquetas con ejecutores autohospedados".

Acerca de los grupos de ejecutores auto-hospedados

En el caso de los ejecutores autohospedados definidos en el nivel de la organización o la empresa, puedes agrupar los ejecutores con características compartidas en un único grupo de ejecutores y, luego, configurar el trabajo para establecer como destino el grupo de ejecutores.

A fin de especificar un grupo de ejecutores autohospedados para el trabajo, configura runs-on.group en el archivo de flujo de trabajo.

Para más información sobre cómo crear y administrar grupos de ejecutores, consulta "Administración del acceso a los ejecutores autohospedados mediante grupos".

Visualización de ejecutores disponibles para un repositorio

Si tienes acceso repo: write a un repositorio, puedes ver una lista de los ejecutores disponibles para el repositorio.

  1. En GitHub.com, navega a la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Acciones.

    Captura de pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.

  3. En la barra lateral izquierda, en la sección "Administración", haz clic en Ejecutores.

  4. Haz clic en la pestaña Autohospedado en la parte superior de la lista de ejecutores.

  5. Revisa la lista de ejecutores autohospedados disponibles para el repositorio. Esta lista incluye ejecutores autohospedados y conjuntos de escalado de ejecutores creados con Actions Runner Controller. Para obtener más información, vea «Acerca de Actions Runner Controller».

  6. Opcionalmente, para copiar la etiqueta de un ejecutor para usarla en un flujo de trabajo, haz clic en a la derecha del ejecutor y, a continuación, haz clic en Copiar etiqueta.

Nota: Los propietarios de la empresa y de la organización y los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" pueden crear ejecutores con la opción de crear nuevos ejecutores desde esta página. Para crear un nuevo ejecutor, haz clic en Nuevo ejecutor en la parte superior derecha de la lista de ejecutores para agregar ejecutores al repositorio.

Para más información, consulta "Administración de ejecutores más grandes" y "Agrega ejecutores auto-hospedados."

Para obtener más información sobre los roles de la organización personalizados, consulta: "Acerca de los roles personalizados de organización".

Utilizar etiquetas predeterminadas para enrutar jobs

Un ejecutor auto-hospedado recibe ciertas etiquetas automáticamente cuando se agrega a GitHub Actions. Estas se utilizan para indicar su sistema operativo y plataforma de hardware:

  • self-hosted: etiqueta predeterminada que se aplica a todos los ejecutores autohospedados.
  • linux, windows o macOS: se aplica según el sistema operativo.
  • x64, ARM o ARM64: se aplica en función de la arquitectura de hardware.

Puedes utilizar el YAML de tu flujo de trabajo para mandar jobs a las diferentes combinaciones de estas etiquetas. En este ejemplo, un ejecutor auto-hospedado que empate con las tres etiquetas será elegible para ejecutar el job:

runs-on: [self-hosted, linux, ARM64]
  • self-hosted: ejecutar este trabajo en un ejecutor autohospedado.
  • linux: usar solo un ejecutor basado en Linux.
  • ARM64: usar solo un ejecutor basado en hardware ARM64.

Las etiquetas predeterminadas son fijas y no se pueden cambiar ni eliminar. Considera utilizar etiquetas personalizadas si necesitas más control sobre el enrutamiento de los jobs.

Utilizar etiquetas personalizadas para enrutar jobs

Puedes crear etiquetas personalizadas y asignarlas a tus ejecutores auto-hospedados en cualquier momento. Las etiquetas personalizadas te permiten enviar jobs a tipos particulares de ejecutores auto-hospedados, basándose en cómo se etiquetan.

Por ejemplo, si tiene un trabajo que requiere un tipo específico de hardware de gráficos, puede crear una etiqueta personalizada llamada gpu y asignarla a los ejecutores que tengan instalado este hardware. Un ejecutor auto-hospedado que empate con las etiquetas asignadas será entonces elegible para ejecutar el job.

Este ejemplo muestra un job que combina etiquetas predeterminadas y personalizadas:

runs-on: [self-hosted, linux, x64, gpu]
  • self-hosted: ejecutar este trabajo en un ejecutor autohospedado.
  • linux: usar solo un ejecutor basado en Linux.
  • x64: usar solo un ejecutor basado en hardware x64.
  • gpu: esta etiqueta personalizada se asignó manualmente a los ejecutores autohospedados con hardware de GPU instalado.

Estas etiquetas operan de manera acumulativa, así que un ejecutor auto-hospedado deberá tener las cuatro etiquetas para ser elegible para procesar el trabajo.

Uso de grupos para enrutar trabajos

En este ejemplo, se han agregado ejecutores de Ubuntu a un grupo denominado ubuntu-runners. La clave runs-on envía el trabajo a cualquier ejecutor disponible del grupo ubuntu-runners:

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on: 
      group: ubuntu-runners
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Uso de etiquetas y grupos para enrutar trabajos

Al combinar grupos y etiquetas, el ejecutor debe cumplir ambos requisitos para poder ejecutar el trabajo.

En este ejemplo, un grupo de ejecutores denominado ubuntu-runners se rellena con ejecutores de Ubuntu, a los que también se ha asignado la etiqueta ubuntu-20.04-16core. La clave runs-on combina group y labels para que el trabajo se enrute a cualquier ejecutor disponible dentro del grupo que también tenga una etiqueta coincidente:

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on:
      group: ubuntu-runners
      labels: ubuntu-20.04-16core
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Precedencia de enrutamiento para los ejecutores auto-hospedados

Cuando se enruta un trabajo a un ejecutor autohospedado, GitHub busca un ejecutor que coincida con las etiquetas o grupos runs-on del trabajo:

  • Si GitHub encuentra un ejecutor inactivo en línea que coincida con las etiquetas o grupos runs-on del trabajo, este se asigna y envía al ejecutor.
    • Si ele ejecutor no recoge el job asignado en 60 segundos, este volverá a ponerse en cola para que el ejecutor nuevo pueda aceptarlo.
  • Si GitHub no encuentra ningún ejecutor en línea inactivo que coincida con las etiquetas o grupos runs-on del trabajo, este permanecerá en la cola hasta que haya un ejecutor en línea.
  • Si el job permanece en cola por más de 24 horas, este fallará.