Delimitar um repositório e configurar ferramentas Git

Repositórios grandes, ficheiros grandes e identidades de assinatura diferentes precisam de controlos próprios. Abra a ação correspondente ao repositório ativo, confira a pré-visualização e aplique a alteração necessária para a sua tarefa.

Delimitar um monorepo com sparse checkout

1. Abra sparse checkout e selecione os diretórios necessários. Filtrar a lista conserva a seleção; escolher uma pasta ancestral torna redundantes as seleções das pastas descendentes.
2. Confira a quantidade de ficheiros visíveis. O modo cone mantém os diretórios escolhidos, os ficheiros da raiz e os ficheiros diretamente nas pastas ancestrais.
3. Escolha sparse index apenas se as suas outras ferramentas Git forem compatíveis. Pode reduzir o index; não garante builds mais rápidos nem instala dependências do projeto.
4. Aplique a seleção revista. Edições pendentes, ficheiros ignorados ou outra operação Git podem bloquear a alteração. Resolva o estado indicado e gere uma nova pré-visualização se o repositório mudou.
5. Use a ação de restaurar a árvore completa quando precisar novamente de todos os ficheiros rastreados.

Isto altera quais os ficheiros rastreados presentes na árvore de trabalho, sem alterar o histórico completo do repositório. Não faz partial clone. Configurações non-cone existentes podem ser desativadas, mas não editadas pelo seletor. Os limites atuais são 250.000 ficheiros, 20.000 diretórios e 1.000 diretórios selecionados; o excesso é indicado, sem truncar silenciosamente a seleção.

Gerir ficheiros grandes com Git LFS

Abra o painel de extensões do repositório para inspecionar Git LFS, os seus ficheiros, a disponibilidade dos objetos e as regras no .gitattributes da raiz. As ações exigem Git LFS 3.8.1 ou superior instalado no computador.

1. Instale a configuração LFS neste repositório se necessário. Isto configura o repositório, sem instalar o executável Git LFS. Caminhos de hooks partilhados ou inseguros podem impedir a ação; os hooks existentes não são substituídos à força.
2. Adicione ou remova um padrão de rastreio e confirme. Confira a alteração no .gitattributes e inclua-a num commit quando apropriado.
3. Selecione um remoto para obter os objetos LFS de HEAD. Depois, materialize os objetos disponíveis nos ficheiros de trabalho quando necessário.

O painel mostra até 2.000 ficheiros e indica cobertura parcial. Não edita todos os ficheiros de atributos em subpastas, migra o histórico existente para LFS, remove objetos com prune nem os envia automaticamente. Rastrear um padrão não converte commits anteriores.

Atualizar um submódulo com destino definido

No mesmo painel, selecione um submódulo e compare o commit atual com o registado no index do repositório pai. Confira a inicialização e as alterações pendentes antes de atualizar.

A atualização inicializa quando necessário, obtém os dados e faz checkout do commit registado em detached HEAD. Não avança até à ponta do ramo remoto, altera o commit registado no pai nem atualiza submódulos aninhados recursivamente. Caminhos com alterações ou inseguros e operações em curso são recusados. Abra o submódulo como um contexto próprio do Riff para trabalhar nele.

Um fetch cancelado pode deixar objetos transferidos ou um submódulo parcialmente inicializado. Leia o estado atualizado antes de tentar novamente; cancelar não significa que todas as etapas anteriores foram desfeitas.

Aplicar um perfil de identidade ou assinatura

1. Abra a identidade do repositório e confira o autor efetivo, a origem da configuração e a política da organização. Escolha a identidade Git, a conta Gapfy quando disponível ou o comportamento predefinido permitido pela política.
2. Guarde um perfil com nome para reutilização. Guardar ou carregar o perfil não altera o repositório; reveja e confirme Aplicar separadamente.
3. Escolha assinatura herdada, OpenPGP ou SSH conforme necessário. Indique um identificador de chave ou referência de chave pública SSH. O Riff não importa nem armazena chaves privadas de assinatura. Desativar a assinatura exige uma escolha explícita.
4. Confira o âmbito de destino. Com configuração específica de worktree ativa, Aplicar altera essa worktree; caso contrário, altera a configuração partilhada do repositório. A configuração global e os ficheiros incluídos não são reescritos.
5. Inspecione a assinatura de HEAD. O resultado distingue ausência de commit, commit sem assinatura, assinatura válida e não verificada, sem criar um commit de teste.

A política de identidade da organização prevalece sobre o perfil. A verificação no computador não prova que o próximo commit poderá ser assinado nem que um host remoto confiará na assinatura. Configure a ferramenta, o agente e a confiança separadamente conforme as exigências da organização.

Para ramos dependentes, use stacks e publicação coordenada. Para tarefas independentes, use contextos de trabalho e worktrees.