👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Usar etiquetas com executores auto-hospedados

Você pode usar etiquetas para organizar os seus executores auto-hospedados com base em suas características.

Neste artigo

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.
    Actions setting
  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.
    Change runner label
  4. No campo "Filtrar etiquetas", digite o nome da sua nova etiqueta e clique em Criar nova etiqueta.
    Adicionar etiqueta do executor

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.
    Actions setting
  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.
    Change runner label
  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.
    Actions setting
  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.
    Change runner label
  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

Observação: Se você substituir um executor existente, você deverá reatribuir quaisquer etiquetas personalizadas.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato