Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Usar etiquetas com executores auto-hospedados

Você pode usar etiquetas para organizar os seus executores auto-hospedados com base em suas características.

Observação: GitHub Actions estava disponível para GitHub Enterprise Server 2.22 como um beta limitado. O beta terminou. GitHub Actions está agora geralmente disponível em GitHub Enterprise Server 3.0 ou posterior. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.


Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.

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 sua instância do GitHub Enterprise Server. 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.

  • Empresa: Você deve ser um administrador do site de GitHub Enterprise

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.

    • If using an enterprise-level runner:

      1. No canto superior direito de qualquer página, clique em .
      2. Na barra lateral esquerda, clique em Visão geral da empresa.
      3. Na barra lateral da empresa, Políticas.
  2. Navegue até as configurações GitHub Actions:

    • In an organization or repository: Click Actions in the left sidebar.
    • If using an enterprise-level runner: Click Actions under " Policies".
  3. Locate the list of runners under "Self-hosted runners".

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

  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. Alterar etiqueta do executor

  6. No campo "Filtrar etiquetas", digite o nome da sua nova etiqueta e clique em Criar nova etiqueta. Adicionar etiqueta 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 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.

    • If using an enterprise-level runner:

      1. No canto superior direito de qualquer página, clique em .
      2. Na barra lateral esquerda, clique em Visão geral da empresa.
      3. Na barra lateral da empresa, Políticas.
  2. Navegue até as configurações GitHub Actions:

    • In an organization or repository: Click Actions in the left sidebar.
    • If using an enterprise-level runner: Click Actions under " Policies".
  3. Locate the list of runners under "Self-hosted runners".

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

  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. Alterar etiqueta do executor

  6. Clique em uma etiqueta a ser atribuída ao seu executor auto-hospedado.

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.

    • If using an enterprise-level runner:

      1. No canto superior direito de qualquer página, clique em .
      2. Na barra lateral esquerda, clique em Visão geral da empresa.
      3. Na barra lateral da empresa, Políticas.
  2. Navegue até as configurações GitHub Actions:

    • In an organization or repository: Click Actions in the left sidebar.
    • If using an enterprise-level runner: Click Actions under " Policies".
  3. Locate the list of runners under "Self-hosted runners".

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

  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. Alterar etiqueta do executor

  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

Observação: Se você substituir um executor existente, você deverá reatribuir quaisquer etiquetas personalizadas.