15.01.2025

Estrutura do repositório Git

O controle de versão é uma parte essencial do desenvolvimento moderno de software, e ter as ferramentas e os serviços certos pode facilitar muito o gerenciamento de seus projetos. A AlexHost oferece soluções de hospedagem VPS robustas e seguras, perfeitas para hospedar seus repositórios Git. Com recursos como acesso total à raiz, endereços IPv4 dedicados, armazenamento NVMe ultrarrápido e suporte para vários sistemas operacionais, a AlexHost garante desempenho e confiabilidade perfeitos. Seja você um desenvolvedor individual ou parte de uma grande equipe, a AlexHost oferece a flexibilidade e o poder necessários para gerenciar seus projetos com eficiência.

Compreender a estrutura de um repositório Git é crucial para gerenciar com eficiência o código-fonte de seu projeto, rastrear alterações e colaborar com outras pessoas.

Aqui está um detalhamento dos componentes essenciais e da estrutura de um repositório Git:

1. Diretório de trabalho

O diretório de trabalho é o local onde residem os arquivos reais do seu projeto. Quando você clona um repositório Git, obtém uma cópia de todos os arquivos rastreados, que são colocados no seu diretório de trabalho. Essa é a área em que você edita ativamente os arquivos, faz alterações e adiciona novo conteúdo.

Arquivos modificados: Qualquer arquivo que você editar em seu diretório de trabalho será considerado modificado até que você o prepare ou redefina as alterações.
Arquivos não rastreados: Os arquivos que ainda não são rastreados pelo Git aparecerão no diretório de trabalho como não rastreados até que sejam preparados e confirmados.

2. Área de preparação (índice)

A área de preparação (também chamada de índice) é um local intermediário onde as alterações nos arquivos são coletadas antes de serem confirmadas no repositório. Você adiciona arquivos ou alterações à área de preparação usando o comando git add. As alterações na área de preparação farão parte do próximo commit.

Adicionar alterações à área de preparação:
git add
Visualizar a área de preparação: Você pode ver o que está na área de preparação usando o git status.

3. Diretório Git (pasta .git)

O diretório Git, armazenado na pasta .git, é o coração de qualquer repositório Git. Ele contém todas as informações essenciais sobre o histórico, a configuração e o estado atual do seu projeto. Esse diretório é criado automaticamente quando você inicializa ou clona um repositório Git.

Principais componentes do diretório .git:

HEAD: um arquivo que aponta para o commit atual em sua ramificação.
Ramificações: Contém informações sobre as ramificações no repositório.
Objetos: Armazena todos os objetos, como commits, blobs (dados de arquivo) e árvores (estrutura de diretório).
Refs: Contém referências a commits, incluindo cabeçalhos (ramificações), tags e ramificações de rastreamento remoto.
Config: O arquivo de configuração do seu repositório local, onde são armazenadas configurações como controles remotos ou informações do usuário.
Logs: Armazena os registros de todas as atividades, como commits, checkouts e rebases.
Hooks: Scripts personalizados que podem acionar ações antes ou depois de determinados eventos do Git (por exemplo, commit, push).

4. Histórico de compromissos

Cada commit é um instantâneo do seu repositório em um momento específico. Um commit inclui alterações em arquivos juntamente com metadados como a mensagem do commit, o autor e o registro de data e hora. Os commits formam o histórico do seu projeto.

Os commits são armazenados no diretório .git/objects.
Cada commit aponta para o commit anterior (exceto o primeiro), formando uma cadeia vinculada que pode ser visualizada como o histórico do projeto.

git log # Exibir o histórico de commits

5. Filiais

Uma ramificação é um ponteiro para um commit específico, permitindo que você trabalhe em diferentes versões do seu projeto simultaneamente. Por padrão, o Git começa com uma ramificação chamada main (ou master em versões mais antigas).

Ponteiro de ramificação: Os ramos são simplesmente ponteiros para um commit. Criar um novo branch significa criar um ponteiro para o commit atual, permitindo que você faça novos commits nesse branch sem afetar outros branches.

git branch # Cria uma nova ramificação git checkout # Alterna para uma ramificação existente

HEAD: o ponteiro HEAD no Git indica a ramificação ou o commit atual em que você está trabalhando. Normalmente, ele aponta para o commit mais recente em sua ramificação atual.

6. Tags

As tags são referências a pontos específicos no seu histórico do Git, geralmente usadas para marcar versões de lançamento (por exemplo, v1.0, v2.0). Ao contrário das ramificações, as tags não são atualizadas com novos commits.

Tags leves: São ponteiros simples para um commit, semelhantes a uma ramificação.
Tags anotadas: Contêm metadados adicionais, como o nome do marcador, a data e uma mensagem de marcação.

git tag v1.0 # Criar uma tag leve git tag -a v1.0 -m “Versão 1.0” # Criar uma tag anotada

7. Controles remotos

Um remote no Git é uma referência a uma cópia do seu repositório que está hospedada em outro lugar, geralmente em plataformas como GitHub, GitLab ou Bitbucket. Os remotos são usados para colaboração, permitindo que você faça push de alterações ou pull de alterações de outras cópias do repositório.

Origem: Por padrão, o repositório remoto principal é chamado de origem.

git remote add origin # Adiciona um repositório remoto git fetch origin # Busca alterações do repositório remoto git push origin main # Empurra alterações para o branch principal remoto

8. Objetos no Git

O diretório de objetos do Git (.git/objects) contém os quatro tipos de objetos principais que compõem o histórico do repositório:

Blob: Armazena o conteúdo real de um arquivo.
Árvore: Representa um diretório, mapeando nomes de arquivos para objetos blob e subdiretórios (outros objetos de árvore).
Commit: Armazena metadados sobre cada alteração (autor, data, mensagem) e aponta para um objeto de árvore.
Tag: Aponta para um commit e armazena informações sobre o marcador e a mensagem (no caso de tags anotadas).

9. Ganchos

O Git permite que você defina scripts personalizados (hooks) que podem ser acionados em vários estágios do fluxo de trabalho do Git. Esses scripts podem ser executados automaticamente após ou antes de eventos como confirmação, envio ou mesclagem. Os hooks podem reforçar a qualidade do código, executar testes ou acionar pipelines de CI/CD.

Os Hooks são armazenados no diretório .git/hooks/.

Gancho de pré-compilação: É executado antes da criação de um commit.
Gancho pós-compromisso: É executado após a criação de um commit.

10. Registros

O Git armazena registros de todas as ações no repositório, como commits, checkouts, merges e reversões. Esses registros ajudam na depuração e na revisão das ações realizadas no repositório.

Git Reflog: Mantém um registro de todas as alterações no ponteiro HEAD, permitindo que você se recupere de ações como uma redefinição de ramificação.

git reflog # Visualize o reflog para ver as ações recentes

Resumo da estrutura do repositório Git

Diretório de trabalho: Contém arquivos e diretórios em seu estado atual.
Área de preparação (índice): Onde as alterações são preparadas antes de serem confirmadas.
Diretório Git (.git): Mantém os dados principais, incluindo objetos, configuração e registros.
Compromissos: Registro de alterações com metadados, formando o histórico do projeto.
Ramificações: Ponteiros para commits específicos que permitem o desenvolvimento paralelo.
Tags: Referências nomeadas a commits específicos, geralmente para marcar versões.
Remotos: Referências a repositórios hospedados em outros lugares para colaboração.
Objetos: Os componentes principais do Git, incluindo bolhas, árvores e commits.

Ao compreender essa estrutura, você pode navegar e gerenciar o seu repositório Git de forma eficaz, garantindo uma colaboração e um controle de versão tranquilos durante o desenvolvimento do seu projeto.