Utilizar etiquetas con ejecutores auto-hospedados

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

     1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas.

     2. En la lista de empresas, da clic en aquella que quieras ver.

2. Navega a los ajustes de GitHub Actions:

   • En una organización o repositorio:

     1. In the left sidebar, click Actions, then click Runners.

   • Si utilizas un ejecutor a nivel de empresa:

     1. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
     2. Debajo de " Políticas", haz clic en Acciones.
     3. Haz clic 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 utilizas un ejecutor a nivel de empresa:

     1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas.

     2. En la lista de empresas, da clic en aquella que quieras ver.

2. Navega a los ajustes de GitHub Actions:

   • En una organización o repositorio:

     1. In the left sidebar, click Actions, then click Runners.

   • Si utilizas un ejecutor a nivel de empresa:

     1. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
     2. Debajo de " Políticas", haz clic en Acciones.
     3. Haz clic 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 utilizas un ejecutor a nivel de empresa:

     1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas.

     2. En la lista de empresas, da clic en aquella que quieras ver.

2. Navega a los ajustes de GitHub Actions:

   • En una organización o repositorio:

     1. In the left sidebar, click Actions, then click Runners.

   • Si utilizas un ejecutor a nivel de empresa:

     1. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
     2. Debajo de " Políticas", haz clic en Acciones.
     3. Haz clic 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