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 repository, organization, or enterprise account 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 an organization owner, or have admin access to the repository.

  • Enterprise account: You must be an enterprise owner.

Criar etiquetas personalizadas

  1. Navigate to where your self-hosted runner is registered:
    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:
    • In an organization or repository: click Actions in the left sidebar.

      Actions setting

    • If using an enterprise account: click Actions under " Policies".

  3. Localize a lista de runners em "Runners auto-hospedados".
  4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.
    Lista de grupo de runner
  5. Localize o runner que você deseja atualizar e clique em para ver o menu de seleção de etiqueta. Este menu exibe todas as etiquetas personalizadas disponíveis para o seu runner auto-hospedado. Etiquetas já atribuídas para o seu runner auto-hospedado tem um ao lado delas.
    Alterar etiqueta do executor
  6. 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. Quaisquer etiquetas não utilizadas que não forem atribuídas a um executor serão automaticamente excluídas dentro de 24 horas.

Atribuir uma etiqueta a um executor auto-hospedado

  1. Navigate to where your self-hosted runner is registered:
    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:
    • In an organization or repository: click Actions in the left sidebar.

      Actions setting

    • If using an enterprise account: click Actions under " Policies".

  3. Localize a lista de runners em "Runners auto-hospedados".
  4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.
    Lista de grupo de runner
  5. Localize o runner que você deseja atualizar e clique em para ver o menu de seleção de etiqueta. Este menu exibe todas as etiquetas personalizadas disponíveis para o seu runner auto-hospedado. Etiquetas já atribuídas para o seu runner auto-hospedado tem um ao lado delas.
    Alterar etiqueta do executor
  6. Clique em uma etiqueta a ser atribuída ao seu executor auto-hospedado.

Remover uma etiqueta personalizada de um executor auto-hospedado

  1. Navigate to where your self-hosted runner is registered:
    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:
    • In an organization or repository: click Actions in the left sidebar.

      Actions setting

    • If using an enterprise account: click Actions under " Policies".

  3. Localize a lista de runners em "Runners auto-hospedados".
  4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.
    Lista de grupo de runner
  5. Localize o runner que você deseja atualizar e clique em para ver o menu de seleção de etiqueta. Este menu exibe todas as etiquetas personalizadas disponíveis para o seu runner auto-hospedado. Etiquetas já atribuídas para o seu runner auto-hospedado tem um ao lado delas.
    Alterar etiqueta do executor
  6. Clique na etiqueta atribuída para removê-la do seu executor auto-hospedado. Quaisquer etiquetas não utilizadas que não forem atribuídas a um executor serão automaticamente excluídas dentro de 24 horas.

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.

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.