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.
Criar etiquetas personalizadas
-
Acesse a página principal da organização ou repositório onde o grupo de executor auto-hospedado está registrado.
-
Clique em Configurações.
-
In the left sidebar, click Actions, then click Runners.
-
Na lista de executores, clique no executor que você deseja configurar.
-
Na seção "Etiquetas", clique em .
-
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
-
Acesse a página principal da organização ou repositório onde o grupo de executor auto-hospedado está registrado.
-
Clique em Configurações.
-
In the left sidebar, click Actions, then click Runners.
-
Na lista de executores, clique no executor que você deseja configurar.
-
Na seção "Etiquetas", clique em .
-
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
-
Acesse a página principal da organização ou repositório onde o grupo de executor auto-hospedado está registrado.
-
Clique em Configurações.
-
In the left sidebar, click Actions, then click Runners.
-
Na lista de executores, clique no executor que você deseja configurar.
-
Na seção "Etiquetas", clique em .
-
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.