Partições de monorepo

Use partições quando os times precisarem escanear e gerenciar diretórios do mesmo repositório separadamente. Cada partição aparece como um repositório no ZeroPath, com seus próprios achados, histórico de scans, configurações e agendamentos. Todas usam a mesma conexão com o controle de versão. Por exemplo, você pode dividir um repositório assim: O ZeroPath adiciona a partição de fallback automaticamente na conversão. Ela não tem caminhos de diretório próprios; seu escopo abrange os caminhos que nenhuma partição nomeada cobre. Você configura as partições. As aplicações exibidas nos modelos de ameaças e filtros de issues são descobertas a partir do código, e uma partição pode conter mais de uma aplicação.

​

Criar partições

Comece com um repositório já conectado ao ZeroPath. Criar partições ou alterar seus caminhos exige a permissão Create Repositories.

1. Abra Repositories → Monorepos e selecione Create monorepo.
2. Selecione o repositório que deseja converter.
3. Preencha Partition Name e um ou mais Directory paths para a primeira partição.
4. Use Add Another Partition para cada grupo adicional de diretórios.
5. Clique em Convert to Monorepo. O fallback é adicionado junto com as partições nomeadas.
6. Abra a página de repositório de cada partição para revisar as configurações, definir o agendamento e iniciar um scan.

Novas partições herdam as configurações da organização e das tags. Configurações específicas e agendamentos do repositório original não são copiados para as novas entradas. O histórico de scans existente permanece na entrada original. Você também pode gerenciar partições em Settings → General → Monorepo configuration na página do repositório.

​

Regras dos caminhos

• Use caminhos relativos à raiz do repositório, terminados em /, como apps/web/.
• Uma partição pode incluir vários diretórios.
• Os caminhos são prefixos de diretório. Nomes de arquivos, padrões glob como **/*.ts, caminhos absolutos e .. não são aceitos.
• Partições diferentes não podem se sobrepor: apps/ e apps/web/ não podem pertencer a partições separadas.

​

Como os scans usam as partições

​

Scans completos

Cada partição executa um scan separado. O scanner pode ler o repositório inteiro para entender imports e código compartilhado, então o tempo de scan também inclui trabalho fora dos diretórios da partição. Um achado de SAST é mantido em uma partição nomeada quando sua localização reportada ou o início do seu fluxo de dados está dentro dela. Por exemplo, a partição API pode reportar um fluxo que começa em services/api/ e alcança código vulnerável em packages/shared/. Quando seu plano impõe um limite de tamanho para scans completos, a verificação usa o escopo da partição. Para o fallback, isso exclui os diretórios atribuídos às partições nomeadas.

​

Pull requests

Scans de PR de uma partição nomeada são ignorados quando as alterações não atingem seus diretórios. No GitHub, os arquivos alterados determinam quais partições recebem scans; um PR que altera Web e API pode disparar um scan para cada uma. No exemplo acima, um PR no GitHub que altera apenas packages/shared/ é direcionado ao fallback. Ele não dispara automaticamente scans para todos os serviços que importam esse código. Execute scans completos das partições afetadas quando precisar verificar esses serviços após uma alteração no código compartilhado.

​

Editar ou remover partições

Abra Repositories → Monorepos → Existing monorepos e expanda um repositório. Use Add Partition para criar outra partição ou o ícone de lápis para alterar seu nome ou caminhos. Excluir partições exige a permissão Repository Deletion. Ao remover a configuração de monorepo, você pode manter uma entrada como repositório normal ou excluir todas do ZeroPath. Manter uma entrada limpa seu escopo de diretórios para que ela escaneie o repositório inteiro. Se restar apenas uma partição, a página oferece convertê-la de volta em um repositório normal.