Usar etiquetas com executores auto-hospedados

Para obter informações sobre como usar etiquetas para encaminhar trabalhos para tipos específicos de executores auto-hospedados, consulte "Usando executores auto-hospedados em um fluxo de trabalho."

A self-hosted runner can be located in either your organization or repository settings on GitHub. 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 the organization owner, or have admin access to the repository.

Criar etiquetas personalizadas

1. In your organization or repository, navigate to the main page and click Settings.
2. In the left sidebar, click Actions.
   
3. In the "Self-hosted runners" list, locate the runner you want to update and click to view the label selection menu. This menu displays all the custom labels available to your self-hosted runner. Labels already assigned to your self-hosted runner have a next to them.
   
4. No campo "Filtrar etiquetas", digite o nome da sua nova etiqueta e clique em Criar nova etiqueta.
   

O rótulo personalizado é criado e atribuído ao executor auto-hospedado. É possível remover as etiquetas personalizadas dos executores auto-hospedados, mas não é possível excluí-las manualmente. Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.

Atribuir uma etiqueta a um executor auto-hospedado

1. In your organization or repository, navigate to the main page and click Settings.
2. In the left sidebar, click Actions.
   
3. In the "Self-hosted runners" list, locate the runner you want to update and click to view the label selection menu. This menu displays all the custom labels available to your self-hosted runner. Labels already assigned to your self-hosted runner have a next to them.
   
4. Clique em uma etiqueta a ser atribuída ao seu executor auto-hospedado.

Remover uma etiqueta personalizada de um executor auto-hospedado

1. In your organization or repository, navigate to the main page and click Settings.
2. In the left sidebar, click Actions.
   
3. In the "Self-hosted runners" list, locate the runner you want to update and click to view the label selection menu. This menu displays all the custom labels available to your self-hosted runner. Labels already assigned to your self-hosted runner have a next to them.
   
4. Clique na etiqueta atribuída para removê-la do seu executor auto-hospedado. Any unused labels that are not assigned to a runner will be automatically deleted within 24 hours.

Usar o script de configuração para criar e atribuir rótulos

Você pode usar o script de configuração no executor auto-hospedado para criar e atribuir etiquetas personalizadas. Por exemplo, este comando atribui ao executor auto-hospedado uma etiqueta denominada gpu.

./config.sh --labels gpu

Caso não exista, a etiqueta será criada. Você também pode usar esta abordagem para atribuir as etiquetas-padrão a executores, como x64 ou linux. Quando as etiquetas-padrão são atribuídas usando o script de configuração, GitHub Actions aceita-as como dadas e não valida que o executor está realmente usando esse sistema operacional ou arquitetura.

Você pode usar a separação por vírgula para atribuir múltiplas etiquetas. Por exemplo:

./config.sh --labels gpu,x64,linux