Uso de etiquetas con ejecutores autohospedados

Puedes utilizar etiquetas para organizar tus ejecutores auto-hospedados según sus características.

En este artículo

Para obtener información sobre cómo usar etiquetas a fin de enrutar trabajos a tipos específicos de ejecutores autohospedados, consulte Uso de ejecutores autohospedados en un flujo de trabajo. También puede enrutar trabajos a ejecutores de un grupo específico. Para más información, consulta Elegir un ejecutor para un job.

Un ejecutor autohospedado se puede ubicar en al repositorio, en la organización o en la configuración de cuenta empresarial en GitHub. Para administrar un ejecutor auto-hospedado, debes tener los siguientes permisos, dependiendo de donde se agregó éste:

  • Repositorio de usuario: debe ser el propietario del repositorio.
  • Organización: debe ser el propietario de una organización.
  • Repositorio de la organización: debe ser el propietario de una organización o tener acceso de administrador al repositorio.

Crear una etiqueta personalizada

Puedes crear etiquetas personalizadas para los ejecutores en los niveles de repositorio, y organización.

  •         [Creación de etiquetas personalizadas para ejecutores de repositorio](#creating-a-custom-label-for-a-repository-runner)

  •         [Creación de etiquetas personalizadas para ejecutores de organización](#creating-a-custom-label-for-an-organization-runner)

Nota:

Las etiquetas no son sensibles a mayúsculas o minúsculas.

Creación de una etiqueta personalizada para un ejecutor de repositorio

  1. Navega a la página principal del repositorio en el que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
  5. En la sección de "Etiquetas", haz clic en .
  6. En el campo "Buscar o crear una etiqueta", escriba el nombre de la etiqueta nueva y haga clic en Crear etiqueta. La etiqueta personalizada se creará y asignará al ejecutor auto-hospedado. Las etiquetas personalizadas pueden eliminarse de los ejecutores auto-hospedados, pero actualmente no pueden eliminarse manualmente. Cualquier etiqueta sin utilizar que no se asigne a un ejecutor se borrará automáticamente dentro de 24 horas.

Creación de etiquetas personalizadas para ejecutores de organización

  1. Navega a la página principal de la organización en la que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
  5. En la sección de "Etiquetas", haz clic en .
  6. En el campo "Buscar o crear una etiqueta", escriba el nombre de la etiqueta nueva y haga clic en Crear etiqueta. La etiqueta personalizada se creará y asignará al ejecutor auto-hospedado. Las etiquetas personalizadas pueden eliminarse de los ejecutores auto-hospedados, pero actualmente no pueden eliminarse manualmente. Cualquier etiqueta sin utilizar que no se asigne a un ejecutor se borrará automáticamente dentro de 24 horas.

Asignar una etiqueta a un ejecutor auto-hospedado

Puedes asignar etiquetas a autohospedados en los niveles de repositorio, y organization.

  •         [Asignación de etiquetas a ejecutores de repositorios](#assigning-a-label-to-a-repository-runner)

  •         [Asignación de etiquetas a un ejecutores de organización](#assigning-a-label-to-an-organization-runner)

Asignación de etiquetas a ejecutores de repositorios

  1. Navega a la página principal del repositorio en el que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la sección de "Etiquetas", haz clic en .
  5. Para asignar una etiqueta a tu ejecutor auto-hospedado, en el campo de "Encuentra o crea una etiqueta", haz clic en ella.

Asignación de etiquetas a ejecutores de repositorios

  1. Navega a la página principal de la organización en la que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la sección de "Etiquetas", haz clic en .
  5. Para asignar una etiqueta a tu ejecutor auto-hospedado, en el campo de "Encuentra o crea una etiqueta", haz clic en ella.

Eliminar una etiqueta personalizada de un ejecutor auto-hospedado

Puedes quitar etiquetas personalizadas de ejecutores autohospedados en los niveles de repositorio, y organización.

  •         [Eliminar una etiqueta personalizada de un ejecutor de repositorio](#removing-a-custom-label-from-a-repository-runner)

  •         [Eliminación de etiquetas personalizadas de ejecutores de organización](#removing-a-custom-label-from-an-organization-runner)

Eliminación de etiquetas personalizadas de ejecutores de repositorios

  1. Navega a la página principal del repositorio en el que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la sección de "Etiquetas", haz clic en .
  5. En el campo "Buscar o crear una etiqueta", las etiquetas asignadas se marcan con el icono . Haz clic en una etiqueta marcada para desasignarla de tu ejecutor auto-hospedado.

Eliminación de etiquetas personalizadas de ejecutores de organización

  1. Navega a la página principal de la organización en la que está registrado tu grupo de ejecutores auto-hospedados.
  2. Haz clic en Settings.
  3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.
  4. En la sección de "Etiquetas", haz clic en .
  5. En el campo "Buscar o crear una etiqueta", las etiquetas asignadas se marcan con el icono . Haz clic en una etiqueta marcada para desasignarla de tu ejecutor auto-hospedado.

Asignación de etiquetas mediante programación

Puedes asignar etiquetas a un ejecutor autohospedado mediante programación después de crearlo o durante su configuración inicial.

  • Para asignar etiquetas a un ejecutor autohospedado existente mediante programación, debes usar la API REST. Para más información, consulta Puntos de conexión de API de REST para ejecutores autohospedados.

  • Para asignar etiquetas a un ejecutor autohospedado mediante programación durante la configuración inicial de este, puedes pasar nombres de etiqueta al script config mediante el parámetro labels.

    Nota:

    No puedes usar el script config para asignar etiquetas a un ejecutor auto-hospedado existente.

    Por ejemplo, este comando asigna una etiqueta denominada gpu al configurar un nuevo ejecutor autohospedado:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu

    La etiqueta se creará si no existe. También puede usar este enfoque para asignar las etiquetas por defecto a los corredores, como x64 o linux. Cuando se asignan etiquetas predeterminadas utilizando el script de configuración, GitHub Actions las acepta como asignadas y no valida si el ejecutor está utilizando ese sistema operativo o arquitectura.

    Puedes utilizar separación por comas para asignar etiquetas múltiples. Por ejemplo:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux

    Nota:

    Si reemplazaste un ejecutor existente, entonces deberás volver a asignar cualquier etiqueta personalizada.