Utilizar etiquetas con ejecutores auto-hospedados

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

Para obtener información sobre cómo utilizar las etiquetas para rutear jobs a tipos específicos de ejecutores auto-hospedados, consulta la sección "Utilizar ejecutores auto-hospedados en un flujo de trabajo".

Un ejecutor auto-hospedado puede ubicarse ya sea en la configuración de tu repositorio, cuenta de organización, o cuenta de empresa en GitHub. Para administrar un ejecutor auto-hospedado, debes tener los siguientes permisos, dependiendo de donde se agregó éste:

  • Repositorio de usuario: debes ser el propietario del repositorio.

  • Organización: Debes ser un propietario de la organización.

  • Repositorio de la organización: Debes ser un propietario de la organización, o tener acceso administrativo al repositorio.

  • Cuenta empresarial: Debes ser un propietario de la empresa.

Crear una etiqueta personalizada

  1. Navega a donde está registrado tu ejecutor auto-hospedado:
    • En un repositorio organizacional: navega a la página principal y da clic en Configuración.
    • Si se utiliza una cuenta empresarial: navega a tu cuenta visitando https://github.com/enterprises/ENTERPRISE-NAME, remplazando la parte de ENTERPRISE-NAME con tu nombre de cuenta empresarial. En la barra lateral de empresa, Políticas.
  2. Navega a los ajustes de GitHub Actions:
    • En una organización o repositorio: Haz clic en Acciones en la barra lateral izquierda y luego en Ejecutores.
    • Si estás utilizand una cuenta empresarial: Haz clic en Acciones debajo de " Políticas", y luego en la pestaña de Ejecutores .
  3. En la lista de ejecutores, haz clic en el que te gustaría configurar.
  4. En la sección de "Etiquetas", haz clic en .
  5. En el campo de "Encuentra o crea una etiqueta", teclea el nombre de tu etiqueta nueva y haz clic en Crear etiqueta nueva. 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 donde está registrado tu ejecutor auto-hospedado:
    • En un repositorio organizacional: navega a la página principal y da clic en Configuración.
    • Si se utiliza una cuenta empresarial: navega a tu cuenta visitando https://github.com/enterprises/ENTERPRISE-NAME, remplazando la parte de ENTERPRISE-NAME con tu nombre de cuenta empresarial. En la barra lateral de empresa, Políticas.
  2. Navega a los ajustes de GitHub Actions:
    • En una organización o repositorio: Haz clic en Acciones en la barra lateral izquierda y luego en Ejecutores.
    • Si estás utilizand una cuenta empresarial: Haz clic en Acciones debajo de " Políticas", y luego en la pestaña de Ejecutores .
  3. En la lista de ejecutores, haz clic en el que te gustaría configurar.
  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

  1. Navega a donde está registrado tu ejecutor auto-hospedado:
    • En un repositorio organizacional: navega a la página principal y da clic en Configuración.
    • Si se utiliza una cuenta empresarial: navega a tu cuenta visitando https://github.com/enterprises/ENTERPRISE-NAME, remplazando la parte de ENTERPRISE-NAME con tu nombre de cuenta empresarial. En la barra lateral de empresa, Políticas.
  2. Navega a los ajustes de GitHub Actions:
    • En una organización o repositorio: Haz clic en Acciones en la barra lateral izquierda y luego en Ejecutores.
    • Si estás utilizand una cuenta empresarial: Haz clic en Acciones debajo de " Políticas", y luego en la pestaña de Ejecutores .
  3. En la lista de ejecutores, haz clic en el que te gustaría configurar.
  4. En la sección de "Etiquetas", haz clic en .
  5. En el campo "Encuentra o crea una etiqueta", las etiquetas asignadas se marcan con el icono . Haz clic en una etiqueta marcada para desasignarla de tu ejecutor auto-hospedado.

Utilizar el script de configuración para crear y asignar etiquetas

Puedes utilizar el script de configuración en el ejecutor auto-hospedado para crear y asignar etiquetas personalizadas. Por ejemplo, este comando asigna una etiqueta llamada gpu al ejecutor auto-hospedado.

./config.sh --labels gpu

La etiqueta se creará si no existe. También puedes utilizar este acercamiento para asignar etiquetas predeterminadas a los ejecutores, tales 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 --labels gpu,x64,linux

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

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.