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
- Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
- Haga clic en Settings (Configuración).
- 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.
- En la sección de "Etiquetas", haz clic en .
- 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
- Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
- Haga clic en Settings (Configuración).
- 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 .
- 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
- Navega a la página principal de la organización o repositorio en donde se registró tu grupo de ejecutores auto-hospedados.
- Haga clic en Settings (Configuración).
- 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 .
- 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ámetrolabels
.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
olinux
. 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.