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
-
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 de empresa:
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
-
-
Navega a los ajustes de GitHub Actions:
-
En una organización o repositorio:
- In the left sidebar, click Actions.
- In the left sidebar, under "Actions", click Runners.
-
Si utilizas un ejecutor a nivel de empresa:
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
- Debajo de " Políticas", haz clic en Acciones.
- Haz clic en la pestaña de Ejecutores.
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
-
-
Ubica la lista de ejecutores debajo de "Ejecutores".
-
Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores.
-
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.
-
En el campo "Filtrar etiquetas", teclea el nombre de tu nueva etiqueta y da clic en Crear nueva 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
-
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 de empresa:
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
-
-
Navega a los ajustes de GitHub Actions:
-
En una organización o repositorio:
- In the left sidebar, click Actions.
- In the left sidebar, under "Actions", click Runners.
-
Si utilizas un ejecutor a nivel de empresa:
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
- Debajo de " Políticas", haz clic en Acciones.
- Haz clic en la pestaña de Ejecutores.
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
-
-
Ubica la lista de ejecutores debajo de "Ejecutores".
-
Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores.
-
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.
-
Da clic en la etiqueta para asignarla a tu ejecutor auto-hospedado.
Eliminar una etiqueta personalizada de un ejecutor auto-hospedado
-
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 de empresa:
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
- En la esquina superior derecha de GitHub AE, da clic en tu foto de perfil y luego en Configuración de empresa.
-
-
Navega a los ajustes de GitHub Actions:
-
En una organización o repositorio:
- In the left sidebar, click Actions.
- In the left sidebar, under "Actions", click Runners.
-
Si utilizas un ejecutor a nivel de empresa:
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
- Debajo de " Políticas", haz clic en Acciones.
- Haz clic en la pestaña de Ejecutores.
- En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
-
-
Ubica la lista de ejecutores debajo de "Ejecutores".
-
Si tu ejecutor está en un grupo, ubica el grupo ejecutor y da clic en para ver la lista de ejecutores.
-
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.
-
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.