A containerização consiste em agrupar um aplicativo, suas dependências e bibliotecas juntas para que possam ser usadas como plug-and-play em qualquer tipo de infraestrutura. Cada agrupamento é chamado de container.
Por que Containerizar um Serviço Node.js?
Conforme discutido na última seção, containerizar um serviço Node.js significaria agrupar o aplicativo, suas dependências, bibliotecas e até configuração em um único container.A containerização tem os seguintes benefícios:
- Portátil. Uma vez que agrupamos todos os requisitos do aplicativo em um container, as mesmas imagens podem ser instaladas em desenvolvimento, staging e produção.
- Rápido e leve. Os containers tendem a ser muito mais rápidos do que máquinas virtuais (VMs) ou hardware dedicado, pois estão executando apenas os requisitos do aplicativo, enquanto historicamente as VMs ou hardware dedicado inicializariam toda a máquina e todos os aplicativos.
- Escalável. Com os dois benefícios acima, a escalabilidade se torna muito fácil, pois os contêineres são rápidos, eficientes e fáceis de implantar.
Neste artigo, vamos nos concentrar especificamente em containerizar um aplicativo Node.js.
Pré-requisitos
Ferramentas e Software
Docker (Docker Engine e Docker CLI)
Vamos precisar instalar o Docker para gerenciar nossos contêineres. O Docker Engine lida com o tempo de execução, e o CLI pode ser usado para interagir via linha de comando.
Node.js e npm/yarn Instalados (Para Desenvolvimento/Testes Iniciais)
Vamos precisar do Node.js e npm instalados para instalar as dependências das bibliotecas e executar o serviço.
Kubernetes ou Docker Compose para Gerenciar Múltiplos Contêineres (Opcional)
Vamos precisar do Kubernetes ou Docker Compose para gerenciar vários contêineres.
Fundamentos
Estrutura de aplicação Node.js:
- É esperado que o leitor já entenda o papel do arquivo principal (
app.jsouindex.js) no projeto, juntamente com o papel de outros arquivos comopackage.jsoneyarn.lock. - Este artigo também não abordará outros aspectos do projeto, como controladores, middleware e rotas.
Comandos Básicos do Docker e Sintaxe do Dockerfile
Comandos do Docker:
docker ps -> Lists all the containers running on the system
docker pull -> Pulls any image from the docker hub or official registry of Docker
docker build -> Creates an image from the docker file
docker run -> Starts a container from an exiting image
docker stop -> Stops a container if it has crashed or if you want to switch the container
Instruções principais do Dockerfile:
FROM -> Every DockerFile
WORKDIR -> Set the working directory inside the container
COPY (or ADD) -> Transfers the application's files to the image
RUN -> Executes commands during build time
CMD -> Sets the default command to be run when the container is started from the image
EXPOSE -> Specifies the port the container listens on
ENV -> Sets environment variables used during build and runtime
Ambas as tabelas abordadas e a estrutura do Node.js são suficientes para começar a containerizar e implantar seu serviço Node.js.
Configurando o Serviço Node.js
Configurar o ambiente Node.jsé um processo simples. Certifique-se de que você tenha o Node.js instalado em sua máquina.Se você tiver alguma dúvida, consulte o apêndice (1). Uma vez instalado, abra o seu terminal e verifique a instalação digitando.
node -v
npm -v
Crie um diretório de projeto e inicialize o projeto da seguinte maneira:
npm init -y
Instale o módulo express
npm install express
Crie um arquivo de servidor, vamos chamá-lo de server.mjs, onde podemos adicionar a rota e a lógica correspondente à rota. Como este artigo é mais sobre containerização, manteremos a lógica do endpoint muito simples. Algo como isto:
import express from "express";
const app = express();
const port = 8080;
app.get('/', (req, res) => {
res.send('Welcome to my demo service!');
});
app.listen(port, () => {
console.log(`Demo Service is running on port ${port}`);
});
Agora seu serviço está pronto para ser iniciado, navegue até o diretório do projeto no terminal e execute este comando:
node server.mjs
O serviço está funcionando; se visitarmos http://localhost:3000, veremos:
“Bem-vindo ao meu servidor”
Criando o Dockerfile
Vamos revisar o que é um Dockerfile, ele contém as instruções para construir a imagem do docker. Vamos criar um Dockerfile no diretório raiz. Durante esta etapa, como discutimos nas instruções do Dockerfile, precisamos fazer as seguintes coisas:
FROM node:18-alpine => Indicate the base image to use. Here we're using the official Nodejs 14 image.
WORKDIR /usr/src/app => Sets the working directory in the container.
COPY package*.json ./ => Duplicate the package.json and package-lock.json files to the working directory.
RUN npm install => Installs the app package dependencies.
COPY . . => Copies the remaining of the app to the working directory.
EXPOSE 8080 => Exposes the port our app is listening on.
CMD ["node", "app.js"] => Defines the command to start your Node.js application.
Construindo e Executando a Imagem do Docker
A partir da raiz do terminal, navegue atéseu projeto e execute o seguinte comando:
docker build -t image-name .
Onde nome-da-imagem é o nome da imagem Docker. O . no final define o contexto para o diretório atual.
Uma vez que a imagem esteja construída, criaremos o contêiner e executaremos o aplicativo Node.js usando o seguinte comando:
docker run --name container-name -p 8080:8080 image-name
Após o sucesso do processo acima, você pode verificar se o serviço está em execução executando o comando docker ps e, em seguida, acessando a mesma URL localhost que antes.
Enviando Imagens para um Registro
Agora que sua imagem está pronta, é hora de enviá-la para um registro. Para o escopo deste artigo, vamos enviar apenas para o Docker Hub. O Docker Hub é um serviço baseado em nuvem para armazenar, compartilhar e gerenciar imagens de contêineres Docker.
Crie uma conta em https://hub.docker.com/ e faça login com sua conta.
docker login
Depois de fazer login, imagens criadas localmente podem ser adicionadas assim:
docker tag image-name:tag dockerhub-username/repository-name:tag
Onde:
tagé oulatestou um número de versão.nome-do-repositórioé o nome do repositório desejado.
Em seguida, envie a imagem da seguinte maneira:
docker push dockerhub-username/repository-name:tag
Conclusão
Como podemos ver, a containerização torna os fluxos de trabalho e serviços complexos rápidos, portáteis e escaláveis ao separar as dependências. Uma vez implementado, toda a equipe se beneficia.Encorajo você a explorar os recursos avançados como compilações de vários estágios e redes de contêineres. Além disso, considere aprender sobre ferramentas de orquestração (por exemplo, Kubernetes) e integrar pipelines de CI/CD para otimizar seu fluxo de desenvolvimento.
Apêndice
Source:
https://dzone.com/articles/containerization-of-a-nodejs-service