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."

Um executor auto-hospedado pode ser localizado no seu repositório, organização, ou configurações da conta corporativa em GitHub. Para gerenciar um executor auto-hospedado, você deve ter as seguintes permissões, dependendo de onde o executor auto-hospedado foi adicionado:

• Repositório de Usuário: Você deve ser o proprietário do repositório.

• Organização: Você deve ser um proprietário da organização.

• Repositório da organização: Você deve ser o proprietário da organização ou ter acesso de administrador ao repositório.

• Conta corporativa: Você deve ser proprietário de uma empresa.

Criar etiquetas personalizadas

1. Navegue por onde seu runner auto-hospedado está registrado:

   • Em uma organização ou repositório: navegue até a página principal e clique em Configurações.

   • Se estiver usando um executor de nível corporativo:

     1. No canto superior direito de GitHub.com, clique na sua foto de perfil e, em seguida, clique em Suas empresas.

     2. Na lista de empresas, clique na empresa que você deseja visualizar.

2. Navegue até as configurações GitHub Actions:

   • In an organization or repository:

     1. In the left sidebar, click Actions, then click Runners.

   • Se estiver usando um executor de nível corporativo:

     1. Na barra lateral da conta corporativa, clique em Policies.
     2. Em " Policies (Políticas)", clique em Actions (Ações).
     3. Clique na aba Executores.

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. Navegue por onde seu runner auto-hospedado está registrado:

   • Em uma organização ou repositório: navegue até a página principal e clique em Configurações.

   • Se estiver usando um executor de nível corporativo:

     1. No canto superior direito de GitHub.com, clique na sua foto de perfil e, em seguida, clique em Suas empresas.

     2. Na lista de empresas, clique na empresa que você deseja visualizar.

2. Navegue até as configurações GitHub Actions:

   • In an organization or repository:

     1. In the left sidebar, click Actions, then click Runners.

   • Se estiver usando um executor de nível corporativo:

     1. Na barra lateral da conta corporativa, clique em Policies.
     2. Em " Policies (Políticas)", clique em Actions (Ações).
     3. Clique na aba Executores.

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. Navegue por onde seu runner auto-hospedado está registrado:

   • Em uma organização ou repositório: navegue até a página principal e clique em Configurações.

   • Se estiver usando um executor de nível corporativo:

     1. No canto superior direito de GitHub.com, clique na sua foto de perfil e, em seguida, clique em Suas empresas.

     2. Na lista de empresas, clique na empresa que você deseja visualizar.

2. Navegue até as configurações GitHub Actions:

   • In an organization or repository:

     1. In the left sidebar, click Actions, then click Runners.

   • Se estiver usando um executor de nível corporativo:

     1. Na barra lateral da conta corporativa, clique em Policies.
     2. Em " Policies (Políticas)", clique em Actions (Ações).
     3. Clique na aba Executores.

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