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 tu organización o en tus ajustes de repositorio 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.

  • Enterprise: You must be a GitHub Enterprise site administrator.

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.

    • If using an enterprise-level runner:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. In the left sidebar, click Enterprise overview.
      3. In the enterprise sidebar, Policies.
  2. Navega a los ajustes de GitHub Actions:

    • En un repositorio de organización: da clic en Acciones en la barra lateral izquierda.

      Configuración de acciones

    • If using an enterprise-level runner: click Actions under " Policies".

  3. Ubica la lista de ejecutores bajo "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.

    • If using an enterprise-level runner:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. In the left sidebar, click Enterprise overview.
      3. In the enterprise sidebar, Policies.
  2. Navega a los ajustes de GitHub Actions:

    • En un repositorio de organización: da clic en Acciones en la barra lateral izquierda.

      Configuración de acciones

    • If using an enterprise-level runner: click Actions under " Policies".

  3. Ubica la lista de ejecutores bajo "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.

    • If using an enterprise-level runner:

      1. En la esquina superior derecha de cualquier página, da clic en .
      2. In the left sidebar, click Enterprise overview.
      3. In the enterprise sidebar, Policies.
  2. Navega a los ajustes de GitHub Actions:

    • En un repositorio de organización: da clic en Acciones en la barra lateral izquierda.

      Configuración de acciones

    • If using an enterprise-level runner: click Actions under " Policies".

  3. Ubica la lista de ejecutores bajo "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.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.