Implantação de TypeScript no Kubernetes: guia básico para iniciantes

Implantação de TypeScript no Kubernetes: guia básico para iniciantes

O desenvolvimento web moderno é impensável sem conteinerização e orquestração. Se você programa em TypeScript e quer que sua aplicação funcione de forma estável, escale automaticamente e seja tolerante a falhas — o Kubernetes (K8s) será seu melhor amigo. Neste guia, vamos analisar passo a passo como empacotar uma aplicação TypeScript em Docker e implantá-la em um cluster Kubernetes. O material é voltado para iniciantes: sem mágica, apenas exemplos claros e explicações.

1. Preparação da aplicação TypeScript

Antes de pensar em Kubernetes, é preciso garantir que sua aplicação esteja pronta para funcionar em um contêiner. Vamos criar um servidor HTTP simples com Express e TypeScript.

1.1. Inicialização do projeto

Crie uma pasta para o projeto e execute a inicialização:

mkdir my-ts-app && cd my-ts-app\nnpm init -y\nnpm install express\nnpm install -D typescript @types/node @types/express ts-node nodemon

1.2. Configuração do TypeScript

Crie o arquivo tsconfig.json:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist",\n    "rootDir": "./src",\n    "strict": true,\n    "esModuleInterop": true,\n    "skipLibCheck": true\n  },\n  "include": ["src/**/*"],\n  "exclude": ["node_modules", "dist"]\n}

1.3. Código da aplicação

Crie a pasta src e o arquivo index.ts:

import express, { Request, Response } from 'express';\n\nconst app = express();\nconst PORT = process.env.PORT || 3000;\n\napp.get('/', (req: Request, res: Response) => {\n  res.json({ message: 'Hello from TypeScript on Kubernetes!' });\n});\n\napp.listen(PORT, () => {\n  console.log(`Server running on port ${PORT}`);\n});

1.4. Compilação e execução

Adicione os scripts no package.json:

"scripts": {\n  "build": "tsc",\n  "start": "node dist/index.js",\n  "dev": "ts-node src/index.ts"\n}

Verifique a execução local: npm run dev e abra http://localhost:3000.

2. Conteinerização com Docker

O Kubernetes trabalha com contêineres. Precisamos criar uma imagem Docker da nossa aplicação TypeScript.

2.1. Dockerfile

Crie o arquivo Dockerfile na raiz do projeto:

FROM node:18-alpine AS builder\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci\nCOPY . .\nRUN npm run build\n\nFROM node:18-alpine AS production\nWORKDIR /app\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package*.json ./\nRUN npm ci --only=production\nEXPOSE 3000\nCMD ["node", "dist/index.js"]

Usamos uma compilação multi-estágio: primeiro compilamos o TypeScript, depois criamos uma imagem final leve.

2.2. Compilação da imagem

docker build -t my-ts-app:latest .

Verifique localmente:

docker run -p 3000:3000 my-ts-app:latest

2.3. .dockerignore

Para não copiar arquivos desnecessários, crie o .dockerignore:

node_modules\ndist\n.git\n*.md

3. Implantação no Kubernetes

Agora que temos a imagem Docker, podemos passar para o Kubernetes. Para testes locais, recomendo Minikube ou Kind.

3.1. Iniciando o Minikube

minikube start --driver=docker\nminikube status

3.2. Carregando a imagem no Minikube

Para que o Kubernetes encontre nossa imagem, carregue-a no ambiente do Minikube:

minikube image load my-ts-app:latest

3.3. Criando o Deployment

Crie o arquivo deployment.yaml:

apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: my-ts-app-deployment\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: my-ts