DEV Community: Lorenzo Uriel

The Git Week: O Básico para Começar

Lorenzo Uriel — Tue, 04 Feb 2025 00:42:47 +0000

A ideia desse artigo é te introduzir no mundo do Git, você vai aprender os principais comandos, como iniciar com um repositório no GitHub e sobre Markdown para começar as suas documentações.

Tópicos

Aprendendo Git
- Principais Comandos
- Repositórios
- Markdown
O que é Versionamento e Tags?

Aprendendo GIT

O Git é um sistema de controle de versão, projetado para rastrear alterações em projetos de software e coordenar o trabalho de várias pessoas neles.

Desenvolvido por Linus Torvalds em 2005, o Git se destaca por sua eficiência, flexibilidade e capacidade de lidar com projetos de qualquer tamanho.

Ele registra as alterações no código-fonte, permite que várias ramificações de desenvolvimento existam simultaneamente e facilita a fusão de código de diferentes colaboradores.

Principais Comandos

`Commit`

Acontece quando queremos salvar as última atualizações que foram realizadas.

Processos relacionados ao Commit:

Verificar o status dos arquivos modificados:

git status

Adicionar os arquivos para o commit:

git add arquivo1.txt arquivo2.js

git add .

Realizar o commit:

git commit -m "Primeiro Commit"

O -m é utilizado para adicionarmos uma mensagem no commit, em seguida temos o texto "Primeiro Commit".

`Push`

Acontece quando enviamos as alterações para o repositório - "empurra" as modificações para o repositório remoto

Processos relacionados ao Push:

Realizar o push para o repositório remoto:

git push

# ou

git push origin nome-da-branch

Se for a primeira conexão e primeiro push:

git push -u origin nome-da-branch

É necessário configurar a relação entre as branches locais e remotas usando o comando acima.

O -u estabelece uma relação de acompanhamento, facilitando futuros pushes e pulls.

`Pull`

Atualiza o seu repositório local com as alterções no repositório remoto - "puxa" as alterações do repositório remoto.

Ele traz todas as alterações do seu repositório remoto para o local.

Processos relacionados ao Pull:

Realizar o pull para obter as alterações mais recentes:

git pull origin nome-da-branch

Se você já configurou a relação de acompanhamento durante o git push -u, pode usar apenas:

git pull

`Tag`

Uma tag no Git é uma referência específica a um ponto na história do seu repositório. É comumente usado para marcar versões estáveis ou importantes do seu projeto.

As tags são úteis para criar pontos de referência fixos que não se movem à medida que novos commits são feitos.

Processos relacionados ao Tag:

Listar as tags existentes:

git tag

Criar uma nova tag:

git tag -a v1.0 -m "Versão 1.0"

Este comando cria uma tag anotada chamada "v1.0" com uma mensagem descritiva "Versão 1.0".
- 1. a: Cria uma tag anotada.
- 2. v1.0: Nome da tag.
- 3. -m "Versão 1.0": Mensagem descritiva associada à tag.
Compartilhar a tag no repositório remoto:

git push origin v1.0

Repositórios

O repositório é o local onde o projeto fica armazenado. Temos os repositórios locais e remotos:

Remoto - GitHub, outro CVS ou Servidor
Local - Própria Máquina

No repositório temos os branchs (Ramos) originais do projeto que chamamos de main, podemos também criar novos branchs para desenvolver as alterações.

Exemplo: Crie um branch chamado dev-task-13, nesse branch você vai focar em finalizar a task 13 do seu backlog, quando finalizar você commita e faz um merge com a branch principal. Assim, você não afeta o seu branch principal com alterações que podem quebrar o código.

Quando trabalhamos com repositórios remotos, temos que citar as Issues - no contexto do Git, uma "issue" refere-se a uma maneira de rastrear tarefas, melhorias, erros (bugs) ou discussões relacionadas a um projeto específico.

Chamamos de Working Tree, o local onde os arquivos estão realmente armazenados. E temos o index (índice) que é local onde o Git armazena o que será commitado, entre a Working Tree e o Repositório Git.

Arquitetura Git e Comandos:

Criando um Repo Local e Remoto:

1. Vá até o seu GitHub e crie um novo repositório:

2. Navegue até o diretório local onde deseja criar o repositório — use o comando cd para entrar no diretório desejado.

cd c:\path\vagrant

3. Este comando cria um arquivo chamado README.md e insere o texto #up-website-with-vagrant nele. O >> é um operador de redirecionamento que acrescenta o texto ao final do arquivo, ou cria o arquivo se ele não existir.

echo "# up-website-with-vagrant" >> README.md

4. Inicializa um novo repositório Git no diretório atual.

git init

5. Adiciona o arquivo README.md ao índice. Isso prepara o arquivo para ser incluído no próximo commit.

git add README.md

6. Adiciona todas as alterações (Se houver)

git add .

7. Cria o primeiro commit no repositório com uma mensagem. O -m permite adicionar a mensagem de commit diretamente na linha de comando.

git commit -m "first commit"

8. Renomeia a branch padrão do repositório para main. Este comando é usado para atualizar o nome da branch principal para seguir as práticas mais recentes em relação ao uso de nomes, substituindo a antiga master

git branch -M main

9. Adiciona um repositório remoto chamado "origin". O termo "origin" é um padrão utilizado para referenciar o repositório remoto principal. O URL é o endereço do repositório no GitHub.

git remote add origin https://github.com/lorenzouriel/up-website-with-vagrant.git

10. Envia o repositório local para o repositório remoto ("origin") na branch principal (main). O -u estabelece uma relação de acompanhamento, associando automaticamente a branch local com a branch remota. Isso é útil para futuros git pull e git push sem a necessidade de especificar a branch.

git push -u origin main

Podemos verificar o nosso repositório remoto:

Markdown

No contexto do Git, o Markdown é usado para criar arquivos de documentação, como README.md. Sempre atualize o seu README.md!

Breve resumo sobre Markdown

Cabeçalhos:

# Meu Projeto

## Descrição

Uma breve descrição do meu incrível projeto.

Listas:

### Funcionalidades

- Funcionalidade 1

- Funcionalidade 2

- Funcionalidade 3

Links:

[Link para o meu site](https://www.exemplo.com)

Imagens:

![Logo do Projeto](imagens/logo.png)

Ênfase (negrito e itálico):

Este é um **projeto incrível** que usa _tecnologias modernas_.

Citações:

> "Beba água." - Ivysson

Tabelas:

| Nome       | Função           |
|------------|------------------|
| João       | Desenvolvedor    |
| Maria      | Designer         |

Código:

O que é Versionamento e Tags?

Já trabalhou com lançamento de versões?

Ou com Tags no Git?

As tags são bem importantes em nossos projetos - com elas conseguimos identificar em qual momento no tempo ocorreram os principais lançamentos e versões.

É um meio de organizar e documentar o seu trabalho.

Mas quando você for adicionar as tags, vai saber a diferença de cada número?

Vou te explicar a diferença de forma simples e prática:

Major: São alterações incompatíveis com as versões anteriores (Reestruturou tudo? Adicione +1 - v2.0.0)
Minor: São alterações importantes e compativéis com a versão anterior (Adicionou uma nova funcionalidade? Adicione +1 v2.1.0)
Correção: Erros e bugs que não afetam a versão (Encontrou um bug e corrigiu? Adicione +1 v2.1.1)
Build: É um controle interno do Git e do versionamento, ele não fica necessariamente à vista quando você especifica a versão.

Exemplo:

Obrigado por ler até aqui!

Fazendo o que precisa ser feito.

Vagrant Descomplicado: Um Guia Prático

Lorenzo Uriel — Tue, 04 Feb 2025 00:36:51 +0000

A minha ideia é te ensinar a usar as principais funcionalidades do Vagrant em apenas um artigo, de forma simplificada e rápida. Você vai aprender o que é, para que serve, quais as suas funcionalidades e vai subir uma VM comigo no decorrer do artigo!

Tópicos

Introdução
- O que é IaC?
- O que é um Hypervisor?
- O que é uma VM?
- O que é o Vagrant?
Instalando o Ambiente
Iniciando com uma Box
Gerenciando uma Box
- Criando um VagrantFile
- Comandos para Manipular uma VM
- Configurando Redes, Hostname e Liberando Porta na VM
- Scripts Shell para Automatizar Tarefas
Criando uma BOX

Introdução

O que é IaC?

IaC, ou Infraestrutura como Código, é uma abordagem na qual a infraestrutura de TI é gerenciada e provisionada usando código, em vez de configurações manuais. Sendo assim, facilita a automação e gestão ágil dos ambientes, chega de "na minha máquina funciona".

O que é um Hypervisor?

Um hypervisor é um software ou firmware que permite a execução de máquinas virtuais (VMs) em um único hardware físico. Ele age como uma camada de virtualização entre o hardware físico do computador e os sistemas operacionais convidados, permitindo que vários sistemas operacionais compartilhem o mesmo hardware simultaneamente. Nós iremos utilizar VirtualBox para subir as nossas VMs com o Vagrant.

O que é uma VM (Virtual Machine)?

É um software que simula um ambiente de computador físico e permite a execução de sistemas operacionais e aplicativos como se estivessem em hardware físico real.

O que é o Vagrant?

É uma ferramenta de linha de comando utilizada para agilizar todo o WorkFlow de uma VM, também, controlar todo o LifeCycle da VM. Nós manipulamos um Hypervisor por meio de comandos Vagrant, ele traduz os comandos enviados para os comandos do Hypervisor utilizado. O Vagrant abstrai detalhes específicos do hypervisor, proporcionando uma abordagem consistente e portátil para configuração de ambientes. O uso de arquivos de configuração (Vagrantfiles) permite uma configuração fácil e rápida de ambientes.

Imagina que você subiu um ambiente de Dev com tudo, quer adicionar esse ambiente em um outro servidor ou enviar para uma pessoa? Compartilhe o VagrantFile.

Instalando o Ambiente

Você precisa apenas fazer o download e instalar. Depois, podemos avançar para os próximos tópicos.

Iniciando com uma Box

Uma Box é basicamente o sistema operacional que você vai virtualizar. Ou seja, uma Box é uma VM empacotada em um arquivo chamado Box. O Vagrant tem uma comunidade onde as pessoas compartilham as suas Boxes, chamada Vagrant Cloud. Mas você também pode criar uma Box própria.

Imagine que no seu ambiente você utiliza o SQL Server, Power BI e outras ferramentas. Com o Vagrant, você poderia baixar uma Box com apenas o sistema operacional Windows, instalar o que você precisa e, depois, fechar uma Box sua. Assim, você iria compartilhar uma Box pronta para os ambientes ou compartilhar com a comunidade!

Vagrant Cloud

Comandos:

Vamos imaginar que você quer baixar o Box do windows no seu servidor

vagrant box add gusztavvargadr/windows-server-2019-standard

Baixou algumas Boxes? Vamos lista-las

vagrant box list

Listar opções de comando do vagrant box (Você pode usar o -h para todos os comandos)

vagrant box -h (Geral)

vagrant box list -h  (Específico)

Quer verificar se existe alguma Box desatualizada no seu servidor?

vagrant box outdated (No próprio diretório)

vagrant box outdated -- global (Vai verificar todas que tenho no servidor)

Quer remover a que está desatualizada?

vagrant box prune (Vai remover todas as desatualizadas)

Ou... atualizar as mesmas sem danificar?

vagrant box update

Caso você queira remover apenas uma Box específica.

vagrant box remove vm/name

Esses são os comandos principais para você utilizar e baixar uma Box, vou deixar o meu cmd como exemplo:

Gerenciando uma Box

O VagrantFile é a magia do Vagrant, do que adianta ter uma VM se você não consegue manipular a mesma? Bom, isso acabou...

O VagrantFIle é o local em que adicionaremos/modificaremos todas as configurações necessárias para subir a nossa VM. Você pode configurar opções de rede, hardware e até mesmo Shell Scripts para automatizar instalações.

Criando um VagrantFile

Essa é a etapa que interessa, é aqui que vamos iniciar a primeira etapa com o Vagrant.

Comandos:

Para criar um VagrantFile, utilize o comando no seu repositório:

vagrant init vm/name

Ele vai verificar se a Box já foi instalada (Instalamos com o vagrant box add) Se ela não estiver sido instalada, ele irá instalar.

Esse é um exemplo do VagrantFile criado (Ele vem cheio de comentários, eu removi e deixei só o que importa nesse primeiro momento):

Vagrant.configure("2") do |config|
  config.vm.box = "peru/windows-server-2019-standard-x64-eval" # Box utilizada 
  config.vm.provider "virtualbox" do |vb| # Hypervisor utilizado 
      vb.memory = "1024" # Memória disponibilizada
      vb.cpus = 10  # Configuração de CPUs
      vb.name = "Article Test 01" # Nome da VM no Hypervisor
  end
end

Pronta para subir a mesma? Só rodar o seguinte comando no diretório:

vagrant up

E aguardar...

Mas em poucos instantes, sua VM está no ar!

Comandos para Manipular uma VM

Vou listar alguns dos comandos principais que você precisa saber para manipular a sua VM no ar.

Comandos:

Verificar o Status da VM

vagrant status

Desligar a VM

vagrant halt

Subir a VM (Se existir - Liga/Se não - Cria)

vagrant up

Suspende a VM

vagrant suspend

Reiniciar a VM

vagrant reload

Destruir ou Remover a VM

vagrant destroy (y/n?)

Configurando Redes, Hostname e Liberando Porta na VM

Para configurar as redes, nós temos duas opções: NAT ou BRIDGE.

NAT - É uma tecnologia usada para compartilhar uma conexão de internet com vários dispositivos em uma rede local. O roteador recebe um endereço IP público da internet e atribui um endereço privado a cada dispositivo na rede local. Assim, o roteador traduz os endereços IPs privados para os público, permitindo que dispositivos na rede acessem a internet.
BRIDGE - É uma tecnologia utilizada para conectar duas ou mais redes locais em uma única rede. Uma ponte (Bridge) é um dispositivo que conecta duas redes e permite que os dispositivos em uma rede se conectem aos dispositivos de outra rede, como se estivessem na mesma rede.

No meu exemplo, eu vou escolher o NAT.

Exemplos:
Conexão NAT - DHCP.

Vagrant.configure("2") do |config| 
  config.vm.network "private_network", type: "dhcp" 

  config.vm.box = "peru/windows-server-2019-standard-x64-eval" # Box utilizada

end

Conexão NAT - IP Fixo

Vagrant.configure("2") do |config| 
    config.vm.network "private_network", ip: "192.168.25.10" 

    config.vm.box = "peru/windows-server-2019-standard-x64-eval" # Box utilizada
end

Após definirmos o tipo da rede, podemos fornecer um exemplo de porta.

Suponha que a máquina virtual (VM) que você está iniciando seja responsável por um servidor SQL, e que seja necessário estabelecer uma conexão com o SQL Server. Para realizar isso, é necessário liberar a porta associada ao SQL Server - por padrão é a 1433.

Vagrant.configure("2") do |config| 
  config.vm.network "forwarded_port", guest: 1433, host: 1433

  config.vm.box = "peru/windows-server-2019-standard-x64-eval" # Box utilizada 
end

guest: 1433: Especifica que a porta no ambiente da máquina virtual (o "convidado") é a 1433.
host: 1433: Indica que a porta no ambiente do host (a máquina física que está executando a VM) é também 1433.

O Hostname é a última etapa que quero abordar neste capítulo, com ele vamos especificar um nome para a conexão em nossa rede local. Por exemplo, nós criamos a nossa rede em NAT, para conectar na máquina remotamente, precisaremos nos conectar pelo IP. O problema disso é: nosso IP não é fixo!

Quando utilizamos o hostname, isso não é necessário. Podemos nos conectar pelo hostname!

Vagrant.configure("2") do |config|   
  config.vm.box = "peru/windows-server-2019-standard-x64-eval" # Box utilizada

  config.vm.hostname = "VMEXARTICLE"

end

Assim ficou o nosso VagrantFile após os aprendizados deste capítulo:

Vagrant.configure("2") do |config|
  config.vm.box = "peru/windows-server-2019-standard-x64-eval"

  config.vm.network "forwarded_port", guest: 1433, host: 1433 
  config.vm.network "private_network", type: "dhcp"

  config.vm.provider "virtualbox" do |vb|
      vb.memory = "1024"
      vb.cpus = 10
      vb.name = "Article Test 01" # Nome da VM no Hypervisor
  end

  config.vm.hostname = "VMEXARTICLE"

end

Você pode reiniciar a VM para aplicar as alterações. Para testar o hostname, faça um PING VMEXARTICLE.

Scripts Shell para Automatizar Tarefas

Isso sem sombra de dúvidas é o que mais amo no Vagrant, você pode rodar Scripts Shell (Ou Bash Scripts se for Linux), de forma totalmente automatizada.

Nesse exemplo eu vou liberar o Firewall da máquina, você pode fazer de duas maneiras.

Especificando o comando direto no VagrantFile

 config.vm.provision "shell", inline: <<-SHELL
    netsh advfirewall set allprofiles state off
  SHELL

Especificando um path para o comando (Ele precisa estar no mesmo diretório do VagrantFile)

config.vm.provision "shell", path: "disable_firewall.ps1"

Quero que você dê uma pausa aqui e pense... quantas coisas é possível fazer com essa automatização?

Caso a sua máquina tenha subido, não é necessário reiniciar para que os scripts Shell rodem. Você pode realizar o seguinte comando:

vagrant provision

Ele vai identificar qual parte no VagrantFile possue o "config.vm.provision" e rodar todos. Segue exemplo:

VagrantFile final:

Vagrant.configure("2") do |config|
  config.vm.box = "peru/windows-server-2019-standard-x64-eval"

  config.vm.network "forwarded_port", guest: 1433, host: 14330

  config.vm.network "private_network", type: "dhcp"

  config.vm.provider "virtualbox" do |vb|
      vb.memory = "1024"
      vb.cpus = 10
      vb.name = "Article Test 01" 
  end

  config.vm.hostname = "VMEXARTICLE"

  config.vm.provision "shell", inline: <<-SHELL
    netsh advfirewall set allprofiles state off
  SHELL

end

Simples, não? ;)

Criando uma BOX

Imagine esse cenário agora: Você instalou tudo que era necessário para o ambiente do projeto e deseja escalar o mesmo para o servidor de produção.

O que podemos fazer? Nós podemos fechar a NOSSA Box - vamos empacotar a Box em um arquivo .box

Exemplo:

Criando o arquivo .box da nossa VM

vagrant package --output article_test.box

vagrant package: é o comando, você pode adicionar o -h para ver as outras opções do mesmo
--output: Complemento do comando para exportar a Box
article_test.box: Nome dado para a nossa Box

Após criar o arquivo .box, você precisa adicionar ela em sua lista de Boxes. Igual fizemos no primeiro exemplo, quando puxamos a nossa VM do Vagrant Cloud. Porém, agora vamos buscar localmente!

Adicionando a nossa Box na lista de Boxes

vagrant box add --name article-test article_test.box

vagrant box add: Comando para criar a Box
-- name article-test: Nome que você vai dar para a Box
article_test.box: Nome que foi dado para o arquivo .Box

Pronto! Você tem uma infra como código agora...

Se te interessou, pesquise mais sobre o assunto, o Vagrant tem muito mais a oferecer. Garanto que não vai se arrepender!

Obrigado por ler até aqui!

Fazendo o que precisa ser feito.

Como Alterar o Nome do Seu SQL Server

Lorenzo Uriel — Sun, 02 Feb 2025 23:35:56 +0000

Alterar o nome SQL pode trazer alguns benefícios quando você pensa em melhorar a identificação, organização e até mesmo o gerenciamento do seu servidor localmente:

Conecte-se à sua instância do SQL Server usando o SQL Server Management Studio (SSMS).
Abra uma nova janela de consulta.
Execute o seguinte comando para verificar o nome do servidor atual:

SELECT @@SERVERNAME;

Este comando retornará o nome do servidor atual, copie o resultado.

Agora para alterar o nome do servidor, execute todos os comandos abaixo:

EXEC sp_dropserver 'old_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO

Substitua ‘old_server_name’ pelo nome do servidor atual e ‘new_server_name’ pelo novo nome do servidor.

Imagine que eu queira tirar apenas minha instância.

EXEC sp_dropserver 'LOCAL\MSSQLSERVER';
GO
EXEC sp_addserver 'LOCAL', 'local';
GO

Reinicie o serviço SQL Server para aplicar as alterações. Você pode fazer isso usando o SQL Server Configuration Manager ou no SSMS.

Execute o comando novamente para verificar o nome do servidor atual:

SELECT @@SERVERNAME;

É importante observar que alterar o nome do servidor pode ter implicações para qualquer aplicação ou serviço que dependa da instância do SQL Server ou do antigo nome. Certifique-se de atualizar as strings de conexão!

Obrigado por ler até aqui!

Fazendo o que precisa ser feito.