Recursos
FinOps: fatura real AWS
O FinOps estima o custo de um cluster pela tabela de preços dos nós e pelo consumo ao vivo. Com
finops.aws.enabled, o orbit-api também lê a fatura real da conta no AWS Cost Explorer, e o Deck a
mostra na visão geral do FinOps, ao lado da estimativa: o acumulado do mês, a previsão do próprio Cost
Explorer, o mês passado, os principais serviços e os últimos 30 dias.
A fatura é da conta AWS inteira, com o id da conta, e não do cluster, então só um papel que tem
settings.manage a lê (GET /api/v1/clusters/{id}/finops/billing); todos os outros papéis veem a
estimativa do cluster sem a fatura.
Por que uma role, e por que somente leitura
O orbit-api nunca guarda uma chave de longa duração da AWS quando não precisa. Ele lê a fatura pela role que o seu pod recebe, e essa role só consegue ler:
| Ação | Para quê |
|---|---|
ce:GetCostAndUsage | acumulado do mês, mês passado, por serviço, totais diários |
ce:GetCostForecast | a previsão de fechamento do mês |
ce:GetDimensionValues | os serviços que aparecem na conta |
sts:GetCallerIdentity | de qual conta é a fatura |
A política é deploy/aws/finops-readonly-policy.json. Ela não cita nenhuma conta nem recurso, então os
mesmos arquivos servem na conta de qualquer cliente.
Antes de começar
- O Cost Explorer é habilitado uma vez por conta pagadora (console de Billing, Cost Explorer, Launch). Até lá toda chamada responde erro, e o Deck diz que a fatura está indisponível.
- AWS Organizations: numa conta membro, o Cost Explorer devolve os custos dessa conta. A conta pagadora enxerga a organização inteira. Use a conta cuja fatura você quer mostrar.
- O Cost Explorer cobra US$ 0,01 por chamada de API. O orbit-api guarda a fatura em cache por 6 horas, então ela custa alguns centavos por dia, não importa quantas pessoas abram o Deck. Passadas as 6 horas, o Deck recebe a última fatura na hora enquanto o orbit-api lê a próxima, e só quando alguém abre o FinOps.
Opção A: EKS Pod Identity (recomendada)
O Pod Identity não precisa de provedor OIDC por cluster nem de annotation no chart. O cluster precisa
do add-on eks-pod-identity-agent.
CLUSTER=my-eks NAMESPACE=sreorbit RELEASE=sreorbit deploy/aws/setup-pod-identity.shhelm upgrade sreorbit deploy/helm/sreorbit -n sreorbit --reuse-values --set finops.aws.enabled=trueO script é idempotente. Ele cria a role sreorbit-finops-readonly (troque com ROLE_NAME) confiando em
pods.eks.amazonaws.com (deploy/aws/trust-pod-identity.json), grava a política somente leitura como
inline e associa a role à ServiceAccount <release>-orbit-api. O mesmo à mão:
aws iam create-role --role-name sreorbit-finops-readonly \ --assume-role-policy-document file://deploy/aws/trust-pod-identity.jsonaws iam put-role-policy --role-name sreorbit-finops-readonly --policy-name sreorbit-finops-readonly \ --policy-document file://deploy/aws/finops-readonly-policy.jsonaws eks create-pod-identity-association --cluster-name my-eks --namespace sreorbit \ --service-account sreorbit-orbit-api \ --role-arn arn:aws:iam::<account>:role/sreorbit-finops-readonlyOpção B: IRSA
Para clusters com provedor OIDC do IAM e sem o agente do Pod Identity. Preencha
deploy/aws/trust-irsa.json (ACCOUNT_ID, OIDC_PROVIDER sem https://, NAMESPACE,
SERVICE_ACCOUNT = <release>-orbit-api), crie a role com ele e a mesma política somente leitura, e
anote só a ServiceAccount do orbit-api:
helm upgrade sreorbit deploy/helm/sreorbit -n sreorbit --reuse-values \ --set finops.aws.enabled=true \ --set components.orbit-api.serviceAccount.annotations."eks\.amazonaws\.com/role-arn"=arn:aws:iam::<account>:role/sreorbit-finops-readonlycomponents.<name>.serviceAccount.annotations é mesclado sobre o serviceAccount.annotations do chart
inteiro, então a role vai para a conta de serviço do orbit-api e para nenhuma outra.
Opção C: chaves estáticas (último recurso)
Fora do EKS, um usuário IAM com a mesma política e as suas chaves no Secret da release, entregues ao
orbit-api como AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY por components.orbit-api.secretEnv.
Faça a rotação delas; prefira A ou B sempre que uma role for possível.
Network policy
Com networkPolicy.enabled, o finops.aws.enabled abre a saída do orbit-api para TCP 443 (o Cost
Explorer e o STS não têm endereço fixo) e para o agente do Pod Identity em 169.254.170.23:80, e nada
mais na faixa link-local.
Verificação
A visão geral do FinOps mostra Fatura AWS (real) assim que a primeira leitura dá certo. Quando não dá, a API diz o motivo:
curl -s -H "Authorization: Bearer $ORBIT_AUTH_TOKEN" -H "X-Orbit-Session: $SESSION" \ http://<orbit-api>:8080/api/v1/clusters/<id>/finops/billingreason | Significado |
|---|---|
not-configured | o finops.aws.enabled está desligado |
no-credentials | nenhum Pod Identity, IRSA ou chave chegou ao pod: confira a associação ou a annotation e reinicie o pod |
denied | a role existe, mas falta a política ou o Cost Explorer não está habilitado |
error: ... | qualquer outra coisa, com a mensagem da AWS |
Remoção
helm upgrade sreorbit deploy/helm/sreorbit -n sreorbit --reuse-values --set finops.aws.enabled=falseaws eks delete-pod-identity-association --cluster-name my-eks --association-id <id>aws iam delete-role-policy --role-name sreorbit-finops-readonly --policy-name sreorbit-finops-readonlyaws iam delete-role --role-name sreorbit-finops-readonly