backDotNet

Desenvolvimento de back-end seguindo as melhores práticas do .NET, Arquitetura Limpa, Código Limpo e princípios SOLID.

Motivo de cada decisão . Clean Architecture Promove a separação clara de preocupações, facilitando manutenção e escalabilidade.

. SOLID Garante modularidade, reusabilidade e facilidade de testes.

. Código Limpo Aumenta a clareza do código e facilita a colaboração.

. JWT Autenticação simples, segura e amplamente aceita em APIS RESTful.

. Testes automatizado Garantem qualidade e evitam regressões

. CI/CD Automatiza a entrega, reduzindo erros humanos e acelerando ciclos de desenvolvimento.

Instalando o WSL 2 Agora com o nosso caminho de instalação definido, vamos colocar a mão na massa de fato, primeiramente instalando o WSL 2.

Os passos descritos abaixo são baseados na documentação oficial da Microsoft, sendo necessária a execução de apenas um comando para desencadear o processo automático. O requisito para a instalação é ter o Windows 11, ou o Windows 10 na versão 20H1 e superior (Build 19041 e superior)3.

Passo 1: Habilitar recursos e instalar Ubuntu Com o PowerShell (ou o Prompt de Comando do Windows) aberto no modo de administrador, executar o comando wsl --install. Esse comando habilitará os recursos necessários para executar o WSL e irá instalar a distribuição Ubuntu do Linux. Para que a instalação seja concluída será necessário reiniciar o computador.

Comando wsl --install

Finalização da instalação

Passo 2: Criar usuário no Ubuntu Após reiniciar o computador, caso uma janela de terminal do Ubuntu não abra automaticamente, vá no menu iniciar e busque por "Ubuntu". Clicando no ícone será aberto o terminal da distribuição. Após aberto, a distribuição será inicializada, solicitando a criação de um usuário e senha. Obs.: ao digitar a senha, nada será exibido. Isso é um recurso de segurança padrão do terminal.

Criação de usuário no Ubuntu

2.4 Instalando o Windows Terminal Antes das próximas etapas é recomendável a instalação do Windows Terminal, que é uma interface moderna, unificada, e customizável para vários shells. Ele irá facilitar a nossa vida na hora de colar e executar os comandos de múltiplas linhas durante o processo de instalação do Docker. No Windows 11 ele já está presente nativamente, mas no Windows 10 é preciso instalá-lo via Microsoft Store.

Windows Terminal

Ao abrir o Windows Terminal, o PowerShell será iniciado por padrão, mas você pode selecionar o terminal do Ubuntu clicando na seta ∨, ao lado do botão de +:

Instalando o editor de código Como editor de código, nós recomendamos a utilização do VSCode. Mas caso você tenha algum outro que seja da sua preferência, sinta-se à vontade para usá-lo.

Para fazer o download do VSCode, basta acessar o site oficial e clicar no botão Download for Windows. Após isso, basta executar o arquivo e seguir os passos do instalador.

VSCode

Você pode abrir a pasta do seu projeto no VSCode diretamente do WSL usando o comando code (Obs: vamos ensinar na próxima seção como você pode clonar o repositório do seu projeto no WSL):

Abrindo VSCode

Isso irá abrir uma janela do VSCode. E para ter uma experiência mais integrada com o WSL, você deve instalar a extensão chamada WSL. Ao abrir o VSCode pela primeira vez, aparecerá um pop up já recomendando a instalação dela. Mas caso não apareça, você pode clicar no ícone de Extensões no menu lateral e buscar por "WSL".

Extensão WSL

Configurando o Git e GitHub Como o Git já vem instalado por padrão na distribuição Ubuntu, não precisamos nos preocupar em fazer isso. Mas, para que o nosso ambiente fique 100% preparado para realizar os commits, é preciso configurar o usuário do Git localmente, e cadastrar as credenciais em nossa conta do GitHub para que possamos enviar as modificações facilmente para o repositório remoto.

5.1 Identificando usuário local do Git No Git, os commits precisam ser identificados com um nome e um endereço de email. Nós precisamos fazer essa configuração apenas uma vez, e é um processo simples. Basta executar os seguintes comandos:

git config --global user.name "Seu Nome"

git config --global user.email "seu_email@exemplo.com"

Identificando usuário local do Git

5.2 Configurando o editor padrão do Git Algumas operações no Git requerem a abertura de um editor de texto. Vamos configurá-lo para que ele use o VSCode como o editor padrão. Para isso, basta executar o seguinte comando:

git config --global core.editor "code --wait"

5.3 Se conectando com o GitHub com SSH O protocolo Secure Shell (SSH) é uma forma de nos conectarmos a um servidor remoto de modo seguro, usando criptografia. A autenticação da conexão é feita através de um par de chaves (ou senhas), onde uma fica armazenada na máquina do cliente que está buscando a conexão, e a outra no servidor a ser contactado. A vantagem de usar esse sistema é que não precisamos inserir o nosso login e senha sempre que quisermos nos conectar ao GitHub.

Estou assumindo uma instalação zerada do WSL, e portanto que nenhuma chave SSH esteja presente. Caso esse não seja o seu caso, verifique se você já possui uma chave seguindo essas instruções. Se sim, você poderá usá-la ou gerar uma nova seguindo os passos abaixo.

Passo 1: Gerando uma nova chave SSH Execute o comando abaixo no terminal do Ubuntu, substituindo o email de exemplo pelo que você usa na sua conta do GitHub. Ele irá gerar uma nova chave SSH associada ao email passado.

ssh-keygen -t ed25519 -C "seu_email@exemplo.com"

Será retornada uma mensagem avisando que a chave está sendo gerada, e uma outra solicitando um caminho e nome para o arquivo da mesma. Basta apertar Enter para aceitar a localização padrão.

Generating public/private ed25519 key pair. Enter a file in which to save the key (/home/usuario/.ssh/id_ed25519):

Em seguida, será solicitada uma frase secreta que serve como uma camada de proteção adicional. Você pode ignorar a criação dela apertando Enter duas vezes. Se quiser adicionar uma mais tarde, siga essas instruções.

Enter passphrase (empty for no passphrase): Enter same passphrase again:

Pronto! Par de chaves gerado!

Passo 2: Adicionando a chave ao ssh-agent O ssh-agent é o programa que irá gerenciar a nossa chave SSH. Com o comando abaixo nós iremos inicializá-lo e deixá-lo pronto para que o terminal possa utilizá-lo para conectar-se ao servidor do GitHub. A mensagem Agent pid XXXXX será exibida indicando que o programa foi iniciado com sucesso, sendo que o número representado por XXXXX é um identificador único do mesmo.

eval "$(ssh-agent -s)"

Em seguida, execute o comando abaixo para adicionar a chave ao ssh-agent (Obs.: caso a chave tenha sido criada com um nome diferente do padrão, é necessário substituir id_ed25519 por ele):

ssh-add ~/.ssh/id_ed25519

Será retornada a mensagem Identity added: /home/usuario/.ssh/id_ed25519 (seu_email@exemplo.com).

Passo 4: Adicionando chave SSH ao GitHub Primeiro, execute o comando cat ~/.ssh/id_ed25519.pub a fim de exibir a sua chave no terminal. Depois selecione ela, e copie para a área de transferência.

Em seguida, entre em sua conta do GitHub, e clique na sua foto de perfil no ícone superior direito. No menu aberto clique em Settings.

Na seção "Access" da barra lateral esquerda, clique em SSH and GPG keys. Em seguida clique no botão New SSH key ou Add SSH key. Então, no campo "Title" basta adicionar um título para a sua chave (pode ser uma referência ao computador do qual você está acessando), e no campo "Key" colar o conteúdo da chave que foi copiado do terminal. No campo "Key Type" você pode deixar selecionada a opção "Authentication Key". Por fim, clique em Add SSH key, e confirme o seu login, caso seja solicitado.

Com isso, você pode agora clonar o seu projeto para a sua máquina local (no WSL) usando o protocolo SSH, através do comando git clone.

git clone ssh

Tomando como exemplo o endereço SSH do repositório na imagem acima, o comando a ser executado seria:

git clone git@github.com:andrei-alves/meu-projeto.git

Mas atenção: Na sua primeira conexão, será exibida uma mensagem como a abaixo:

The authenticity of host 'github.com (IP ADDRESS)' can't be established. ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU. Are you sure you want to continue connecting (yes/no)?

Isso acontece porque o GitHub ainda não é um host conhecido pela nossa máquina. E para garantir a autenticidade da chave retornada na mensagem, você pode comparar com a que é disponibilizada na página oficial (compare com a do tipo Ed25519). Você pode usar essa ferramenta para comparar as duas chaves, e ao copiar a que é retornada no terminal não inclua o ponto final (por exemplo, na messagem acima você copiaria SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU).

Ao confirmar a autenticidade, digite yes no terminal e aperte Enter. E pronto! Agora você pode fazer os seus commits localmente e enviá-los para o seu repositório remoto com facilidade.

devigoraugusto/backDotNet

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages