Skip to main content

Usar etiquetas com executores auto-hospedados

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

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 clicking your profile photo in the top-right corner of GitHub.com, then clicking Your enterprises, then clicking the enterprise.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise account: Click Actions under " Policies", then click the Runners tab.
  3. In the list of runners, click the runner you'd like to configure.

  4. Na seção "Etiquetas", clique em .

  5. No campo "Encontrar ou criar uma etiqueta", 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. 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 clicking your profile photo in the top-right corner of GitHub.com, then clicking Your enterprises, then clicking the enterprise.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise account: Click Actions under " Policies", then click the Runners tab.
  3. In the list of runners, click the runner you'd like to configure.

  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.

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 clicking your profile photo in the top-right corner of GitHub.com, then clicking Your enterprises, then clicking the enterprise.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise account: Click Actions under " Policies", then click the Runners tab.
  3. In the list of runners, click the runner you'd like to configure.

  4. Na seção "Etiquetas", clique em .

  5. No campo "Encontre ou crie uma etiqueta", as etiquetas atribuídas são marcadas com a Ícone de . Clique em uma etiqueta marcada para cancelar a atribuição do seu executor auto-hospedado.

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.