O que é um repositório
No Git, um repositório armazena objetos e referências que permitem consultar o histórico versionado de um projeto. Commits registram estados, enquanto branches e tags ajudam a localizar pontos desse histórico.
A pasta usada para editar costuma reunir uma árvore de trabalho e os metadados do Git. Também existem repositórios bare, sem uma árvore de arquivos preparada para edição, comuns em situações de compartilhamento.
Arquivos no disco e conteúdo versionado
Gravar um arquivo na pasta não significa registrá-lo no histórico. O status permite distinguir alterações rastreadas e arquivos novos, enquanto os commits preservam os estados efetivamente registrados.
Arquivos ignorados também podem permanecer apenas no ambiente local. Colocar um caminho no gitignore não remove automaticamente um arquivo já rastreado nem apaga conteúdo que entrou em commits anteriores.
Local e remoto podem avançar separadamente
Um remoto é outro repositório com o qual o seu pode trocar objetos e referências. Ele pode estar num serviço de hospedagem ou em outro local acessível, sem ser obrigatoriamente um servidor público.
Seu histórico local pode conter commits ainda não enviados, enquanto o remoto pode receber alterações que você não consultou. Compare as referências depois de atualizar as informações disponíveis, sem presumir sincronização automática.
Clonar cria outra cópia do repositório
A clonagem obtém o conteúdo conforme as opções usadas e prepara referências para acompanhar a origem. Um clone raso pode omitir parte dos commits antigos, e uma clonagem parcial pode buscar determinados objetos apenas quando necessários.
A cópia também não inclui automaticamente todos os recursos da plataforma de hospedagem. Discussões, configurações de acesso e artefatos de execução têm formas próprias de armazenamento e recuperação.
Conferir o que o projeto precisa para funcionar
Além de consultar o histórico, identifique dependências, variáveis e serviços necessários para executar a aplicação. Esses requisitos devem estar documentados sem publicar segredos, pois o clone do código não reproduz sozinho todo o ambiente.
Os commits e as branches organizam o trabalho preservado pelo Git. A conferência do repositório começa por separar esse histórico das alterações locais e dos recursos externos que o projeto utiliza.
Dúvidas frequentes
Perguntas frequentes sobre Repositório
- Toda pasta do projeto está registrada no Git?
- Não. Podem existir arquivos alterados no disco, ainda não rastreados ou ignorados. O histórico preserva o conteúdo registrado, não toda alteração local.
- Um repositório precisa estar no GitHub?
- Não. O Git funciona localmente e pode trocar conteúdo com outros repositórios por diferentes meios. GitHub é uma plataforma de hospedagem e colaboração.
- Clonar sempre traz todo o histórico?
- Não. Opções de clone raso ou parcial podem limitar o histórico ou os objetos obtidos. Submódulos e arquivos externos também podem exigir obtenção própria.
- Um clone substitui o backup completo do serviço?
- Não. Banco, uploads, segredos e registros da plataforma podem estar fora do conteúdo Git. A recuperação do serviço exige conferir esses itens separadamente.
Para continuar
Recursos relacionados
Documentação
Pro Git: obtenção de um repositório
Criação local e clonagem de um repositório.
Abrir recursoDocumentação
Git: opções de clonagem
Clonagem, histórico limitado e repositório bare.
Abrir recursoDocumentação
Git: arquivos ignorados
Tratamento dos arquivos que não devem ser rastreados.
Abrir recursoAplicação na formação
Developer Workspace
O repositório mantém os arquivos e o histórico do projeto, que podem ser sincronizados com uma cópia remota.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.