Pular para o conteúdo

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çãoPara quê
ce:GetCostAndUsageacumulado do mês, mês passado, por serviço, totais diários
ce:GetCostForecasta previsão de fechamento do mês
ce:GetDimensionValuesos serviços que aparecem na conta
sts:GetCallerIdentityde 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.

bash
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=true

O 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:

bash
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-readonly

Opçã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:

bash
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-readonly

components.<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:

bash
curl -s -H "Authorization: Bearer $ORBIT_AUTH_TOKEN" -H "X-Orbit-Session: $SESSION" \  http://<orbit-api>:8080/api/v1/clusters/<id>/finops/billing
reasonSignificado
not-configuredo finops.aws.enabled está desligado
no-credentialsnenhum Pod Identity, IRSA ou chave chegou ao pod: confira a associação ou a annotation e reinicie o pod
denieda 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

bash
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