Utilizar etiquetas con ejecutores auto-hospedados

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

Advertencia: Los ejecutores auto-hospedados actualmente están inhabilitados para GitHub AE. Esto es porque GitHub AE ofrece garantías para los límites de seguridad, las cuales son incompatibles con la forma en que trabajan los ejecutores auto-hospedados. Sin embargo, en caso de que sí necesites utilizar ejecutores auto-hospedados con GitHub AE y entender las implicaciones de seguridad, puedes contactar al soporte de GitHub para que hagan una exepción de seguridad que los habilitará.

Si no necesitas ejecutores auto-hospedados, entonces puedes utilizar Ejecutor hospedado en AE para que ejecuten tus flujos de trabajo. Para obtener más información, consulta la sección "Acerca de los Ejecutor hospedado en AE".

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 configuración de tu cuenta de empresa en tu empresa. 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.

  • Empresa: debes ser un administrador de sitio de GitHub Enterprise.

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 utilizas un ejecutor a nivel empresarial:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. En la barra lateral izquierda, da clic en Resumen empresarial.
      3. 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.
    • Si estás utilizando un ejecutor a nivel empresarial: Haz clic en Acciones debajo de " Políticas".
  3. Ubica la lista de ejecutores debajo de "Ejecutores auto-hospedados".

  4. Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores. Listar el grupo ejecutor

  5. Ubica el ejecutor que quieres actualizar y da clic en para ver el menú de selección de etiquetas. Este menú muestra todas las etiquetas personalizadas disponibles para tu ejecutor auto-hospedado. Las etiquetas que ya hayas asignado a tu ejecutor auto-hospedado tienen un junto a ellas. Cambiar la etiqueta del ejecutor

  6. En el campo "Filtrar etiquetas", teclea el nombre de tu nueva etiqueta y da clic en Crear nueva etiqueta. Etiqueta de agregar ejecutor

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 utilizas un ejecutor a nivel empresarial:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. En la barra lateral izquierda, da clic en Resumen empresarial.
      3. 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.
    • Si estás utilizando un ejecutor a nivel empresarial: Haz clic en Acciones debajo de " Políticas".
  3. Ubica la lista de ejecutores debajo de "Ejecutores auto-hospedados".

  4. Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores. Listar el grupo ejecutor

  5. Ubica el ejecutor que quieres actualizar y da clic en para ver el menú de selección de etiquetas. Este menú muestra todas las etiquetas personalizadas disponibles para tu ejecutor auto-hospedado. Las etiquetas que ya hayas asignado a tu ejecutor auto-hospedado tienen un junto a ellas. Cambiar la etiqueta del ejecutor

  6. Da clic en la etiqueta para asignarla a tu ejecutor auto-hospedado.

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 utilizas un ejecutor a nivel empresarial:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. En la barra lateral izquierda, da clic en Resumen empresarial.
      3. 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.
    • Si estás utilizando un ejecutor a nivel empresarial: Haz clic en Acciones debajo de " Políticas".
  3. Ubica la lista de ejecutores debajo de "Ejecutores auto-hospedados".

  4. Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores. Listar el grupo ejecutor

  5. Ubica el ejecutor que quieres actualizar y da clic en para ver el menú de selección de etiquetas. Este menú muestra todas las etiquetas personalizadas disponibles para tu ejecutor auto-hospedado. Las etiquetas que ya hayas asignado a tu ejecutor auto-hospedado tienen un junto a ellas. Cambiar la etiqueta del ejecutor

  6. Da clic en la etiqueta asignada para eliminarla de tu ejecutor auto-hospedado. Cualquier etiqueta sin utilizar que no se asigne a un ejecutor se borrará automáticamente dentro de 24 horas.

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.