# Terraform do César — notas para as equipes

Referência: https://github.com/ShlomoChanoch/hackathon-health
Leitura do código em 19/09/2026 (commit 5aa2dba, de 16/09), com os esclarecimentos do César sobre as escolhas de projeto. Este repositório não foi provisionado por nós na OCI; o fluxo que testamos é o kit em https://hackinova-anhembi.vercel.app/instalar.html.

## Escolhas do autor

- **Região e shape.** `sa-saopaulo-1` é o padrão usado no último hackathon. `VM.Standard.E4.Flex` costuma ter capacidade disponível com mais frequência do que os shapes A1; na PUC também houve casos com E5. Se aparecer `Out of Capacity`, troque o shape. Confira a região inscrita, o compartment e o availability domain da sua conta.
- **`timestamp()` nos nomes é intencional.** Cada execução gera nomes diferentes para a VM, a rede e o arquivo da chave SSH, para que uma execução não sobrescreva a chave de outra.
- **cloud-init mínimo, de propósito.** Ele só habilita o SSH e instala pacotes básicos. Instalar os agentes e liberar o firewall da demo é tarefa da equipe (ou do engenheiro de nuvem, com Ansible). Depois de conectar, siga o guia.

## Cuidados ao usar

- Preencha tenancy_ocid, user_ocid, fingerprint, private_key_path, compartment_ocid, ssh_cidr e demo_port. A chave de API OCI é diferente da chave SSH criada pelo Terraform. Use somente dados da equipe.
- **O state do Terraform e o registro do kit Python usam o mesmo caminho.** Em `versions.tf`, o backend local grava em `~/.local/state/hackinova-oci/vps.json`, que é o mesmo arquivo em que o `criar-vps.py` do kit registra a VPS. Escolha um dos dois fluxos por ambiente. Se for usar os dois, mude o `path` do backend antes do `terraform init`.
- **Uma VM por state.** Como o caminho do backend é fixo, rodar `terraform apply` de novo não cria uma segunda VM: o Terraform renomeia os recursos e troca o arquivo `~/.ssh/health-<timestamp>` por outro com o novo horário, e o comando SSH mostrado na execução anterior deixa de apontar para um arquivo existente. Use o comando SSH da execução mais recente (`terraform output`). Para ter duas VMs com chaves separadas, use um `path` de backend diferente para cada uma.
- Não compartilhe o state: ele contém a chave privada gerada.
- Leia o plano do Terraform antes de aplicar. Registre os recursos criados e como encerrá-los.

Nenhum OCID, IP, chave ou credencial de uma equipe está incluído neste material.
