Skip to main content

Usar rótulos com os 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 rótulos para encaminhar trabalhos para tipos específicos de executores auto-hospedados, confira "Como usar executores auto-hospedados em um fluxo de trabalho".

Um executor auto-hospedado pode estar localizado no repositório, na organização ou nas configurações da empresa do your enterprise. Para gerenciar um executor auto-hospedado, você deve ter as seguintes permissões, dependendo de onde o executor auto-hospedado foi adicionado:

  • Repositório do usuário: você precisa ser o proprietário do repositório.

  • Organização: você precisa ser um proprietário da organização.

  • Repositório da organização: você precisa ser um proprietário da organização ou ter acesso de administrador no repositório.

  • Empresa: você precisa ser um administrador do site do GitHub Enterprise.

Criar etiquetas personalizadas

  1. Navegue até onde seu executor está registrado:

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

    • Se estiver usando um executor de classe empresarial:

      1. No canto superior à direita de GitHub AE, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub AE
  2. Navegue até as configurações GitHub Actions:

    • Em uma organização ou em um repositório:

      1. Na barra lateral esquerda, clique em Ações.
      2. Na barra lateral esquerda, em "Actions", clique em Executores.
    • Se estiver usando um executor de classe empresarial:

      1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Executores. 1. Na lista de executores, clique no nome do executor que você deseja configurar.
  3. Na seção "Etiquetas", clique em .

  4. 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 uma etiqueta a um executor auto-hospedado

  1. Navegue até onde seu executor está registrado:

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

    • Se estiver usando um executor de classe empresarial:

      1. No canto superior à direita de GitHub AE, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub AE
  2. Navegue até as configurações GitHub Actions:

    • Em uma organização ou em um repositório:

      1. Na barra lateral esquerda, clique em Ações.
      2. Na barra lateral esquerda, em "Actions", clique em Executores.
    • Se estiver usando um executor de classe empresarial:

      1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Executores. 1. Na lista de executores, clique no nome do executor que você deseja configurar. 1. Na seção "Etiquetas", clique em .
  3. 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 até onde seu executor está registrado:

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

    • Se estiver usando um executor de classe empresarial:

      1. No canto superior à direita de GitHub AE, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub AE
  2. Navegue até as configurações GitHub Actions:

    • Em uma organização ou em um repositório:

      1. Na barra lateral esquerda, clique em Ações.
      2. Na barra lateral esquerda, em "Actions", clique em Executores.
    • Se estiver usando um executor de classe empresarial:

      1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Executores. 1. Na lista de executores, clique no nome do executor que você deseja configurar. 1. Na seção "Etiquetas", clique em .
  3. 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 a API REST dos "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.

    Nota: 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. Use também 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 executor existente, você deverá reatribuir quaisquer etiquetas personalizadas.