Chapters ▾ 2nd Edition

2.1 Fundamentos do Git - Obtendo um Repositório Git

Se você puder ler apenas um capítulo para começar a usar o Git, é este. Este capítulo cobre todos os comandos básicos que você precisa para fazer a grande maioria das coisas que você passará seu tempo fazendo com o Git. Ao final do capítulo, você deverá ser capaz de configurar e inicializar um repositório, começar e parar de rastrear arquivos, além de preparar (stage) e fazer commit de alterações. Também mostraremos como configurar o Git para ignorar determinados arquivos e padrões de arquivo, como desfazer erros de maneira rápida e fácil, como navegar pelo histórico do seu projeto e visualizar alterações entre commits, e como enviar (push) e puxar (pull) de repositórios remotos.

Obtendo um Repositório Git

Você normalmente obtém um repositório Git de uma de duas maneiras:

  1. Você pode pegar um diretório local que não esteja sob controle de versão, e transformá-lo em um repositório Git, ou

  2. Você pode clonar um repositório Git existente de outro lugar.

Em ambos os casos, você acaba com um repositório Git em sua máquina local, pronto para o trabalho.

Inicializando um repositório em um diretório existente

Se você tem um diretório de projeto que não está atualmente sob controle de versão e deseja começar a controlá-lo com o Git, você primeiro precisa ir para o diretório desse projeto. Se você nunca fez isso, parece um pouco diferente dependendo de qual sistema você está executando:

para Linux:

$ cd /home/user/my_project

para macOS:

$ cd /Users/user/my_project

para Windows:

$ cd C:/Users/user/my_project

e digite:

$ git init

Isso cria um novo subdiretório chamado .git que contém todos os arquivos de repositório necessários — um esqueleto de repositório Git. Neste ponto, nada em seu projeto é rastreado ainda. Veja Git Internals (Por Dentro do Git) para mais informações sobre exatamente quais arquivos estão contidos no diretório .git que você acabou de criar.

Se você quiser começar a controlar a versão de arquivos existentes (em oposição a um diretório vazio), você provavelmente deve começar a rastrear esses arquivos e fazer um commit inicial. Você pode realizar isso com alguns comandos git add que especificam os arquivos que você deseja rastrear, seguidos por um git commit:

$ git add *.c
$ git add LICENSE
$ git commit -m 'Initial project version'

Vamos analisar o que esses comandos fazem em apenas um minuto. Neste ponto, você tem um repositório Git com arquivos rastreados e um commit inicial.

Clonando um Repositório Existente

Se você quiser obter uma cópia de um repositório Git existente — por exemplo, um projeto para o qual você gostaria de contribuir — o comando de que você precisa é git clone. Se você está familiarizado com outros VCSs como Subversion, notará que o comando é "clone" e não "checkout". Essa é uma distinção importante — em vez de obter apenas uma cópia de trabalho, o Git recebe uma cópia completa de quase todos os dados que o servidor possui. Toda versão de todo arquivo do histórico do projeto é baixada (pulled down) por padrão quando você executa git clone. De fato, se o disco do seu servidor for corrompido, muitas vezes você pode usar quase qualquer um dos clones em qualquer cliente para restaurar o servidor ao estado em que estava quando foi clonado (você pode perder alguns hooks do lado do servidor e coisas do tipo, mas todos os dados versionados estariam lá — veja Colocando o Git em um Servidor para mais detalhes).

Você clona um repositório com git clone <url>. Por exemplo, se você quiser clonar a biblioteca vinculável (linkable library) do Git chamada libgit2, pode fazer isso assim:

$ git clone https://github.com/libgit2/libgit2

Isso cria um diretório chamado libgit2, inicializa um diretório .git dentro dele, baixa todos os dados para aquele repositório e faz o checkout de uma cópia de trabalho da versão mais recente. Se você entrar no novo diretório libgit2 que acabou de ser criado, verá os arquivos do projeto lá, prontos para serem trabalhados ou usados.

Se você quiser clonar o repositório em um diretório com um nome diferente de libgit2, pode especificar o novo nome do diretório como um argumento adicional:

$ git clone https://github.com/libgit2/libgit2 mylibgit

Esse comando faz a mesma coisa que o anterior, mas o diretório de destino é chamado mylibgit.

O Git possui vários protocolos de transferência diferentes que você pode usar. O exemplo anterior usa o protocolo https://, mas você também pode ver git:// ou user@server:path/to/repo.git, que usa o protocolo de transferência SSH. Colocando o Git em um Servidor apresentará todas as opções disponíveis que o servidor pode configurar para acessar seu repositório Git e os prós e contras de cada uma.