DEV Community: Tarcísio Corte

Docker: Simplicidade e praticidade - Parte 2

Tarcísio Corte — Tue, 11 Jan 2022 14:27:03 +0000

Na parte 1 dessa série de posts, eu mostrei como baixar a imagem de um container, depois mostrei como montar um container, apagar esse container e por ultimo como deletar a imagem.

Neste post eu começo mostrando como montar uma imagem.

Melhor que isso, vou mostrar como dockerizar
uma aplicação Angular, ou seja uma imagem que roda uma aplicação Angular.

Cenário: Dockerizar uma aplicação Angular com Nginx

Já vou deixar código fonte pronto aqui que ai já fica mais fácil pra quem quiser estudar.

Na raiz da aplicação Angular, crie um arquivo Dockerfile.

# Primeiro passo: compilar e builder código Angular
FROM node:14.17.0 as build
WORKDIR /usr/local/app
COPY ./ /usr/local/app/
RUN npm install
RUN npm run build

# Segundo passo: usar o nginx como server
FROM nginx:latest
COPY --from=build /usr/local/app/dist/app-demo /usr/share/nginx/html

# Exportar a porta 80 que é padrão
EXPOSE 80

Tenha em mente aqui que você precisa do NodeJs e Angular instalados na sua máquina para gerar essa imagem.
No meu caso, instalados nesse momento eu tenho o NodeJs v14.17.0 e Angular v12.0.5.
Agora, vamos rodar o comando para gerar a imagem.

docker build -t app-demo:v1 .

Detalhe: podemos, ao invés de ter um arquivo chamado Dockerfile, poderiamos ter um arquivo chamado dev.dockerfile e outro qa.dockerfile ou/e também mais um chamado prod.dockerfile, então poderia executar o mesmo comando, mas para um arquivo especifico:

docker build -t app-demo:v1 ./qa.dockerfile

Imagem pronta, então vamos rodar esse container.

docker run -d -p 8080:80 app-demo:v1

No comando acima, estamos rodando o container e direcionamos a porta 80 do container para a porta 8080 da máquina que esta rodando o container.
Abra o navegador e digite o endereço http://localhost:8080/

Conclusão

Nessa continuação de uma série de posts, fiz novamente a demonstração de como é fácil criar containers Docker.
Usar arquivos Dockerfiles é sem dúvida uma das maneiras mais praticas e fáceis de se instanciar containers.

Docker: Simplicidade e praticidade - Parte 1

Tarcísio Corte — Wed, 29 Dec 2021 19:47:04 +0000

Um guia de sobrevivência - Parte 1

Criar uma máquina virtual e instalar nela tudo que você precisa, seja essa maquina um ambiente de produção, qualidade ou desenvolvimento é muito bom. Então, esqueça máquinas pesadas com vários gigabytes de disco ou RAM, temos imagens pequenas e mínimas que podem ser executadas como containers e te ajudar muito no seu dia.

Essa é a primeira parte de um guia de sobrevivência para montar imagens, containers, fazer pull e push para um repositório, criar Dockerfile, Docker Compose etc.

Docker é claro é a ferramenta que vou usar.
Dizem que existem outras, mas qual?

Cenário: Quero rodar um container.

Por exemplo, rodar um container com um banco de dados.
1 - Baixar uma imagem:docker pull. Esse comando é especifico para baixar uma imagem. Veja o exemplo a seguir:

docker pull mysql/mysql-server:latest

Faz o download da uma versão da imagem do MySQL.

docker images

Lista as imagens que estão disponíveis no seu computador.

2 - Montar e rodar um container
Agora que você já tem uma imagem oficial, põe ela pra rodar. Use o comando docker run.

docker run --name="mysqltest" -d mysql/mysql-server:latest

Pronto, já tem um container rodando.
Use o comando docker container ls para listar os containers.

Cenário: Quero remover os containers e imagens.

1 - Parar o container
Para "stopar" container use o comando docker kill

 docker kill $(docker ps -q)

No exemplo acima é executado um comando que "stopa" todos os containers que estão rodando no momento.
No caso do exemplo abaixo, só havia um container em execução na minha maquina.

2 - Remover as imagens
Para remover as imagens que estão na sua máquina use o comando docker rmi, veja exemplo:

docker rmi $(docker images -a -q) -f

Ao executar esse comando você deve receber uma mensagem como essa:

Untagged: mysql/mysql-server:latest
Untagged: mysql/mysql-server@sha256:91170bd4e012f0bf46b5141a38b612427b37692e8465cdffe9b0ca2d74d37d8a
Deleted: sha256:d2e6e9727b37928be30fb11361d1246dcc816e6b5fb55d6ef30281ff5e3884df

Conclusão

Neste post eu mostrei como é simples baixar imagens e executar containers baseados nessas imagens.
No Docker Hub você encontra milhares e milhares de imagens prontas que você pode usar de imediato.
No próximo post vou mostrar mais sobre a iteração com esses containers e como tirar mais proveito durante a execução.

Link do MySQL no Docker Hub
Link do Nginx no Docker Hub

NestJS: Pode usar mais e mais!

Tarcísio Corte — Mon, 27 Dec 2021 19:36:03 +0000

Venho trabalhando com NestJS em meus projetos pessoais desde 2019, basicamente são projetos para expor pequenas APIs que servem a alguns poucos e pequenos sites.
Recentemente tive a oportunidade de compor um time que estava usando NestJS de uma forma muito séria e fizemos a implementação de uma API muito robusta que esta escalando mais e mais.
Estou muito satisfeito com o resultado que o NestJS tem nos proporcionado e isso me motivou a fazer esses post.

O que é NestJS

Framework de NodeJs que possibilita aos desenvolvedores de TypeScript e JavaScript criar aplicações eficientes e capazes de escalar de maneira muito simples e rápida.
Escrevi TypeScript antes de JavaScript porque o NestJS é TypeScript first ou seja, todo o desenvolvimento é baseado em TypeScript mas é claro você ainda pode usar JavaScript (fique à lá vonté).
Um detalhe sobre o NestJS, "por baixo dos panos" NestJS faz uso do nosso querido Express. Você não é obrigado usar o Express, você pode trocar por Fastify. Esse é um post padrão, então vai seguir com o Express no exemplo!

Vamos ao tutorial

Primeiramente, vamos instalar e fazer uso da Nest CLI que é um command-line que vai nos ajudar a inicializar o projeto, nos ajuda no desenvolvimento e a manter o projeto também.
$ npm i -g @nestjs/cli $ nest new project-name

Como demonstração neste post vamos criar uma API para registro de contatos.
Execute o comando:
nest new api-contact
Quando aparecer a pergunta - Which package manager would you ❤️ use? - selecione "npm".
Navega até a pasta:
cd api-contact
Você verá a seguinte estrutura inicial do projeto:

O scaffolding do NestJS já traz vários arquivos de projetos que nos ajudam muito durante o desenvolvimento.

Uma coisa, antes de começar a codificar, vamos adicionar o TypeORM

npm i --save @nestjs/typeorm typeorm

Agora que já temos a dependência do TypeORM instalado, vamos criar nossa primeira entidade.
Crie um arquivo chamado contact.entity.ts

Agora vamos fazer uma de uma DTO que será usada para salvar os registros de contatos, então crie o arquivo CreateContact.dto.ts:

Não vou falar hoje sobre padrão Service Repository, mas pra quem conhece esse conceito vai identificar isso muito fácil no NestJS.
Crie o arquivo contacts.service.ts:

Obviamente a repository do exemplo salva dados em um banco de dados.
Vou fornecer aqui as configurações que eu usei para o PostgreSQL. Para isso usei o arquivo app.module.ts que é padrão já fornecido pelo scaffolding do NestJS:

Pra facilitar a vida de quem acompanha esse post vou deixar o arquivo docker-compose.yml disponível para quem tem interesse de já rodar a imagem de um PostgreSQL e testar a API.

Até aqui eu só mostrei o exemplo do código de produção, ou seja o código que necessitamos para rodar a API de forma funcional.
Agora, vamos ver a parte do código que corresponde aos Testes Unitários.

Por padrão o NestJS já cria um arquivo de teste que vem junto com o scaffolding.

Para esse exemplo vou deixar o código de testes unitários que usei para testar a nossa service, então veja o código do arquivo contacts.service.spec.ts:

Eu implementei alguns poucos testes, porém o que eu quero demonstrar é a facilidade que temos em montar nossos testes unitários com Jest e NestJS.
Veja como é fluída a codificação dos testes.

Código completo do exemplo no ❤️Github, onde tudo esta!

Conclusão
NestJS é um framework muito estável e de fácil adoção em aplicações de todos os níveis de complexidade isso porque ele é muito simples de se usar e também porque Nest CLI já te serve uma ótima estrutura de código para começo de projeto e de fácil alteração e evolução.