Usar etiquetas com os runners auto-hospedados

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

Neste artigo

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 coordenador para uma tarefa.

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

Observação

O Action Runner Controller não oferece suporte para vários rótulos, para saber mais, leia a documentação do Action Runner Controller

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)

Observação

Os rótulos são insensíveis a maiúsculas e minúsculas.

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. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  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. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  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. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  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.