Anterior

Avançar

Exercício – Iniciar um projeto

Concluído

Agora que você dedicou um tempo a aprender os comandos do Git essenciais, vamos mudar para a criação de um projeto no Git.

Nos próximos exercícios, você começará a usar o Git adicionando um arquivo HTML simples à árvore de trabalho. Em seguida, você fará algumas alterações no diretório e aprenderá a fazer commit das alterações.

Criar e adicionar (preparar) um arquivo

O Git não faz muita coisa com diretórios vazios. Portanto, vamos adicionar um arquivo à árvore de trabalho para que ele sirva como a home page do site de fotos de gatos.

1. Verifique se a sessão do Cloud Shell ainda está ativa e se você está na pasta do repositório, chamada Cats.

2. Use um comando touch para criar um arquivo chamado index.html:

   touch index.html
   

   touch atualiza a hora da última atualização de um arquivo, caso ele exista. Se o arquivo não existir, o Git criará um arquivo vazio com esse nome de arquivo.

3. Agora, use git status para obter o status da árvore de trabalho:

   git status
   

   O Git responde informando que nada foi confirmado, mas o diretório contém um novo arquivo:

   No commits yet
   
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   
       index.html
   
   nothing added to commit but untracked files present (use "git add" to track)
   

   Observe que git status fornece dicas sobre o que você pode fazer em seguida. O Git pode ser configurado para ser menos descritivo, mas neste estágio, quanto mais informações, melhor.

4. Use git add para adicionar o novo arquivo ao índice do Git, seguido por git status para verificar o status. Não se esqueça do ponto no final do comando. Ele instrui o Git a indexar todos os arquivos do diretório atual que foram adicionados ou modificados.

   git add .
   

   Um commit acaba de ser preparado. O índice do Git é uma área de preparo para commits. É uma lista de todas as versões de arquivo que farão parte do próximo commit a ser feito.

   Em vez de usar git add ., você poderia ter usado git add index.html, pois index.html era o único arquivo novo no diretório. Mas se vários arquivos tivessem sido adicionados, git add . serviria para todos eles.

5. Por fim, use git status novamente para verificar se as alterações foram preparadas corretamente:

   git status
   

6. Você verá uma saída como este exemplo:

   On branch main
   
   Initial commit
   
   Changes to be committed:
     (use "git rm --cached <file>..." to unstage)
   
       new file:   index.html
   

Fazer seu primeiro commit

Agora que index.html foi adicionado ao índice, a próxima etapa será fazer commit dele.

1. Use o seguinte comando para criar um commit:

   git commit index.html -m "Create an empty index.html file"
   

   O sinalizador-m deste comando informa o Git de que você está fornecendo uma mensagem de commit.

   Há muitas maneiras diferentes de formular mensagens de commit, mas uma boa diretriz é escrever a primeira linha para que ela indique o que o commit faz na árvore. Também é comum colocar a primeira letra em maiúscula e não usar o ponto final para economizar espaço. Imagine que a primeira linha da mensagem complete a frase que começa com "Quando enviado por push, esse commit fará..."

   Uma mensagem de commit pode ter várias linhas. A primeira linha não deve ter mais de 50 caracteres e deve ser seguida por uma linha em branco. As linhas seguintes não devem ter mais de 72 caracteres. Esses requisitos não são rígidos e remontam à época de cartões de pontos e terminais não inteligentes, mas, de fato, aprimoram a saída git log.

2. O Git responde com uma confirmação do que você fez:

   [main (root-commit) 87e874c] Create an empty index.html file
    1 file changed, 0 insertions(+), 0 deletions(-)
    create mode 100644 index.html
   

3. Acompanhe isso com um comando git status e confirme se a árvore de trabalho está limpa, ou seja, se ela não contém nenhuma alteração que não foi confirmada.

4. Agora, use um comando git log para mostrar as informações sobre o commit:

   git log
   

5. A resposta do Git será algo como este exemplo:

   commit 87e874c4aeeb3f9692ae5d9875235353708d7dd5
   Author: User Name <user-name@contoso.com>
   Date:   Fri Nov 15 20:47:05 2019 +0000
   
   Create an empty index.html file
   

Modificar index.html e fazer commit da alteração

index.html foi criado para servir como a home page do site, mas está vazio no momento. A próxima etapa será adicionar um HTML a ele. Começaremos de maneira simples usando o editor interno do Cloud Shell para adicionar uma só linha de HTML.

1. Abra index.html no editor online digitando code index.html no aviso do terminal:

   code index.html
   

2. Digite ou cole as seguintes instruções no editor:

   <h1>Our Feline Friends</h1>
   

3. Salve o arquivo e feche o editor online. Selecione as reticências "…" no canto direito do editor do Cloud Shell ou use a tecla de acelerador (CTRL + S no Windows e no Linux e Cmd + S no macOS).

4. Use um comando git status para verificar o status da árvore de trabalho:

   git status
   

5. Você poderá ver que o Git está ciente das alterações feitas:

   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git checkout -- <file>..." to discard changes in working directory)
   
       modified:   index.html
   
   no changes added to commit (use "git add" and/or "git commit -a")
   

6. Agora, faça commit das alterações:

   git commit -a -m "Add a heading to index.html"
   

   Observe que não executamos o comando git add desta vez para preparar as alterações. Em vez disso, usamos o sinalizador -a no comando git commit. A opção -a adiciona todos os arquivos que você modificou desde o último commit. Ela não adicionará novos arquivos. Para adicionar novos arquivos, você ainda precisará do comando git add.

7. Verifique a saída. Ele será semelhante a este exemplo:

   [main 8c9143a] Add a heading to index.html
    1 file changed, 1 insertion(+)
   

A alteração em index.html foi confirmada. Agora, há duas versões do arquivo no repositório, embora você só veja uma delas (a atual). Um dos benefícios de usar o Git é que você pode reverter as alterações feitas ou voltar no tempo e ver as versões anteriores. Daqui a pouco, falaremos mais sobre esse importante tópico.

Continuar