Usar etiquetas com os runners auto-hospedados

Para obter informações sobre como usar rótulos para direcionar trabalhos para tipos específicos de runners auto-hospedados, confira Usar os executores auto-hospedados em um fluxo de trabalho. Você também pode direcionar trabalhos para runners em um grupo específico. Para saber mais, confira Escolhendo o executor para um trabalho.

Permissões necessárias para a gestão de runners auto-hospedados.

Criar etiquetas personalizadas

Você pode criar rótulos personalizados para executores nos níveis de repositório, corporativo e.

•         [Criar um rótulo personalizado para um executor de repositório](#creating-a-custom-label-for-a-repository-runner)
  

•         [Criar um rótulo personalizado para um executor de organização](#creating-a-custom-label-for-an-organization-runner)
  

•         [Criar um rótulo personalizado para um runner corporativo](#creating-a-custom-label-for-an-enterprise-runner)
  

Criar um rótulo personalizado para um executor de repositório

1. Acesse a página principal do repositório onde o grupo de executor auto-hospedado está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na lista de executores, clique no nome do executor que você deseja configurar.
5. Na seção "Etiquetas", clique em .
6. No campo "Localizar ou criar um rótulo", digite o nome do novo rótulo e clique em Criar rótulo. 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.

Criar um rótulo personalizado para um executor de organização

1. Navegue até a página principal da organização onde seu grupo de executores auto-hospedados está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na lista de executores, clique no nome do executor que você deseja configurar.
5. Na seção "Etiquetas", clique em .
6. No campo "Localizar ou criar um rótulo", digite o nome do novo rótulo e clique em Criar rótulo. 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.

Criação de um rótulo personalizado para um agente de execução empresarial

1. No canto superior à direita do GitHub Enterprise Server, clique na sua imagem do perfil e clique em Configurações da empresa.
2. Na parte superior da página, clique em Policies.{ % else %}No lado esquerdo da página, na barra lateral da conta empresarial, clique em Policies.
3. Em " Policies", clique em Actions.
4. Clique na guia Executores.
5. Na lista de executores, clique no nome do executor que você deseja configurar.
6. Na seção "Etiquetas", clique em .
7. No campo "Localizar ou criar um rótulo", digite o nome do novo rótulo e clique em Criar rótulo. 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 um rótulo a um executor auto-hospedado

Você pode atribuir etiquetas a executores auto-hospedados nos níveis de repositório, organização e empresa.

•         [Atribuir um rótulo a um executor de repositório](#assigning-a-label-to-a-repository-runner)
  

•         [Atribuir um rótulo a um executor de organização](#assigning-a-label-to-an-organization-runner)
  

•         [Atribuir um rótulo a um runner corporativo](#assigning-a-label-to-an-enterprise-runner)
  

Atribuir um rótulo a um corredor de repositório

1. Acesse a página principal do repositório onde o grupo de executor auto-hospedado está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na seção "Etiquetas", clique em .
5. Para atribuir uma etiqueta ao executor auto-hospedado, no campo "Localizar ou criar uma etiqueta", clique na etiqueta.

Atribuir um rótulo a um executor de organização

1. Navegue até a página principal da organização onde seu grupo de executores auto-hospedados está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na seção "Etiquetas", clique em .
5. Para atribuir uma etiqueta ao executor auto-hospedado, no campo "Localizar ou criar uma etiqueta", clique na etiqueta.

Atribuir um rótulo a um agente de execução corporativo

1. No canto superior à direita do GitHub Enterprise Server, clique na sua imagem do perfil e clique em Configurações da empresa.
2. Na parte superior da página, clique em Policies.{ % else %}No lado esquerdo da página, na barra lateral da conta empresarial, clique em Policies.
3. Em " Policies", clique em Actions.
4. Clique na guia Executores.
5. Na lista de executores, clique no nome do executor que você deseja configurar.
6. Na seção "Etiquetas", clique em .
7. Para atribuir uma etiqueta ao executor auto-hospedado, no campo "Localizar ou criar uma etiqueta", clique na etiqueta.

Remover uma etiqueta personalizada de um executor auto-hospedado

Você pode remover rótulos personalizados de executores auto-hospedados nos níveis de repositório, organização e empresa.

•         [Remover um rótulo personalizado de um executor de repositório](#removing-a-custom-label-from-a-repository-runner)
  

•         [Remover um rótulo personalizado de um executor de organização](#removing-a-custom-label-from-an-organization-runner)
  

•         [Remover um rótulo personalizado de um executor corporativo](#removing-a-custom-label-from-an-enterprise-runner)
  

Remover um rótulo personalizado de um executor de repositório

1. Acesse a página principal do repositório onde o grupo de executor auto-hospedado está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na seção "Etiquetas", clique em .
5. No campo "Localizar ou criar um rótulo", os rótulos atribuídos são marcados com o ícone . Clique em uma etiqueta marcada para cancelar a atribuição do seu executor auto-hospedado.

Remover um rótulo personalizado de um executor de organização

1. Navegue até a página principal da organização onde seu grupo de executores auto-hospedados está registrado.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Actions e clique em Runners.
4. Na seção "Etiquetas", clique em .
5. No campo "Localizar ou criar um rótulo", os rótulos atribuídos são marcados com o ícone . Clique em uma etiqueta marcada para cancelar a atribuição do seu executor auto-hospedado.

Removendo um rótulo personalizado de um executor corporativo

1. No canto superior à direita do GitHub Enterprise Server, clique na sua imagem do perfil e clique em Configurações da empresa.
2. Na parte superior da página, clique em Policies.{ % else %}No lado esquerdo da página, na barra lateral da conta empresarial, clique em Policies.
3. Em " Policies", clique em Actions.
4. Clique na guia Executores.
5. Na lista de executores, clique no nome do executor que você deseja configurar.
6. Na seção "Etiquetas", clique em .
7. No campo "Localizar ou criar um rótulo", os rótulos atribuídos são marcados com o ícone . Clique em uma etiqueta marcada para cancelar a atribuição do seu executor auto-hospedado.

Atribuir rótulos programaticamente

É possível atribuir rótulos programaticamente a um executor auto-hospedado após a criação dele ou durante sua configuração inicial.

• Para atribuir rótulos programaticamente a um executor auto-hospedado existente, você deve usar a API REST. Para saber mais, confira Pontos de extremidade da API REST para executores auto-hospedados.

• Para atribuir rótulos programaticamente a um executor auto-hospedado durante a configuração inicial dele, transmita nomes de rótulo ao script config usando o parâmetro labels.

  Observação

  Não é possível usar o script config para atribuir rótulos a um executor auto-hospedado existente.

  Por exemplo, o seguinte comando atribui um rótulo gpu durante a configuração de um novo executor auto-hospedado:

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

  Caso não exista, a etiqueta será criada. Você também pode usar essa abordagem para atribuir os rótulos padrão aos 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 --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux
  

  Observação

  Se você substituir um runner existente, precisará reatribuir os rótulos personalizados.