{"meta":{"title":"Capacitação em qualidade de código em organizações e empresas","intro":"GitHub Code Quality pode abranger um repositório ou milhares de repositórios a partir de um único ponto de controle, oferecendo a todas as equipes a mesma linha de base de qualidade e dando a você as proteções necessárias para mantê-lo.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/enterprise-cloud@latest/code-security/concepts","title":"Concepts"},{"href":"/pt/enterprise-cloud@latest/code-security/concepts/code-quality","title":"Qualidade do código"},{"href":"/pt/enterprise-cloud@latest/code-security/concepts/code-quality/enablement-at-scale","title":"Habilitação em escala"}],"documentType":"article"},"body":"# Capacitação em qualidade de código em organizações e empresas\n\nGitHub Code Quality pode abranger um repositório ou milhares de repositórios a partir de um único ponto de controle, oferecendo a todas as equipes a mesma linha de base de qualidade e dando a você as proteções necessárias para mantê-lo.\n\n## Como a habilitação funciona em toda a sua empresa\n\nCode Quality é controlado em três níveis, para que você possa decidir quanta autonomia fornecer às organizações e repositórios:\n\n* **Empresa:** O proprietário da empresa deve primeiro habilitar Code Quality para a empresa. Até que o façam, os proprietários da organização não poderão habilitá-lo.\n* **Organização:** Os proprietários da organização controlam quais repositórios habilitaram ou desabilitaram Code Quality , concedendo acesso a todos os repositórios, uma lista selecionada ou repositórios que correspondem a um filtro. Eles também podem impor essas configurações para que os administradores do repositório não possam alterá-las.\n* **Repositório:** Os administradores do repositório podem habilitar ou desabilitar Code Quality para repositórios individuais, a menos que a imposição no nível da organização se aplique.\n\nQuando Code Quality está habilitado em um repositório, a análise de CodeQL é executada por meio de GitHub Actions e exibe resultados em pull requests e no branch padrão. Os desenvolvedores veem verificações de qualidade e anotações em suas solicitações de pull.\n\n## Acesso ao repositório no nível da organização\n\nNo nível da organização, você controla Code Quality com uma única configuração de **acesso do Repositório** . Essa configuração determina quais repositórios Code Quality habilitaram e quais os têm desabilitados: os repositórios dentro de sua seleção estão habilitados e os repositórios fora da seleção estão desabilitados.\n\n> \\[!IMPORTANT]\n> Alterar a configuração de **acesso ao Repositório** pode habilitar **e** desabilitar Code Quality em vários repositórios ao mesmo tempo. Por exemplo, se você habilitar Code Quality para repositórios correspondentes a um filtro, qualquer repositório que não corresponda ao filtro será desabilitado. Antes de sua alteração ser aplicada, uma caixa de diálogo mostra o número total de repositórios habilitados e desabilitados, juntamente com o impacto da cobrança.\n\n### Opções de acesso ao repositório\n\nVocê pode aplicar uma das seguintes opções de cada vez.\n\n| Opção                                                                                                                                                                                                                                          | Behavior                                                                                                                                                                                                                        |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Nenhum repositório**                                                                                                                                                                                                                         | Desabilita Code Quality em todos os repositórios atuais e futuros da organização.                                                                                                                                               |\n| **Permitir que os repositórios decidam**                                                                                                                                                                                                       | A organização não habilita nem desabilita Code Quality. Os administradores do repositório escolhem se devem habilitá-lo para seus próprios repositórios. Essa opção não pode ser imposta.                                       |\n| **Todos os repositórios**                                                                                                                                                                                                                      | Habilita Code Quality para todos os repositórios atuais e futuros.                                                                                                                                                              |\n| **Repositórios selecionados...**                                                                                                                                                                                                               |                                                                                                                                                                                                                                 |\n| Code Quality Habilita uma lista específica de repositórios que você escolher. Os repositórios que você não selecionar estão desabilitados e os novos repositórios não são habilitados automaticamente. Ideal para projetos-piloto ou exceções. |                                                                                                                                                                                                                                 |\n| **Encontrando um filtro...**                                                                                                                                                                                                                   | Habilita os repositórios Code Quality que correspondem a um filtro que você define, agora e no futuro. Os repositórios que não correspondem estão desabilitados. Consulte [repositórios de filtragem](#filtering-repositories). |\n\n### Filtrando repositórios\n\nAo escolher **Correspondência de um filtro...**, você cria um filtro dinâmico que habilita automaticamente para repositórios existentes Code Quality e futuros que correspondem aos seus critérios. Isso é útil para a governança contínua em escala.\n\nVocê pode filtrar qualquer combinação dos seguintes critérios:\n\n* **Visibilidade:** Se os repositórios são públicos, privados ou internos. Útil para políticas amplas, como habilitar Code Quality para todos os repositórios privados.\n* **Status do fork:** Indica se os repositórios são forks. Útil quando as bifurcações não devem consumir recursos de análise.\n* **Propriedade personalizada:** Se os repositórios têm um valor de propriedade personalizado específico. Por exemplo, você pode direcionar repositórios com uma `team:platform` propriedade.\n\nTodas as condições em um filtro são combinadas com `AND`, portanto, um repositório deve atender a todas as condições para ser habilitado. Você também pode excluir repositórios que correspondem a condições específicas.\n\n### Controlando o acesso\n\nPor padrão, os administradores do repositório podem alterar as configurações Code Quality dos próprios repositórios. Para evitar isso, habilite **Exigir acesso**.\n\nA imposição bloqueia os estados habilitados e desabilitados definidos pela opção **Acesso ao repositório**;, portanto, os administradores do repositório não podem substituí-los. Isso melhora a consistência em toda a sua organização, mas reduz a flexibilidade para administradores individuais do repositório.\n\n* A imposição se aplica à maioria das opções **Acesso ao repositório** selecionadas, incluindo **Nenhum repositório**, que impõe Code Quality como desabilitado.\n* A imposição não está disponível com a opção **Permitir que os repositórios decidam**, o que deixa a escolha intencionalmente para os administradores do repositório.\n\n## Planejando sua implementação\n\nComo uma única alteração na configuração de **acesso ao repositório** pode habilitar Code Quality em vários repositórios de uma só vez, e cada análise consome GitHub Actions minutos, vale a pena implementar isso em fases, em vez de fazer tudo de uma vez. Como você planeja, pese algumas coisas:\n\n* **Custo e capacidade.** Confirme se os executores podem absorver a carga GitHub Actions adicional antes de você habilitar Code Quality em larga escala.\n* **Quanto impor.** A imposição oferece uma cobertura consistente e impede que administradores de repositório recusem, embora isso remova a flexibilidade. Deixá-lo desativado permite às equipes aceitar dentro da própria linha do tempo.\n* **Quando expandir.** Comece com um grupo piloto pequeno e representativo, confirme se a análise é executada sem problemas e os desenvolvedores confiam nas descobertas e, em seguida, ampliam sua seleção ou filtro para cobrir mais repositórios.\n\nPara ver um procedimento de implementação passo a passo, incluindo o teste dos seus limites de qualidade no modo de avaliação antes de impô-los, consulte [Implementando GitHub Code Quality em larga escala](/pt/enterprise-cloud@latest/code-security/how-tos/maintain-quality-code/roll-out-at-scale?utm_campaign=code-quality-ga-july-2026\\&utm_medium=docs\\&utm_source=docs-enable-at-scale-roll-out-plan)."}