Versionamento de código com Git e GitHub/GitLab

Fala pessoal, tudo certo?

Agora que você já criou sua API de gerenciamento de tarefas em Flask, o próximo passo é garantir que seu código esteja versionado e armazenado de forma segura. Para isso, usaremos o Git para controle de versão e o GitHub (ou GitLab, conforme sua preferência) para hospedar nosso repositório remoto.

Massss ...

O que é Git e GitHub?

Git é um sistema de controle de versão distribuído, amplamente utilizado no desenvolvimento de software. Ele permite que você acompanhe mudanças no código, colabore com outros desenvolvedores e retorne a versões anteriores do projeto, se necessário. Cada vez que você faz uma alteração significativa no código, você pode "comitar" essas mudanças, criando um ponto no histórico do repositório que pode ser revisitado a qualquer momento.

GitHub (ou alternativas como GitLab e Bitbucket) é uma plataforma de hospedagem de repositórios Git na nuvem. Além de fornecer uma interface visual para navegar no seu código versionado, o GitHub permite colaborar com outros desenvolvedores, revisar alterações e contribuir para projetos de código aberto. Ele também facilita a integração com pipelines de CI/CD (integração e entrega contínua) para automatizar testes e deploys.

Ao combinar Git e GitHub, você obtém uma poderosa ferramenta para controlar a evolução do seu código, manter backups e colaborar eficientemente com equipes ou até mesmo contribuir com a comunidade de software aberta.

Entendido o conceito, agora vamos a prática.

1. Instalando o Git

Antes de começarmos, verifique se o Git está instalado na sua máquina:

• MacOS/Linux: Execute git --version no terminal.
• Windows: Se o comando não funcionar, baixe o instalador do Git aqui e siga as instruções.

2. Configurando o Git

Após instalar o Git, configure-o com suas credenciais de usuário (nome e e-mail):

git config --global user.name "Seu Nome"
git config --global user.email "seuemail@example.com"

Isso vincula suas alterações de código à sua identidade.

3. Inicializando um repositório Git

Agora, vamos inicializar o repositório Git na pasta do seu projeto. Navegue até o diretório onde está sua API e execute:

git init

Esse comando inicializa um repositório Git localmente.

4. Adicionando arquivos para controle de versão

Depois de inicializar o repositório, adicione os arquivos do projeto à área de stage (onde você prepara os arquivos para o commit):

git add .

O . indica que todos os arquivos da pasta serão adicionados.

5. Criando o primeiro commit

Agora que os arquivos estão no stage, crie um commit para registrar a primeira versão do seu código:

git commit -m "Primeira versão da API de gerenciamento de tarefas"

O -m permite adicionar uma mensagem descrevendo o que foi feito.

6. Criando um repositório remoto no GitHub/GitLab

Agora que você tem um repositório local, vamos conectar com um repositório remoto para armazenar o código na nuvem.

1. Acesse GitHub ou GitLab.
2. Crie uma conta, se ainda não tiver uma.
3. No GitHub/GitLab, clique em New Repository (Novo Repositório).
4. Dê um nome ao repositório, por exemplo, task-api, e clique em Create Repository.

Agora você terá um repositório remoto vazio.

7. Conectando o repositório local ao remoto

Com o repositório remoto criado, vamos conectá-lo ao repositório local. No terminal, execute:

git remote add origin https://github.com/seuusuario/task-api.git

Substitua o URL com o link para o seu repositório no GitHub/GitLab.

8. Enviando o código para o repositório remoto

Finalmente, envie seu código para o GitHub/GitLab com o comando:

git push -u origin main

9. Autenticação com Personal Access Token (PAT)

O GitHub agora exige o uso de Personal Access Tokens em vez de senhas. Siga estes passos para gerar e usar o token:

1. Acesse GitHub Personal Access Tokens e clique em Generate new token.
2. Escolha as permissões adequadas (como repo) e clique em Generate token.
3. Ao fazer git push, use o seu nome de usuário do GitHub e, em vez da senha, cole o token gerado.

O código agora está no seu repositório remoto e pode ser acessado de qualquer lugar!

Como testar se está funcionando

1. Acesse o GitHub/GitLab e verifique se os arquivos estão no seu repositório.
2. Tente clonar o repositório em outro diretório usando:

git clone https://github.com/seuusuario/task-api.git

Bônus: Comandos úteis do Git

• Verificar o status dos arquivos no repositório:

git status 

• Ver o histórico de commits:

git log

• Reverter para um commit anterior:

git checkout <commit-hash>

Agora seu código está seguro e versionado no GitHub ou GitLab. Você aprendeu como usar o Git para versionar o código e manter um backup remoto. Na próxima postagem, vamos criar uma esteira de deploy automático para sua API.

Abs e até a próxima.
:wq!