Saltar para o conteúdo principal
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 Assets → 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.
  • Descobertas de código. Uma partição nomeada pode reportar uma descoberta quando a localização ou o início do fluxo de dados está dentro dela. Por exemplo, API pode reportar um fluxo que começa em services/api/ e chega a packages/shared/. O fallback usa a localização reportada.
  • Descobertas de dependências. Uma partição nomeada pode reportar uma descoberta se contiver o uso do pacote ou o manifesto que o declara. Para um manifesto ou lockfile compartilhado na raiz, a descoberta acompanha o uso do pacote quando o ZeroPath o identifica em uma partição nomeada. Caso contrário, vai para o fallback, se houver. Sem fallback, as partições nomeadas podem reportar dependências compartilhadas sem uso no seu escopo.
  • Descobertas de fim de vida do repositório. Elas vão para o fallback ou, se não houver fallback, para cada partição nomeada.
Se uma partição nomeada usa um pacote declarado só nos diretórios do fallback, o ZeroPath precisa resolver as versões exatas do manifesto para mostrar a descoberta na partição nomeada. Esse caminho não cobre todos os manifestos e resolvedores. Se uma dependência esperada não aparecer, revise a cobertura e mantenha um lockfile suportado junto ao manifesto quando possível. 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

O scan de PR de cada partição, inclusive o fallback, analisa os arquivos alterados que pertencem à partição. No GitHub, um PR que altera Web e API pode disparar um scan para cada uma. No GitHub, se um push posterior mudar apenas os arquivos de outra partição, as descobertas anteriores podem passar para o novo commit. Partições que compartilham uma verificação do ZeroPath podem mantê-la em falha enquanto uma partição tiver um resultado com falha em aberto. Abra a verificação para identificar qual partição está causando a falha. 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 Assets → 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.