docs(nexus): documentação completa do ambiente DEV Nexus (OCI + Terraform)
Cobre: compartments, 3x OKE clusters, node pools, VCN/subnets, 5x Load Balancers, API Gateways, Object Storage, ArgoCD, Observabilidade e estrutura completa do Terraform (tf_oci_clusters). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Tiago Ribeiro
parent
302e56baef
commit
4ff252b43d
1 changed files with 357 additions and 0 deletions
357
inventcloud/invista/nexus/OCI-DEV-NEXUS.md
Normal file
357
inventcloud/invista/nexus/OCI-DEV-NEXUS.md
Normal file
|
|
@ -0,0 +1,357 @@
|
||||||
|
# OCI — Ambiente DEV Nexus (cmp-dev-nexus)
|
||||||
|
|
||||||
|
> **Data:** 2026-02-25 | **Responsável:** Tiago Ribeiro
|
||||||
|
> **Contexto:** Documentação completa do ambiente DEV Nexus — recursos OCI e Terraform (`tf_oci_clusters`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Compartments
|
||||||
|
|
||||||
|
### Hierarquia
|
||||||
|
|
||||||
|
```
|
||||||
|
invistacloud (root)
|
||||||
|
└── cmp-top-invista
|
||||||
|
└── cmp-dev-inv ← compartment pai (local.compartment_id no Terraform)
|
||||||
|
└── cmp-dev-nexus ← clusters OKE, node pools, LBs
|
||||||
|
```
|
||||||
|
|
||||||
|
| Compartment | OCID | Uso |
|
||||||
|
|---|---|---|
|
||||||
|
| `cmp-dev-inv` | `ocid1.compartment.oc1..aaaaaaaa76x3nykkjwvctpr6px34dysu3pbg7p62h2r65fegt7fvbrioll3a` | VCN, API Gateway, Object Storage, Observabilidade |
|
||||||
|
| `cmp-dev-nexus` | `ocid1.compartment.oc1..aaaaaaaahycc62za6ikthlhauvarvbdixc7xpjjmcrame3cirhu2kz74ddma` | Clusters OKE, Node Pools, Load Balancers |
|
||||||
|
|
||||||
|
> **Nota:** O Terraform usa `cmp-dev-inv` como compartment raiz do ambiente (`existing_compartment_id`) e `cmp-dev-nexus` como compartment dos clusters (`cluster_compartment_id_map`).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. OKE Clusters
|
||||||
|
|
||||||
|
### Clusters Ativos
|
||||||
|
|
||||||
|
| # | Cluster | OCID (sufixo) | Versão K8s | Node Pool | Nodes |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| 1 | `cls-dev-nexus` | `…cobrewkvc3a` | v1.34.1 | `np-dev-1` | 3x VM.Standard.E4.Flex |
|
||||||
|
| 2 | `cls-dev-barramento` | `…cifn2eknv6q` | v1.34.1 | `np-dev-2` | 3x VM.Standard.E4.Flex |
|
||||||
|
| 3 | `cls-dev-observabilidade` | `…crszb62robq` | v1.34.1 | `np-dev-3` | 3x VM.Standard.E4.Flex |
|
||||||
|
|
||||||
|
### Configuração dos Node Pools
|
||||||
|
|
||||||
|
| Parâmetro | Valor |
|
||||||
|
|---|---|
|
||||||
|
| Shape | `VM.Standard.E4.Flex` |
|
||||||
|
| OCPUs | 2 |
|
||||||
|
| Memória | 16 GB |
|
||||||
|
| Nodes por pool | 3 (`node_pool_size_up = 3`) |
|
||||||
|
| Modo de escala | `up` (escala zero: `node_pool_size_down = 0`) |
|
||||||
|
| Autoscaler | Desabilitado |
|
||||||
|
| Pods CIDR | `10.244.0.0/16` |
|
||||||
|
| Services CIDR | `10.96.0.0/16` |
|
||||||
|
|
||||||
|
### Worker Nodes (Compute Instances)
|
||||||
|
|
||||||
|
| Instância | Cluster | Shape | Estado |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `oke-cifn2eknv6q-*` (x3) | cls-dev-barramento | VM.Standard.E4.Flex | RUNNING |
|
||||||
|
| `oke-cobrewkvc3a-*` (x3) | cls-dev-nexus | VM.Standard.E4.Flex | RUNNING |
|
||||||
|
| `oke-crszb62robq-*` (x3) | cls-dev-observabilidade | VM.Standard.E4.Flex | RUNNING |
|
||||||
|
|
||||||
|
### Kubeconfig
|
||||||
|
|
||||||
|
Os kubeconfigs são gerados automaticamente pelo Terraform via `null_resource.kubeconfig`:
|
||||||
|
|
||||||
|
```
|
||||||
|
~/.kube/config-dev-1 → cls-dev-nexus
|
||||||
|
~/.kube/config-dev-2 → cls-dev-barramento
|
||||||
|
~/.kube/config-dev-3 → cls-dev-observabilidade
|
||||||
|
```
|
||||||
|
|
||||||
|
Gerar manualmente:
|
||||||
|
```bash
|
||||||
|
oci ce cluster create-kubeconfig \
|
||||||
|
--cluster-id <CLUSTER_OCID> \
|
||||||
|
--file ~/.kube/config-dev-<N> \
|
||||||
|
--token-version 2.0.0
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Rede
|
||||||
|
|
||||||
|
### VCN
|
||||||
|
|
||||||
|
| VCN | CIDR | Compartment | Gerenciada por |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `vcn-oke` | `10.110.0.0/16` | `cmp-dev-inv` / OKE > DEV | Terraform (`tf_oci_clusters`) |
|
||||||
|
| `VCN-DEV` | `10.6.0.0/16` | `cmp-dev-inv` | Manual |
|
||||||
|
|
||||||
|
### Subnets `vcn-oke` (10.110.0.0/16)
|
||||||
|
|
||||||
|
| Subnet | CIDR | Tipo | Uso |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `sbn-workers-1` | `10.110.0.0/20` | Pública | OKE worker nodes |
|
||||||
|
| `sbn-workers-2` | `10.110.16.0/20` | Pública | OKE worker nodes |
|
||||||
|
| `sbn-workers-3` | `10.110.32.0/20` | Pública | OKE worker nodes |
|
||||||
|
| `sbn-lb-1` | `10.110.128.0/20` | Pública | Load Balancers OKE + API Gateway MFE |
|
||||||
|
| `sbn-lb-2` | `10.110.144.0/20` | Pública | Load Balancers OKE |
|
||||||
|
| `sbn-api-gateway` | `10.110.192.0/20` | **Privada** | Criada pelo Terraform (disponível — não usada atualmente) |
|
||||||
|
|
||||||
|
### Gateways de Rede
|
||||||
|
|
||||||
|
| Gateway | Tipo | Uso |
|
||||||
|
|---|---|---|
|
||||||
|
| `igw-oke` | Internet Gateway | Egress público para workers e LBs |
|
||||||
|
| `nat-oke` | NAT Gateway | Egress privado para `sbn-api-gateway` |
|
||||||
|
| `sgw-oke` | Service Gateway | Acesso a serviços OCI (Object Storage, etc.) |
|
||||||
|
| DRG | Dynamic Routing Gateway | Cross-VCN: `vcn-oke` ↔ `VCN-DEV` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Load Balancers
|
||||||
|
|
||||||
|
Todos os LBs são criados e gerenciados pelo OKE (via Services do tipo LoadBalancer no Kubernetes):
|
||||||
|
|
||||||
|
| Display Name (ID OKE) | IP | Shape | Cluster | Criado em |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| `35adee2d-…` | `10.110.133.131` | 100Mbps | cls-dev-barramento | 2026-01-26 |
|
||||||
|
| `b8344bb7-…` | `10.110.135.3` | 100Mbps | cls-dev-nexus | 2026-01-26 |
|
||||||
|
| `bc0548de-…` | `10.110.129.64` | 100Mbps | cls-dev-observabilidade | 2026-01-26 |
|
||||||
|
| `177c06f0-…` | `10.110.143.54` | 100Mbps | cls-dev-nexus | 2026-01-29 |
|
||||||
|
| `029cfee6-…` | `137.131.236.202` *(público)* | 100Mbps | cls-dev-nexus | 2026-02-09 |
|
||||||
|
|
||||||
|
> Os IPs privados (`10.110.x`) estão na subnet `sbn-lb-1` ou `sbn-lb-2`.
|
||||||
|
> O único IP público (`137.131.236.202`) pertence a um Service exposto externamente no `cls-dev-nexus`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. API Gateways
|
||||||
|
|
||||||
|
### `api-gateway-mfe-dev` — Terraform-managed
|
||||||
|
|
||||||
|
| Campo | Valor |
|
||||||
|
|---|---|
|
||||||
|
| Nome | `api-gateway-mfe-dev` |
|
||||||
|
| Compartment | `cmp-dev-inv` |
|
||||||
|
| Tipo | PUBLIC |
|
||||||
|
| Subnet | `sbn-lb-1` (10.110.128.0/20) — vcn-oke |
|
||||||
|
| Gerenciado por | Terraform (`modules/api_gateway_mfe`) |
|
||||||
|
| Hostname | `guhal72tzyekzchzamhhi3lvgi.apigateway.sa-saopaulo-1.oci.customer-oci.com` |
|
||||||
|
|
||||||
|
**Deployments configurados:**
|
||||||
|
|
||||||
|
| MFE | Bucket | Path | Backend |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `mfe-user` | `mfe-user-dev` | `/{path*}` | Object Storage `grbb7qzeuoag` |
|
||||||
|
| `mfe-user` | `mfe-user-dev` | `/` (fallback SPA) | `index.html` no bucket |
|
||||||
|
|
||||||
|
### `api-gateway-nexus-dev` — Manual
|
||||||
|
|
||||||
|
| Campo | Valor |
|
||||||
|
|---|---|
|
||||||
|
| Nome | `api-gateway-nexus-dev` |
|
||||||
|
| Compartment | `cmp-dev-inv` |
|
||||||
|
| Subnet | `SBNT-DEV` (10.6.0.0/24) — VCN-DEV |
|
||||||
|
| Gerenciado por | Manual |
|
||||||
|
| Conectividade OKE | Via DRG (cross-VCN: VCN-DEV ↔ vcn-oke) |
|
||||||
|
|
||||||
|
> **Pendência:** Migrar `api-gateway-nexus-dev` para `sbn-api-gateway` na `vcn-oke` (ver `OCI-NETWORK-ANALYSIS.md` — Opção A).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Object Storage
|
||||||
|
|
||||||
|
### Buckets em `cmp-dev-nexus`
|
||||||
|
|
||||||
|
| Bucket | Uso | Criado em |
|
||||||
|
|---|---|---|
|
||||||
|
| `invista-inventcloud-bucket3` | Uso geral | 2026-02-06 |
|
||||||
|
| `tfstate-gqysee` | Terraform remote state | 2025-12-30 |
|
||||||
|
| `tfstate-inidhr` | Terraform remote state | 2025-12-30 |
|
||||||
|
| `tfstate-terraform` | Terraform remote state | 2025-12-30 |
|
||||||
|
|
||||||
|
### Buckets em `cmp-dev-inv`
|
||||||
|
|
||||||
|
| Bucket | Uso | Criado em |
|
||||||
|
|---|---|---|
|
||||||
|
| `mfe-shell-dev` | MFE Shell (frontend) | 2026-02-24 |
|
||||||
|
|
||||||
|
> **Namespace do Object Storage:** `grbb7qzeuoag`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. ArgoCD
|
||||||
|
|
||||||
|
ArgoCD instalado em todos os 3 clusters via Helm pelo Terraform:
|
||||||
|
|
||||||
|
| Parâmetro | Valor |
|
||||||
|
|---|---|
|
||||||
|
| Chart Version | `7.3.0` (argo/argo-cd) |
|
||||||
|
| Namespace | `argocd` |
|
||||||
|
| LB tipo | Interno (annotation `oci-load-balancer-internal=true`) |
|
||||||
|
| OIDC | OCI IDCS (integrado via outputs do módulo `identity`) |
|
||||||
|
|
||||||
|
**URLs internas (somente acesso via VCN):**
|
||||||
|
|
||||||
|
| Cluster | URL |
|
||||||
|
|---|---|
|
||||||
|
| `cls-dev-nexus` (1) | `https://argocd.dev-01.interno.invista.com.br` |
|
||||||
|
| `cls-dev-barramento` (2) | `https://argocd.dev-02.interno.invista.com.br` |
|
||||||
|
| `cls-dev-observabilidade` (3) | `https://argocd.dev-03.interno.invista.com.br` |
|
||||||
|
|
||||||
|
**RBAC OCI IDCS:**
|
||||||
|
|
||||||
|
| Grupo OCI | Role ArgoCD |
|
||||||
|
|---|---|
|
||||||
|
| `invista-oke-admin` | `admin` |
|
||||||
|
| `invista-oke-dev` | `readonly` |
|
||||||
|
| `invista-oke-readonly` | `readonly` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Observabilidade
|
||||||
|
|
||||||
|
Gerenciada pelo módulo `modules/observability` em `cmp-dev-inv`:
|
||||||
|
|
||||||
|
| Recurso | Tipo | Configuração |
|
||||||
|
|---|---|---|
|
||||||
|
| Alarmes OCI Monitoring | `oci_computeagent` | CPU > 90% (PT10M) → CRITICAL; CPU > 75% (PT15M) → WARNING |
|
||||||
|
| Log Group | OCI Logging | — |
|
||||||
|
| Dashboard | OCI Management Dashboard | Import de `dashboards/oke-observability-import.json` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Terraform — `tf_oci_clusters`
|
||||||
|
|
||||||
|
### Repositório
|
||||||
|
|
||||||
|
| Campo | Valor |
|
||||||
|
|---|---|
|
||||||
|
| Organização | Azure DevOps — CN-Squad |
|
||||||
|
| Projeto | Invista FIDC - Nexus |
|
||||||
|
| Repositório | `tf_oci_clusters` |
|
||||||
|
| Pipeline | `terraform-tf_oci_clusters` (ID 51) |
|
||||||
|
| Variable Group | `oci-terraform` (ID 34) |
|
||||||
|
| Backend | Object Storage OCI (S3-compatible) — bucket `tfstate-*` em `cmp-dev-nexus` |
|
||||||
|
|
||||||
|
### Estrutura de Arquivos
|
||||||
|
|
||||||
|
```
|
||||||
|
tf_oci_clusters/
|
||||||
|
├── environments/
|
||||||
|
│ ├── dev/
|
||||||
|
│ │ ├── main.tf # Clusters, rede, bastion, observabilidade
|
||||||
|
│ │ ├── api_gateway_mfe.tf # API Gateway MFE + deployments
|
||||||
|
│ │ ├── argocd.tf # ArgoCD Helm install + kubeconfig
|
||||||
|
│ │ ├── backend.tf # Remote state config
|
||||||
|
│ │ ├── providers.tf # OCI provider
|
||||||
|
│ │ ├── variables.tf # Todas as variáveis
|
||||||
|
│ │ └── terraform.ci.tfvars # Valores do ambiente DEV (pipeline CI)
|
||||||
|
│ ├── hml/ # Ambiente HML (estrutura similar)
|
||||||
|
│ └── prod/ # Ambiente PROD (estrutura similar)
|
||||||
|
│
|
||||||
|
├── modules/
|
||||||
|
│ ├── oke_cluster/ # OKE cluster + node pool
|
||||||
|
│ │ ├── main.tf # oci_containerengine_cluster + node_pool
|
||||||
|
│ │ └── variables.tf
|
||||||
|
│ ├── network/ # VCN, subnets, gateways, route tables, security lists
|
||||||
|
│ │ ├── main.tf
|
||||||
|
│ │ └── variables.tf
|
||||||
|
│ ├── api_gateway_mfe/ # API Gateway PUBLIC para MFEs estáticos
|
||||||
|
│ │ ├── main.tf # oci_apigateway_gateway + deployments por MFE
|
||||||
|
│ │ └── variables.tf
|
||||||
|
│ ├── compartment/ # Criação de compartment
|
||||||
|
│ ├── observability/ # ONS + OCI Logging + Alarms + Dashboards
|
||||||
|
│ └── iam_service_accounts/ # IAM para service accounts
|
||||||
|
│
|
||||||
|
├── compartments/ # Gerenciamento top-level de compartments
|
||||||
|
├── dns/ # DNS OCI
|
||||||
|
├── iam/ # IAM policies
|
||||||
|
├── identity/ # OIDC / IDCS (usado pelo ArgoCD)
|
||||||
|
├── argocd/
|
||||||
|
│ ├── values.yaml # Helm values do ArgoCD
|
||||||
|
│ └── application-dev.yaml # ArgoCD Application manifest (GitOps)
|
||||||
|
└── dashboards/
|
||||||
|
└── oke-observability-import.json
|
||||||
|
```
|
||||||
|
|
||||||
|
### terraform.ci.tfvars DEV — Valores Principais
|
||||||
|
|
||||||
|
```hcl
|
||||||
|
env_name = "dev"
|
||||||
|
create_compartment = false
|
||||||
|
create_cluster_compartment = false # removido manualmente 2026-02-25
|
||||||
|
existing_compartment_id = "ocid1.compartment.oc1..aaaaaaaa76x3nykkjwvctpr6px34dysu3pbg7p62h2r65fegt7fvbrioll3a" # cmp-dev-inv
|
||||||
|
|
||||||
|
cluster_compartment_id_map = {
|
||||||
|
"1" = "ocid1.compartment.oc1..aaaaaaaahycc62za6ikthlhauvarvbdixc7xpjjmcrame3cirhu2kz74ddma" # cmp-dev-nexus
|
||||||
|
"2" = "ocid1.compartment.oc1..aaaaaaaahycc62za6ikthlhauvarvbdixc7xpjjmcrame3cirhu2kz74ddma"
|
||||||
|
"3" = "ocid1.compartment.oc1..aaaaaaaahycc62za6ikthlhauvarvbdixc7xpjjmcrame3cirhu2kz74ddma"
|
||||||
|
}
|
||||||
|
|
||||||
|
kubernetes_version = "v1.34.1"
|
||||||
|
node_shape = "VM.Standard.E4.Flex"
|
||||||
|
ocpus = 2
|
||||||
|
memory_in_gbs = 16
|
||||||
|
vcn_cidr = "10.110.0.0/16"
|
||||||
|
|
||||||
|
scale_mode = "up"
|
||||||
|
node_pool_size_up = 3
|
||||||
|
node_pool_size_down = 0
|
||||||
|
|
||||||
|
enable_bastion = true
|
||||||
|
admin_cidr = "187.65.249.125/32"
|
||||||
|
enable_api_gateway_mfe = true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Pipeline CI/CD
|
||||||
|
|
||||||
|
```
|
||||||
|
Push to main (tf_oci_clusters)
|
||||||
|
→ Bootstrap (init + validate)
|
||||||
|
→ Detect Changes (diff por environment)
|
||||||
|
→ Plan (terraform plan -var-file=terraform.ci.tfvars)
|
||||||
|
→ Aprovação Manual
|
||||||
|
→ Apply (terraform apply)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Fluxo de Dependências
|
||||||
|
|
||||||
|
```
|
||||||
|
tf_oci_clusters (pipeline ID 51)
|
||||||
|
│
|
||||||
|
├── module.network → VCN vcn-oke (10.110.0.0/16)
|
||||||
|
│ └── subnets, IGW, NAT, SGW, route tables, security lists
|
||||||
|
│
|
||||||
|
├── module.cluster[1,2,3] → cls-dev-nexus / cls-dev-barramento / cls-dev-observabilidade
|
||||||
|
│ └── node_pool → np-dev-1/2/3 (VM.Standard.E4.Flex 2cpu/16gb x3)
|
||||||
|
│
|
||||||
|
├── module.api_gateway_mfe → api-gateway-mfe-dev (PUBLIC, sbn-lb-1)
|
||||||
|
│ └── deployment mfe-user → bucket mfe-user-dev
|
||||||
|
│
|
||||||
|
├── null_resource.kubeconfig → ~/.kube/config-dev-{1,2,3}
|
||||||
|
│
|
||||||
|
├── null_resource.argocd_setup → ArgoCD v7.3.0 em cada cluster
|
||||||
|
│
|
||||||
|
└── module.observability → Alarms + Log Group + Dashboards
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Referências
|
||||||
|
|
||||||
|
| Recurso | OCID / URL |
|
||||||
|
|---|---|
|
||||||
|
| Compartment `cmp-dev-nexus` | `ocid1.compartment.oc1..aaaaaaaahycc62za6ikthlhauvarvbdixc7xpjjmcrame3cirhu2kz74ddma` |
|
||||||
|
| Compartment `cmp-dev-inv` | `ocid1.compartment.oc1..aaaaaaaa76x3nykkjwvctpr6px34dysu3pbg7p62h2r65fegt7fvbrioll3a` |
|
||||||
|
| VCN `vcn-oke` | `ocid1.vcn.oc1.sa-saopaulo-1.amaaaaaasks3yliapqrmikfzagpgqohuzjqik3hx63w7r2uajiqv5krvxkda` |
|
||||||
|
| VCN `VCN-DEV` | `ocid1.vcn.oc1.sa-saopaulo-1.amaaaaaasks3yliatoq6uvqqak3kax775ksd2jastvgsbiki7mgj6jzue6dq` |
|
||||||
|
| API Gateway MFE hostname | `guhal72tzyekzchzamhhi3lvgi.apigateway.sa-saopaulo-1.oci.customer-oci.com` |
|
||||||
|
| Repo Terraform | Azure DevOps — CN-Squad / Invista FIDC - Nexus / tf_oci_clusters |
|
||||||
|
| Região | `sa-saopaulo-1` |
|
||||||
|
| Object Storage Namespace | `grbb7qzeuoag` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Atualizado em: 2026-02-25*
|
||||||
Loading…
Reference in a new issue