Configurando executores para revisão de código do GitHub Copilot

Use executores auto-hospedados ou executores maiores GitHubhospedados para Revisão de código do Copilot.

Neste artigo

Sobre o uso de GitHub Actions para ferramentas de revisão de código

Revisão de código do Copilot usa GitHub Actions para executar os recursos de agente, incluindo coleta completa do contexto do projeto e quaisquer recursos em prévia pública. Por padrão, Revisão de código do Copilot usa runners hospedados por GitHub. Os minutos do Actions são consumidos da franquia do plano atual da sua conta ou organização para revisões de repositórios privados, e qualquer uso que exceder os minutos incluídos será cobrado pelas taxas padrão GitHub Actions.

Se sua organização tiver desabilitado executores hospedados em GitHub, os recursos de agente não estarão disponíveis. Nesse caso, as revisões de código retornarão a uma revisão mais limitada. As organizações nessa situação podem usar executores auto-hospedados.

Também é possível atualizar para executores hospedados em GitHub maiores para obter melhor desempenho.

Configurar executores auto-hospedados para revisão de código

Execute Revisão de código do Copilot usando executores GitHub Actions auto-hospedados com o ARC (Actions Runner Controller). Primeiro, você deve configurar conjuntos de dimensionamento gerenciados por ARC em seu ambiente. Para obter mais informações sobre ARC, consulte Controlador de Ações Runner.

Aviso

O ARC é a única solução com suporte oficial para auto-hospedagem Revisão de código do Copilot. Por motivos de segurança, não use executores auto-hospedados não ARC.

Revisão de código do Copilot é compatível apenas com os executores do Ubuntu x64 Linux.

Para configurar os executores auto-hospedados para Revisão de código do Copilot:

  1. Configure controles de segurança de rede para seus GitHub Actions executores para garantir que Revisão de código do Copilot não tenha acesso aberto à sua rede ou à Internet pública.

    Você deve configurar o firewall para permitir conexões com os hosts padrão necessários para GitHub Actions executores auto-hospedados, além dos seguintes hosts:

    • api.githubcopilot.com
    • uploads.github.com
    • user-images.githubusercontent.com

  2. No arquivo copilot-setup-steps.yml, defina o atributo runs-on para o nome do conjunto de dimensionamento gerenciado pelo ARC. Para obter mais informações, consulte Configurar o ambiente de desenvolvimento.

    # ...

jobs:
  copilot-setup-steps:
    runs-on: arc-scale-set-name
    # ...

Atualizar para executores maiores GitHubGitHub Actions-hospedados

Por padrão, Revisão de código do Copilot é executado em um executor padrão GitHub Actions . Os executores maiores fornecem melhor desempenho (CPU e memória), mais espaço em disco e recursos avançados, como Azure rede privada. Consulte Executores avançados.

Observação

O uso de maiores executores hospedados por GitHub é cobrado a uma taxa por minuto mais alta. Para obter mais informações, consulte Cobrança do GitHub Actions.

  1. Configure os executores maiores para sua organização. Consulte Gerenciar executores maiores.

  2. Se você estiver usando executores maiores na rede privada do Azure, configure sua rede privada do Azure para permitir o acesso de saída aos seguintes hosts:

    • api.githubcopilot.com
    • uploads.github.com
    • user-images.githubusercontent.com

  3. No seu arquivo copilot-setup-steps.yml, defina o atributo runs-on para o rótulo dos executores maiores que você quer que o Revisão de código do Copilot utilize. Consulte Como executar trabalhos em executores maiores.

    # ...

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-4-core
    # ...

Configurar corredores no nível da organização

Os proprietários da organização podem definir um tipo de executor padrão para Revisão de código do Copilot e agente de nuvem Copilot em todos os repositórios da organização e controlar se os repositórios individuais podem substituir esse padrão.

Observação

O tipo de executor em nível de organização aplica-se tanto a Revisão de código do Copilot quanto a agente de nuvem Copilot. Os repositórios ainda podem substituir o padrão da organização usando copilot-setup-steps.yml, a menos que você desative Permitir que os repositórios personalizem o tipo de executor. Para obter mais informações, consulte Configurando executores do agente de nuvem do GitHub Copilot em sua organização.

Isso será útil se sua organização exigir que todas as revisões de código e agente de nuvem tarefas sejam executadas em corredores específicos, por exemplo, para usar corredores maiores para obter melhor desempenho ou executores auto-hospedados que tenham acesso a recursos internos.

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Tipo de executor.

  5. Ao lado de "Configuração do tipo de executor", clique em .

  6. Na caixa de diálogo "Editar tipo de executor", selecione o tipo de executor a ser usado por padrão em sua organização e clique em Salvar seleção do executor.

    • Executor padrãoGitHub: Revisão de código do Copilot e agente de nuvem Copilot usará o executor hospedado padrãoGitHub.
    • Executor com rótulo: Revisão de código do Copilot e agente de nuvem Copilot usarão um executor que corresponda ao rótulo que você especificar.

  7. Opcionalmente, para impedir que repositórios individuais substituam a configuração do executor no nível da organização usando seu copilot-setup-steps.yml arquivo, desabilite Permitir repositórios para personalizar o tipo de executor.