Skip to main content

Esta versión de GitHub Enterprise se discontinuará el 2023-01-18. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Using labels with self-hosted runners

You can use labels to organize your self-hosted runners based on their characteristics.

Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.

For information on how to use labels to route jobs to specific types of self-hosted runners, see "Using self-hosted runners in a workflow."

A self-hosted runner can be located in either your repository, organization, or enterprise settings on your GitHub Enterprise Server instance. To manage a self-hosted runner, you must have the following permissions, depending on where the self-hosted runner was added:

  • User repository: You must be the repository owner.

  • Organization: You must be an organization owner.

  • Organization repository: You must be an organization owner, or have admin access to the repository.

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

Creating a custom label

  1. Navega a donde está registrado tu ejecutor:

    • En un repositorio u organización: vaya a la página principal y haga clic en Settings (Configuración).

    • Si usa un ejecutor de nivel empresarial:

      1. En la esquina superior derecha de GitHub Enterprise Server, haga clic en la foto de perfil y luego en Configuración de empresa. "Configuración de empresa" en el menú desplegable de la foto de perfil de GitHub Enterprise Server
  2. Navega a los ajustes de GitHub Actions:

    • En una organización o repositorio:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Si usa un ejecutor de nivel empresarial:

      1. En la barra lateral de la empresa, haz clic en Directivas. Pestaña Directivas en la barra lateral de la cuenta de empresa 1. En " Directivas", haz clic en Acciones. 1. Haz clic en la pestaña Ejecutores.
  3. Busca la lista de ejecutores en "Ejecutores".

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

  5. Localice el ejecutor que quiera actualizar y haga clic en para ver el menú de selección de etiquetas. En este menú se muestran todas las etiquetas personalizadas disponibles para el ejecutor autohospedado. Las etiquetas ya asignadas al ejecutor autohospedado tienen un junto a ellas. Cambio de la etiqueta del ejecutor

  6. In the "Filter labels" field, type the name of your new label, and click Create new label. Add runner label

The custom label is created and assigned to the self-hosted runner. Custom labels can be removed from self-hosted runners, but they currently can't be manually deleted. Cualquier etiqueta sin utilizar que no se asigne a un ejecutor se borrará automáticamente dentro de 24 horas.

Assigning a label to a self-hosted runner

  1. Navega a donde está registrado tu ejecutor:

    • En un repositorio u organización: vaya a la página principal y haga clic en Settings (Configuración).

    • Si usa un ejecutor de nivel empresarial:

      1. En la esquina superior derecha de GitHub Enterprise Server, haga clic en la foto de perfil y luego en Configuración de empresa. "Configuración de empresa" en el menú desplegable de la foto de perfil de GitHub Enterprise Server
  2. Navega a los ajustes de GitHub Actions:

    • En una organización o repositorio:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Si usa un ejecutor de nivel empresarial:

      1. En la barra lateral de la empresa, haz clic en Directivas. Pestaña Directivas en la barra lateral de la cuenta de empresa 1. En " Directivas", haz clic en Acciones. 1. Haz clic en la pestaña Ejecutores.
  3. Busca la lista de ejecutores en "Ejecutores".

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

  5. Localice el ejecutor que quiera actualizar y haga clic en para ver el menú de selección de etiquetas. En este menú se muestran todas las etiquetas personalizadas disponibles para el ejecutor autohospedado. Las etiquetas ya asignadas al ejecutor autohospedado tienen un junto a ellas. Cambio de la etiqueta del ejecutor

  6. Click on a label to assign it to your self-hosted runner.

Removing a custom label from a self-hosted runner

  1. Navega a donde está registrado tu ejecutor:

    • En un repositorio u organización: vaya a la página principal y haga clic en Settings (Configuración).

    • Si usa un ejecutor de nivel empresarial:

      1. En la esquina superior derecha de GitHub Enterprise Server, haga clic en la foto de perfil y luego en Configuración de empresa. "Configuración de empresa" en el menú desplegable de la foto de perfil de GitHub Enterprise Server
  2. Navega a los ajustes de GitHub Actions:

    • En una organización o repositorio:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Si usa un ejecutor de nivel empresarial:

      1. En la barra lateral de la empresa, haz clic en Directivas. Pestaña Directivas en la barra lateral de la cuenta de empresa 1. En " Directivas", haz clic en Acciones. 1. Haz clic en la pestaña Ejecutores.
  3. Busca la lista de ejecutores en "Ejecutores".

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

  5. Localice el ejecutor que quiera actualizar y haga clic en para ver el menú de selección de etiquetas. En este menú se muestran todas las etiquetas personalizadas disponibles para el ejecutor autohospedado. Las etiquetas ya asignadas al ejecutor autohospedado tienen un junto a ellas. Cambio de la etiqueta del ejecutor

  6. Click on the assigned label to remove it from your self-hosted runner. Cualquier etiqueta sin utilizar que no se asigne a un ejecutor se borrará automáticamente dentro de 24 horas.

Programmatically assign labels

You can programmatically assign labels to a self-hosted runner after the runner is created, or during its initial configuration.

  • To programmatically assign labels to an existing self-hosted runner, you must use the REST API. For more information, see the "Self-hosted runners" REST API.

  • To programmatically assign labels to a self-hosted runner during the initial runner configuration, you can pass label names to the config script using the labels parameter.

    Note: You cannot use the config script to assign labels to an existing self-hosted runner.

    For example, this command assigns a label named gpu when configuring a new self-hosted runner:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu
    

    The label is created if it does not already exist. You can also use this approach to assign the default labels to runners, such as x64 or linux. When default labels are assigned using the configuration script, GitHub Actions accepts them as given and does not validate that the runner is actually using that operating system or architecture.

    You can use comma separation to assign multiple labels. For example:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux
    

    Note: If you replace an existing runner, then you must reassign any custom labels.