Usar etiquetas com executores auto-hospedados

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 settings on your GitHub Enterprise Server instance. 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: You must be a GitHub Enterprise site administrator.

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-level runner:
     1. In the upper-right corner of any page, click .
     2. In the left sidebar, click Enterprise overview.
     3. In the enterprise sidebar, click Policies.

2. Navigate to the GitHub Actions settings:

   • In an organization or repository: Click Actions in the left sidebar.
   • If using an enterprise-level runner: Click Actions under " Policies".

3. Localize a lista de executores em "Executores auto-hospedados".

4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.

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.

6. No campo "Filtrar etiquetas", 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-level runner:
     1. In the upper-right corner of any page, click .
     2. In the left sidebar, click Enterprise overview.
     3. In the enterprise sidebar, click Policies.

2. Navigate to the GitHub Actions settings:

   • In an organization or repository: Click Actions in the left sidebar.
   • If using an enterprise-level runner: Click Actions under " Policies".

3. Localize a lista de executores em "Executores auto-hospedados".

4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.

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.

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-level runner:
     1. In the upper-right corner of any page, click .
     2. In the left sidebar, click Enterprise overview.
     3. In the enterprise sidebar, click Policies.

2. Navigate to the GitHub Actions settings:

   • In an organization or repository: Click Actions in the left sidebar.
   • If using an enterprise-level runner: Click Actions under " Policies".

3. Localize a lista de executores em "Executores auto-hospedados".

4. Se seu runner estiver em um grupo, localize o grupo de runner e clique em para visualizar a lista de runners.

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.

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