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.

  • Cuenta empresarial: debe ser propietario de la empresa.

Crear una etiqueta personalizada

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

  •         [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)

  •         [Creación de etiquetas personalizadas para ejecutores de empresa](#creating-a-custom-label-for-an-enterprise-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.

Creación de etiquetas personalizadas para ejecutores de empresa

  1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
  2. En la parte superior de la página, haz clic en Policies.
  3. En " Policies", haz clic en Actions.
  4. Haz clic en la pestaña Ejecutores.
  5. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
  6. En la sección de "Etiquetas", haz clic en .
  7. 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, organization y empresa.

  •         [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 empresa](#assigning-a-label-to-an-enterprise-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.

Asignación de etiquetas a ejecutores de empresa

  1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
  2. En la parte superior de la página, haz clic en Policies.
  3. En " Policies", haz clic en Actions.
  4. Haz clic en la pestaña Ejecutores.
  5. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
  6. En la sección de "Etiquetas", haz clic en .
  7. 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, organización y empresa.

  •         [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)

  •         [Eliminar una etiqueta personalizada de un runner de empresa](#removing-a-custom-label-from-an-enterprise-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.

Eliminación de etiquetas personalizadas de ejecutores de empresa

  1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
  2. En la parte superior de la página, haz clic en Policies.
  3. En " Policies", haz clic en Actions.
  4. Haz clic en la pestaña Ejecutores.
  5. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
  6. En la sección de "Etiquetas", haz clic en .
  7. 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.