Exercício – iniciar um projeto

Concluído

Agora que você passou algum tempo aprendendo os comandos essenciais do git, vamos passar para a criação de um projeto no git.

Nos exercícios a seguir, você começará a usar o Git adicionando um arquivo HTML simples à sua árvore de trabalho. Em seguida, você fará algumas alterações no diretório e aprenderá como confirmar as alterações.

Criar e adicionar (testar) um ficheiro

O Git não faz muito com diretórios vazios, então vamos adicionar um arquivo à árvore de trabalho para servir como a página inicial do site de fotos de gatos.

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

2. Utilize um comando touch para criar um ficheiro denominado index.html:

   touch index.html
   

   touch Atualiza a hora da última modificação de um arquivo, se o arquivo existir. 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 a informar que nada foi consolidado, mas o diretório contém um novo ficheiro:

   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)
   

   Repare que git status fornece sugestões sobre o que pode fazer em seguida. O Git pode ser configurado para ser menos informativo, mas nesta fase, quanto mais informações melhor.

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

   git add .
   

   Está agora a ser testada uma consolidação. O índice do Git é uma área de preparação para confirmações. É uma lista de todas as versões de arquivo que farão parte da próxima confirmação que você fizer.

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

5. Por fim, use git status novamente para garantir que suas alterações foram preparadas corretamente:

   git status
   

6. Você deve ver a 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 a primeira consolidação

Agora que o index.html foi adicionado ao índice, o passo seguinte é consolidá-lo.

1. Utilize o comando seguinte para criar uma consolidação:

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

   O -msinalizador neste comando indica ao Git que está a fornecer uma mensagem de consolidação.

   Existem inúmeras formas diferentes de criar mensagens de consolidação, mas uma boa recomendação é escrever a primeira linha a indicar o que a consolidação faz à árvore. Também é comum colocar a primeira letra em maiúscula e não utilizar ponto final para poupar espaço. Imagine que a primeira linha da mensagem completa a frase que começa com "Quando emitida, esta consolidação será..."

   Uma mensagem de consolidação pode ter múltiplas linhas. A primeira linha não deve ultrapassar 50 carateres e deve ser seguida por uma linha em branco. As linhas subsequentes não devem ter mais de 72 carateres. Esses requisitos não são firmes e remontam aos dias dos cartões perfurados e terminais "burros", mas fazem com git log que a produção pareça melhor.

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. Siga com um git status comando e confirme se a árvore de trabalho está limpa, ou seja, se a árvore de trabalho não contém alterações que não tenham sido confirmadas.

4. Agora, use um git log comando para mostrar informações sobre a confirmação:

   git log
   

5. A resposta do Git deve 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 o ficheiro index.html e consolidar a alteração

index.html foi criado para servir como página inicial do site, mas atualmente está vazio. O próximo passo é adicionar um pouco de HTML a ele. Começaremos de forma simples usando o editor integrado do Cloud Shell para adicionar uma única linha de HTML.

1. Abra o index.html no editor online ao escrever code index.html na linha de comandos 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. Você pode selecionar as reticências "..." no canto direito do editor do Cloud Shell ou use a tecla aceleradora (Ctrl+S no Windows e Linux, Cmd+S no macOS).

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

   git status
   

5. Pode 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, confirme as alterações:

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

   Observe que não executamos o git add comando desta vez para preparar nossas alterações. Em alternativa, utilizámos o sinalizador -a no comando git commit. A -a opção adiciona todos os arquivos modificados desde a última confirmação. Não adicionará novos ficheiros. Para adicionar novos arquivos, você ainda precisa do git add.

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

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

A alteração ao index.html foi consolidada. Agora existem duas versões do arquivo no repositório, embora você veja apenas uma delas (a atual). Um dos benefícios de usar o Git é que você pode reverter as alterações feitas ou retroceder no tempo e ver as versões anteriores. Pode obter mais informações sobre este tópico importante mais adiante.