Joelbrit0
e5dc346b96
All checks were successful
Build (develop) / Promote (main) / build-and-push-deploy (push) Successful in 1m14s
157 lines
4.6 KiB
Markdown
157 lines
4.6 KiB
Markdown
# Kubernetes Infra (k8s) - vendaweb-api
|
|
|
|
Este diretorio contem os manifests Kubernetes do `vendaweb-api` usando Kustomize (base + overlays).
|
|
|
|
## Visao geral
|
|
|
|
- App: `vendaweb-api` (Deployment + Service)
|
|
- Porta HTTP do container/Service: `8067`
|
|
- Healthcheck usado pelos probes: `GET /v1/health`
|
|
- Config via `ConfigMap` + `Secret` (injetados com `envFrom`)
|
|
- Overlay prod:
|
|
- Namespace: `vendaweb-prod`
|
|
- Service: `NodePort` (porta externa `30001`)
|
|
- Replicas: `15`
|
|
|
|
## Estrutura
|
|
|
|
- `k8s/base/`
|
|
- `deployment.yaml`: deployment padrao (replicas 3), porta 8067, probes `/v1/health`, `imagePullSecrets: gitea-auth`
|
|
- `service.yaml`: `ClusterIP` expondo 8067
|
|
- `configmap.yaml`: variaveis nao sensiveis (ex.: Redis/DB host/port)
|
|
- `secret.yaml`: variaveis sensiveis (ex.: usuario/senha do DB)
|
|
- `kustomization.yaml`: agrega os recursos do base
|
|
|
|
- `k8s/overlays/prod/`
|
|
- `kustomization.yaml`: aplica patches e define `namespace: vendaweb-prod`
|
|
- `service-patch.yaml`: muda Service para `NodePort` e fixa `nodePort: 30001`
|
|
- `deployment-prod-patch.yaml`: ajusta `replicas: 15`
|
|
- `deployment-image-digest-patch.yaml`: sobrescreve a `image:` do container
|
|
|
|
- `k8s/argocd/application-prod.yaml`
|
|
- Aplica o overlay `k8s/overlays/prod` via Argo CD
|
|
- Sync automatizado com `selfHeal` e `prune`
|
|
|
|
## Portas e acesso
|
|
|
|
- Dentro do cluster: Service `vendaweb-api:8067`
|
|
- Overlay prod (NodePort): porta externa `30001` (mapeia para `8067`)
|
|
|
|
Notas:
|
|
|
|
- O processo Node/Nest escuta em `8067` (ver `src/main.ts`).
|
|
- A variavel `PORT` em `.env` nao e usada pelo bootstrap atual; o k8s esta configurado para 8067.
|
|
|
|
## Deploy com kubectl/kustomize
|
|
|
|
Gerar o YAML final (sem aplicar):
|
|
|
|
```bash
|
|
kubectl kustomize k8s/overlays/prod
|
|
```
|
|
|
|
Aplicar o overlay prod:
|
|
|
|
```bash
|
|
kubectl apply -k k8s/overlays/prod
|
|
```
|
|
|
|
Validar o que sera aplicado (dry-run):
|
|
|
|
```bash
|
|
kubectl apply -k k8s/overlays/prod --dry-run=server
|
|
```
|
|
|
|
Ver diffs (se seu kubectl suportar):
|
|
|
|
```bash
|
|
kubectl diff -k k8s/overlays/prod
|
|
```
|
|
|
|
## Argo CD (prod)
|
|
|
|
O Argo CD esta configurado em `k8s/argocd/application-prod.yaml` para:
|
|
|
|
- `path: k8s/overlays/prod`
|
|
- `targetRevision: main`
|
|
- `destination.namespace: vendaweb-prod` (com `CreateNamespace=true`)
|
|
|
|
Se voce esta usando Argo CD, o fluxo recomendado e:
|
|
|
|
- atualizar manifests no Git (overlay prod)
|
|
- deixar o Argo CD sincronizar automaticamente
|
|
|
|
## Configuracao (ConfigMap/Secret)
|
|
|
|
- `k8s/base/configmap.yaml` (`vendaweb-api-config`)
|
|
- `REDIS_HOST`, `REDIS_PORT`, `DB_HOST`, `DB_PORT`, `DB_SERVICE_NAME`
|
|
- `k8s/base/secret.yaml` (`vendaweb-api-secrets`)
|
|
- `DB_USERNAME`, `DB_PASSWORD`
|
|
|
|
Importante:
|
|
|
|
- O `Secret` esta em `stringData` no repositorio (texto puro). Para ambiente real, prefira um gerenciador de segredos (ExternalSecrets, SOPS, Vault etc.) e nao commite credenciais.
|
|
|
|
## Imagem e pipeline
|
|
|
|
O workflow `.gitea/workflows/deploy-api.yaml`:
|
|
|
|
- builda e publica `git.simplifiquehc.com.br/simplifique/vendaweb-api:<sha7>` e `:latest`
|
|
- atualiza `k8s/overlays/prod/deployment-image-digest-patch.yaml` para apontar para o tag do commit
|
|
|
|
Isso e pensado para o Argo CD detectar a alteracao no Git e aplicar.
|
|
|
|
## Comandos uteis (day-2)
|
|
|
|
Assumindo namespace `vendaweb-prod`:
|
|
|
|
```bash
|
|
kubectl -n vendaweb-prod get all
|
|
kubectl -n vendaweb-prod get pods -l app=vendaweb-api -o wide
|
|
kubectl -n vendaweb-prod describe deploy/vendaweb-api
|
|
kubectl -n vendaweb-prod describe pod -l app=vendaweb-api
|
|
```
|
|
|
|
Logs:
|
|
|
|
```bash
|
|
kubectl -n vendaweb-prod logs deploy/vendaweb-api --tail=200
|
|
kubectl -n vendaweb-prod logs -l app=vendaweb-api --tail=200 --all-containers
|
|
kubectl -n vendaweb-prod logs -l app=vendaweb-api -f
|
|
```
|
|
|
|
Rollout:
|
|
|
|
```bash
|
|
kubectl -n vendaweb-prod rollout status deploy/vendaweb-api
|
|
kubectl -n vendaweb-prod rollout history deploy/vendaweb-api
|
|
kubectl -n vendaweb-prod rollout restart deploy/vendaweb-api
|
|
```
|
|
|
|
Exec/Debug:
|
|
|
|
```bash
|
|
kubectl -n vendaweb-prod exec -it deploy/vendaweb-api -- sh
|
|
kubectl -n vendaweb-prod port-forward svc/vendaweb-api 8067:8067
|
|
```
|
|
|
|
## Troubleshooting rapido
|
|
|
|
- `ImagePullBackOff`:
|
|
- conferir `imagePullSecrets: gitea-auth` no namespace (`kubectl -n vendaweb-prod get secret gitea-auth`)
|
|
- conferir o valor de `image:` no overlay prod
|
|
|
|
- `CrashLoopBackOff`:
|
|
- ver logs do pod e eventos (`kubectl -n vendaweb-prod describe pod ...`)
|
|
- validar variaveis do `ConfigMap`/`Secret`
|
|
|
|
- Probes falhando:
|
|
- garantir que a rota `/v1/health` responde 200 e que a app esta ouvindo em `8067`
|
|
|
|
## Mudancas comuns
|
|
|
|
- Alterar porta externa (NodePort): `k8s/overlays/prod/service-patch.yaml`
|
|
- Alterar replicas em prod: `k8s/overlays/prod/deployment-prod-patch.yaml`
|
|
- Alterar imagem/tag em prod: `k8s/overlays/prod/deployment-image-digest-patch.yaml`
|
|
- Alterar envs: `k8s/base/configmap.yaml` e `k8s/base/secret.yaml`
|