Skip to main content

Como definir a configuração avançada da verificação de código com o CodeQL em escala

Você pode usar um script para configurar a configuração avançada do para code scanning de um grupo específico de repositórios na sua organização.

Quem pode usar esse recurso?

A Code scanning está disponível para todos os repositórios públicos do GitHub.com. A Code scanning também está disponível em repositórios privados pertencentes às organizações que usam o GitHub Enterprise Cloud e que têm uma licença do GitHub Advanced Security. Para obter mais informações, confira "Sobre a Segurança Avançada do GitHub".

Sobre como habilitar a configuração avançada do

para code scanning com o CodeQL em escala

Caso você precise definir uma configuração altamente personalizável de code scanning para muitos repositórios da sua organização, ou se os repositórios da sua organização não forem qualificados para a configuração padrão, é possível habilitar a code scanning em escala com a configuração avançada.

Para habilitar a configuração avançada em vários repositórios, você pode escrever um script de configuração em massa. Para executar o script com sucesso, o GitHub Actions precisa estar habilitado para o site da organização.

Como alternativa, se você não precisar ter controle granular sobre a configuração da code scanning para muitos repositórios da sua organização, defina com rapidez e facilidade a code scanning em escala com a configuração padrão. Para obter mais informações, confira "Como definir a configuração padrão da verificação de código em escala".

Como usar um script para habilitar a configuração avançada

Para repositórios que não estão qualificados para a configuração padrão, você pode usar um script de configuração em massa para definir a configuração avançada em vários repositórios.

  1. Identifique um grupo de repositórios que podem ser analisados usando a mesma configuração de code scanning. Por exemplo, todos os repositórios que criam artefatos Java usando o ambiente de produção.
  2. Crie e teste um fluxo de trabalho do GitHub Actions para chamar a ação do CodeQL com a configuração apropriada. Para obter mais informações, confira "Como definir a configuração avançada da verificação de código".
  3. Use um dos scripts de exemplo ou crie um script personalizado e adicionar o fluxo de trabalho a cada repositório no grupo.

Como estender CodeQL a cobertura com pacotes de modelos

Observação: os pacotes de modelos do CodeQL e o editor de modelos do CodeQL estão atualmente em beta e estão sujeitos a alterações. Durante o beta, os pacotes de modelo são compatíveis apenas com a análise Java/Kotlin e C#.

Se sua base de código depender de uma biblioteca ou estrutura que não seja reconhecida pelas consultas padrão no CodeQL, você poderá estender a cobertura do CodeQL no seu script de configuração em massa epecificando os pacotes de modelos do CodeQL publicados. Para obter mais informações, confira "Como personalizar sua configuração avançada para a verificação de código".

Como alternativa, se você não precisar ter controle granular da configuração de code scanning para muitos repositórios da sua organização, é possível configurar com rapidez e facilidade pacotes de modelos com a code scanning em escala com a configuração padrão. Para obter mais informações, confira "Editar as definições da configuração padrão".