DevOps: trabalhando com repositórios no GitHub

Conhecendo os comandos iniciais - Apresentação

Boas-vindas! Sou a Gabi Ribeiro e serei a sua instrutora ao longo deste curso.

Audiodescrição: Gabi Ribeiro se declara uma mulher parda e de cabelo rosa. Veste uma camiseta preta. Está no estúdio da Alura, que possui algumas decorações e está iluminado com luz azul e vermelha.

Para quem é esse curso?

Este curso é voltado para aqueles que desejam aprender sobre o uso de Git e GitHub no contexto de DevOps (Desenvolvimento e Operações). É imprescindível ter concluído o curso anterior desta formação, que aborda práticas seguras de tráfego.

O que vamos aprender?

Neste curso, você irá adquirir habilidades para utilizar o Git e o GitHub no versionamento de seus projetos, manipular branches (ramificações) e resolver conflitos, explorar o uso de issues (problemas) e pull requests (solicitações de recebimento), criar um workflow (fluxo de trabalho) de integração contínua com GitHub Actions e garantir a segurança do seu repositório por meio do Dependabot.

Exploraremos esses conceitos por meio do projeto All Books, uma plataforma de comércio eletrônico especializada na venda de livros. Para isso, faremos uso da API que sustenta o back-end desta aplicação.

Aproveite os recursos da plataforma! Além dos vídeos, temos as atividades e o apoio do fórum e da comunidade do Discord.

Bons estudos!

Conhecendo os comandos iniciais - Inicializando um repositório Git

Trabalharemos com o projeto All Books explorado anteriormente nesta formação. Atualmente, o projeto reside apenas em nosso computador. Ao abrirmos o VS Code, clicamos no primeiro ícone do menu lateral esquerdo do explorador de arquivos ou podemos usar o atalho "Ctrl + Shift + E".

Obtemos a estrutura do nosso projeto:

• src
  • config
  • data
  • middleware
  • routes
  • services
• JS server.js
• .gitignore
• {} package-lock.json
• {} package.json
• README.md

Dentro, encontramos a pasta src, comumente denominada source (fonte), contendo outras pastas com diversos códigos em JavaScript que compõem o projeto.

Compartilhando e Organizando Código com Git e GitHub

Como o código permanece exclusivamente em nossa máquina, vamos carregá-lo em uma ferramenta para compartilhá-lo com outras pessoas, viabilizando a colaboração. Isso também contribuirá para manter o código mais organizado. Para isso, faremos uso das ferramentas Git e GitHub.

Git e GitHub

O GitHub usa o sistema de versionamento Git, que permite rastrear as alterações feitas ao longo do projeto, além de permitir trabalho colaborativo.

É importante diferenciar Git e GitHub.

Git é um sistema de versionamento, enquanto GitHub é uma plataforma que usa esse sistema para armazenar nosso código.

Vamos subir o código do nosso computador para o GitHub.

Enviando o código para o GitHub

github.com

Abrimos o navegador, acessamos a página do GitHub e, para isso, precisamos criar uma conta. Já estou autenticada na conta, não detalharemos o processo de criação, mas deixaremos uma atividade, se necessário.

Criando um repositório

Precisamos criar um repositório. Para isso, clicamos no ícone no canto superior direito, selecionamos "Your Repositories" ("Seus repositórios") e clicamos no botão verde "New" ("Novo") do lado direito.

Isso abrirá opções para a criação do novo repositório em uma página intitulada "Create a new repository" ("Crie um novo repositório").

O campo "Owner" ("Proprietário") indica quem é a dona do repositório, e o campo "Repository Name" é o nome do repositório. Chamaremos o repositório de "allbooks".

allbooks

As demais configurações para o repositório podem ser mantidas como estão. Clicamos no botão verde "Create Repository" ("Criar repositório") no canto inferior direito para criar o repositório remoto, sendo o que está na web.

O GitHub oferece algumas orientações sobre como podemos enviar o código de nossa máquina para esse repositório remoto.

Iniciando um repositório Git no projeto local

Agora, retornemos ao VS Code. Fechamos o explorador de arquivos do lado esquerdo e, no menu superior do VS Code, abrimos um novo terminal. Para isso, clicamos no menu hamburger e depois em "Terminal > Novo Terminal".

Precisamos iniciar um repositório Git em nosso projeto local. Para isso, executamos o comando git init.

git init

Esse comando inicializa o repositório Git localmente, dentro da pasta do nosso projeto, criando uma pasta oculta chamada .git.

Definindo branch

Em seguida, definimos um branch com o comando git branch -M main.

git branch -M main

Não precisamos nos preocupar em entender por completo esse comando, mais adiante entenderemos ele com calma.

Conectando o repositório local com o do GitHub

Agora, vamos conectar o repositório que criamos no GitHub com o nosso repositório local em nosso computador. Voltamos ao navegador, para o repositório que criamos e copiamos a URL fornecida no campo "Quick Setup" ("Configuração rápida").

A URL a seguir pertence à instrutora; cada pessoa terá a sua própria. Estamos usando essa apenas como exemplo para ilustrar o procedimento.

https://github.com/Gabrielle-Ribeiro/allbooks.git

De volta ao terminal do VSCode, executamos o comando git remote add.

git remote add

Precisamos dar um nome a esse repositório remoto, geralmente chamamos de origin. Informamos a URL do repositório.

git remote add origin https://github.com/Gabrielle-Ribeiro/allbooks.git

Com isso, adicionamos o repositório remoto.

Rodamos o comando cls para limpar a tela e depois git remote.

git remote

Como retorno, obtemos:

origin

O terminal indicará que temos um repositório remoto chamado origin.

Conclusão

Estabelecemos a conexão entre o computador e o repositório do GitHub. No entanto, ao atualizar a página do projeto no GitHub clicando no ícone “↻” localizado no canto superior esquerdo, notamos que nada foi alterado; o código ainda não foi enviado. A seguir, você aprenderá como enviar o código do seu computador para o GitHub.

Até mais!

Conhecendo os comandos iniciais - Criando um commit

Já configuramos a conexão entre nosso repositório local e o remoto. Agora, como podemos enviar os arquivos do projeto para o GitHub? Abrimos o projeto no VS Code.

Ao clicarmos no explorador de arquivos à esquerda (atalho "Ctrl + Shift + E"), observamos que os arquivos estão destacados em uma cor diferente, aparecendo em verde com a letra "U" no final de cada arquivo, indicando algo importante.

O que isso significa? Isso indica que os códigos e arquivos do projeto em nosso repositório local ainda não foram registrados no repositório remoto. A letra "U" representa "Untracked" (não rastreado).

Adicionando, Registrando e Enviando Alterações no GitHub

Fechamos o explorador, abrimos o terminal e executamos alguns comandos. Ao rodarmos o comando git status, poderemos visualizar os arquivos que foram modificados ou adicionados em nosso projeto e ainda não foram incluídos no GitHub - eles serão destacados em vermelho.

git status

Obtemos, como retorno:

O retorno abaixo foi parcialmente transcrito. Para conferi-lo na íntegra, execute o código na sua máquina

Untracked files:

(use "git add `<file>`..." to include in what will be committed)

.gitignore

README.md

package-lock.json

package.json

src/

Limpamos a tela com o comando cls.

Adicionando arquivos

Em seguida, utilizaremos o comando git add para especificar quais arquivos desejamos adicionar.

git add

Podemos simplificar o processo de adicionar arquivos ao nosso projeto. Em vez de digitar manualmente o nome de cada arquivo (por exemplo, git add README.md e teclar "Enter"), podemos usar um atalho chamado git add ..

git add .

Esse comando adiciona todos os arquivos de uma vez. Ao rodarmos novamente o comando git status, veremos a lista de todos os arquivos que foram adicionados.

O retorno abaixo foi parcialmente transcrito. Para conferi-lo na íntegra, execute o código na sua máquina

new file: .gitignore

new file: README.md

new file: package-lock.json …

Limpamos a tela novamente com cls.

Criando um commit

Agora, criaremos um commit para registrar as mudanças realizadas. Utilizamos o comando git commit, incluindo a opção "-m" para adicionar uma mensagem sobre as alterações feitas no projeto.

git commit -m

Após o espaço, colocamos aspas duplas e escrevemos uma breve descrição das modificações. Como mensagem, optamos por "Adiciona projeto inicial". Fechamos as aspas e pressionamos "Enter".

git commit -m "Adiciona projeto inicial"

O comando de commit registra a alteração realizada. Podemos limpar a tela de novo com cls.

Podemos executar o comando git log para visualizar o registro das alterações feitas em nosso projeto.

git log

Como retorno, temos:

commit 2019f9827c7412e3234031491289f35956ee6c25 (HEAD -> main)

Author: Gabrielle Ribeiro gabrielleribeiro2010@gmail.com

Date: Mon Dec 18 17:07:48 2023 -0300

Adiciona projeto inicial

No entanto, é importante notar que essas modificações estão atualmente disponíveis apenas em nosso computador e ainda não foram enviadas para o GitHub.

Enviando para o GitHub

O último passo é utilizar o comando git push, especificando o destino como o nosso origin main.

git push origin main

Teclamos "Enter". Aparentemente ocorreu tudo bem.

Verificando no GitHub

No navegador, acessamos nosso projeto no GitHub, atualizamos a página e todos os arquivos presentes em nosso computador também estão disponíveis no GitHub. Observem que temos a branch main na parte superior esquerda, o nome da pessoa proprietária abaixo e os arquivos na sequência.

Compartilhando o projeto

Se desejarmos compartilhar o projeto, basta fornecer a URL que consta no endereço da página na parte superior, permitindo que outras pessoas visualizem e colaborem no código.

Conclusão

É evidente que no GitHub, o trabalho colaborativo desempenha um papel significativo. Quando várias pessoas trabalham simultaneamente, fazendo alterações no mesmo código, é possível que uma modificação feita por alguém não seja automaticamente refletida em nosso computador.

Como podemos incorporar as alterações feitas por outros colaboradores de volta ao nosso projeto local? Abordaremos isso em seguida.

Sobre o curso DevOps: trabalhando com repositórios no GitHub

O curso DevOps: trabalhando com repositórios no GitHub possui 103 minutos de vídeos, em um total de 62 atividades. Gostou? Conheça nossos outros cursos de Começando em DevOps em DevOps, ou leia nossos artigos de DevOps.

Matricule-se e comece a estudar com a gente hoje! Conheça outros tópicos abordados durante o curso:

• Conhecendo os comandos iniciais
• Trabalhando com branches
• Conflitos, issues e Pull Requests
• Integração contínua com GitHub
• Dependabot