Uso de etiquetas con ejecutores autohospedados

Para obtener información sobre cómo usar etiquetas a fin de enrutar trabajos a tipos específicos de ejecutores autohospedados, consulta "Uso de ejecutores autohospedados en un flujo de trabajo". También puedes enrutar los trabajos a los 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 el repositorio, la organización o 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

1. Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
2. Haga clic en Settings (Configuración).
3. En la barra lateral izquierda, haz clic en Acciones y luego en Ejecutores. 1. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.
4. En la sección de "Etiquetas", haz clic en .
5. 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

1. Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
2. Haga clic en Settings (Configuración).
3. En la barra lateral izquierda, haz clic en Acciones y luego en Ejecutores. 1. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar. 1. En la sección de "Etiquetas", haz clic en .
4. 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

1. Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
2. Haga clic en Settings (Configuración).
3. En la barra lateral izquierda, haz clic en Acciones y luego en Ejecutores. 1. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar. 1. En la sección de "Etiquetas", haz clic en .
4. 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 obtener más información, consulta la API de REST de "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 autohospedado 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 predeterminadas a los ejecutores, 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.