This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Operação

Resilience Testing

Riscos de disponibilidade no PR, teste de carga pelo agente no seu cluster, caos e exercício de recuperação, só em alvo autorizado.

#O que faz

Análise de risco de disponibilidade, testes de carga e caos e prova de recuperação, só em ambiente autorizado.

FuncionalidadeO que fazNa área logada
Resilience risk scanLeitura de réplicas, limites, probes e pontos únicos de falha, e check de PR: os riscos novos que o PR introduz em Dockerfile, compose, Kubernetes e Terraform simples, com nota, supressão com prazo e portão no CI pela CLI. Leitura textual dos arquivos: Helm, Kustomize e módulos Terraform não são resolvidos./plataforma/engenharia/resiliencia
Chaos experimentsCaos no seu cluster Kubernetes pelo agente pull da entrega: apagar pods, escalar réplicas, isolar a rede do Deployment e apertar CPU ou memória, com sondas que abortam e dão o veredito, reversão garantida, aprovação de outra pessoa em produção, ChaosHub, agendamento, GameDays e relatório de resiliência. Só em Deployments da entrega e com as falhas que o cluster permite./plataforma/engenharia/resiliencia/caos
Load testingCarga gerada pelo agente no seu cluster contra um alvo com posse verificada, com fases, até cinco cenários ao mesmo tempo, veredito por p95 e taxa de erro, série por segundo e comparação com a execução anterior; dispara pela tela, pela API v1, por um passo do pipeline ou por uma Action do GitHub. Só GET e HEAD, com tetos de vazão e duração no agente./plataforma/engenharia/resiliencia
Disaster recovery drillsPlano de recuperação com RTO e RPO sobre um alvo com posse verificada e exercício medido pela sonda de saúde: a restauração só conta depois da queda e de três respostas saudáveis seguidas, e a idade do dado é conferida contra o RPO. O desastre e a restauração são feitos pelo seu time./plataforma/engenharia/resiliencia
Resilience insightsExperimento de caos proposto por IA a partir dos riscos do serviço e dos dependentes, aprovado por quem administra antes de virar experimento, análise do resultado contra a hipótese e ciclo de vida do risco (aberto, aceito com prazo, resolvido, reaberto) com dono avisado quando o risco reabre./plataforma/engenharia/resiliencia

#Como ativar

  • Na área logada: o dono adiciona o Cortex em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
  • Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
  • Carga e caos pedem o agente de entrega instalado no seu cluster; carga e recuperação pedem um alvo com posse verificada no Test Automation.

Nota

Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde 404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.

#Primeiro uso

  1. Ponha o check no PR

    Chave com Check de resiliência no CI resilience:check.
    bash
    aiuby resilience check --repo empresa/checkout --ref "$GITHUB_HEAD_REF" --base main
    aiuby resilience check Dockerfile k8s/app.yaml --base origin/main   # arquivos locais
    Conta só os riscos novos do PR em Dockerfile, compose, Kubernetes e Terraform simples. Abaixo da nota mínima do workspace, sai com 6.
  2. Cadastre um cenário de carga

    Na tela ou pela API (abaixo), com metas de p95 e taxa de erro.

#Teste de carga pela API

Chave com Teste de carga (pipeline e Terraform) load-test:run. Só GET e HEAD, até 50 requisições por segundo e 300 segundos por cenário, de 1 a 5 cenários por execução.

bash
curl -X POST https://aiuby.com/api/v1/load-tests/scenarios \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"home","targetId":"<alvo>","path":"/","rps":20,"durationSeconds":60,"p95Ms":400,"maxErrorRate":0.01}'

curl -X POST https://aiuby.com/api/v1/load-tests/runs \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"environmentId":"<ambiente>","scenarioIds":["<cenário>"]}'

aiuby load-tests run --env <ambiente> --scenario <cenário> --wait   # 0 passou, 6 reprovou, 7 ainda rodando

Mais em Portões no CI.

#Rotas da API

RotaEscopoPara quêCLI
GET /api/v1/load-tests/scenariosTeste de carga (pipeline e Terraform) load-test:runCenários de carga do workspaceaiuby load-tests scenarios list
POST /api/v1/load-tests/scenariosTeste de carga (pipeline e Terraform) load-test:runCriar cenário de carga (carga como código)aiuby load-tests scenarios create
GET /api/v1/load-tests/scenarios/{id}Teste de carga (pipeline e Terraform) load-test:runUm cenário de cargaaiuby load-tests scenarios get <id>
DELETE /api/v1/load-tests/scenarios/{id}Teste de carga (pipeline e Terraform) load-test:runRemover cenário de cargaaiuby load-tests scenarios delete <id>
POST /api/v1/load-tests/runsTeste de carga (pipeline e Terraform) load-test:runDisparar teste de carga (etapa do pipeline)aiuby load-tests run
GET /api/v1/load-tests/runs/{id}Teste de carga (pipeline e Terraform) load-test:runEstado e veredito do teste de cargaaiuby load-tests status <id>
POST /api/v1/resilience/checkCheck de resiliência no CI resilience:checkCheck de resiliência de um PR (portão do CI)aiuby resilience check

#O que ainda não existe

  • Experimento de caos e exercício de recuperação pela API: só na tela, com aprovação de outra pessoa em produção.
  • Carga com POST ou corpo: só GET e HEAD.
  • Helm, Kustomize e módulos Terraform resolvidos no check de PR: a leitura é textual.
  • O desastre e a restauração do exercício de recuperação: são feitos pelo seu time; a AIUBY mede.