wils@web ~ $ cat ~/ajuda/como-implantar-uma-aplicacao-node-js-em-um-cluster-kubernetes-1-26-guia-pratico.md

DevOps

Como implantar uma aplicação Node.js em um cluster Kubernetes 1.26: Guia prático

atualizado em 04/09/2026

Implantar uma aplicação Node.js em um cluster Kubernetes pode parecer desafiador, mas com este guia prático, você aprenderá a realizar essa tarefa de forma eficiente.

Pré-requisitos

  • Cluster Kubernetes 1.26 em funcionamento
  • kubectl instalado e configurado
  • Docker instalado
  • Aplicação Node.js pronta para ser implantada

Passo 1: Criar Dockerfile

Primeiro, você precisa criar um Dockerfile para sua aplicação Node.js. Crie um arquivo chamado Dockerfile na raiz do seu projeto com o seguinte conteúdo:

FROM node:14

WORKDIR /usr/src/app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 3000

CMD [ "node", "app.js" ]

Passo 2: Construir a imagem Docker

Execute o seguinte comando para construir a imagem Docker:

docker build -t minha-aplicacao-node .

Passo 3: Criar um repositório no Docker Hub

Faça login no Docker Hub e crie um repositório para armazenar sua imagem:

docker login

docker tag minha-aplicacao-node seu_usuario/minha-aplicacao-node

docker push seu_usuario/minha-aplicacao-node

Passo 4: Criar arquivos de configuração do Kubernetes

Crie um arquivo chamado deployment.yaml com o seguinte conteúdo:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: minha-aplicacao-node
spec:
  replicas: 3
  selector:
    matchLabels:
      app: minha-aplicacao-node
  template:
    metadata:
      labels:
        app: minha-aplicacao-node
    spec:
      containers:
      - name: minha-aplicacao-node
        image: seu_usuario/minha-aplicacao-node
        ports:
        - containerPort: 3000

Em seguida, crie um arquivo chamado service.yaml:

apiVersion: v1
kind: Service
metadata:
  name: minha-aplicacao-node
spec:
  type: LoadBalancer
  ports:
  - port: 80
    targetPort: 3000
  selector:
    app: minha-aplicacao-node

Passo 5: Implantar no Kubernetes

Agora você pode implantar sua aplicação no Kubernetes:

kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

Passo 6: Verificar o status da implantação

Verifique se os pods estão em execução:

kubectl get pods

Conclusão

Após seguir esses passos, sua aplicação Node.js deve estar rodando em um cluster Kubernetes. Para acessar a aplicação, você pode usar o endereço IP do serviço LoadBalancer. Dica: Sempre monitore os logs da aplicação com kubectl logs para identificar possíveis problemas.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.