Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Esta versão do GitHub Enterprise foi descontinuada em 2023-01-18. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

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.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

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 GitHub Enterprise Server instance. 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 Enterprise Server, 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 Enterprise Server
  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. Localize a lista de executores em “Executores”. 1. Se o executor estiver em um grupo, localize o grupo de executores e clique em para ver a lista de executores. Lista de grupos de executores 1. Localize o executor que deseja atualizar e clique em para ver o menu de seleção do rótulo. Esse menu exibe todos os rótulos personalizados disponíveis para o seu executor auto-hospedado. Os rótulos já atribuídos para o executor auto-hospedado têm um ao lado. Alterar rótulo do executor
  3. No campo "Filtrar rótulos", digite o nome do novo rótulo e clique em Criar rótulo. Adição de rótulo do executor

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 Enterprise Server, 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 Enterprise Server
  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. Localize a lista de executores em “Executores”. 1. Se o executor estiver em um grupo, localize o grupo de executores e clique em para ver a lista de executores. Lista de grupos de executores 1. Localize o executor que deseja atualizar e clique em para ver o menu de seleção do rótulo. Esse menu exibe todos os rótulos personalizados disponíveis para o seu executor auto-hospedado. Os rótulos já atribuídos para o executor auto-hospedado têm um ao lado. Alterar rótulo do executor
  3. Clique em uma etiqueta a ser atribuída ao seu executor auto-hospedado.

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 Enterprise Server, 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 Enterprise Server
  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. Localize a lista de executores em “Executores”. 1. Se o executor estiver em um grupo, localize o grupo de executores e clique em para ver a lista de executores. Lista de grupos de executores 1. Localize o executor que deseja atualizar e clique em para ver o menu de seleção do rótulo. Esse menu exibe todos os rótulos personalizados disponíveis para o seu executor auto-hospedado. Os rótulos já atribuídos para o executor auto-hospedado têm um ao lado. Alterar rótulo do executor
  3. 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.

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.