Pular para o conteúdo

Ring Promoter

CI/CD Orbit + Lanes — cada release conquista a produção

O Ring Promoter é o plano de controle de promoção da TenthMatrix, pronto para produção. A v1.0.2 mostra Orbit (visão da frota) e Lanes (matriz APP × INT/TEST/ACC/PROD) lado a lado enquanto promove versões por anéis ordenados — int → test → acc → prod — com verificações de saúde ao vivo, rollback automático e trilha de auditoria completa.

O que é o Ring Promoter?

Um pequeno plano de controle que promove versões de aplicações por anéis compartilhados. Roda como serviço de longa duração (geralmente em k3s), expõe uma API REST JSON e uma interface web integrada, e acompanha versões atual/anterior e histórico por (aplicação, anel). Apps Kubernetes e apps de VM/CI compartilham uma única interface — o deployer é escolhido por app.

Watch the overview

Como funciona a promoção por anéis

Cada release conquista a produção. Um salto por vez — nunca pulando um anel — com saúde antes de promover e rollback automático em caso de falha.

  1. Inserir uma versão em int

    Inicie o pipeline inserindo uma versão (tag de imagem, branch ou ref) no anel de Integração de uma aplicação.

  2. Promover um anel por vez

    promote {from_ring} sempre aponta para o próximo anel. Não é possível pular de int → prod. O anel de origem precisa estar saudável primeiro.

  3. Implantar com o deployer certo

    KubectlDeployer (set image + rollout), GitHubActionsDeployer (workflow-dispatch para apps de VM/CI) ou Jobs do runner k8sjob — escolhidos por aplicação.

  4. Verificar a saúde com novas tentativas

    Após a implantação, verificações de saúde HTTP rodam com tentativas configuráveis. A verificação de versão opcional exige que o endpoint informe exatamente a versão recém-implantada.

  5. Rollback automático em caso de falha

    Se o destino continuar sem saúde, o Ring Promoter volta automaticamente à versão anterior e registra a falha no histórico.

  6. Autopromoção opcional

    Marque um anel para que um pouso saudável continue na mesma operação bloqueada — por exemplo, autopromover test → acc, mas manter pessoas no controle para prod.

  • Integração

    int

    Primeiro destino para novos builds e mudanças em agentes de IA / APIs.

  • Teste

    test

    Verificação automatizada e período de observação antes da aceitação.

  • Aceitação

    acc

    Controle de stakeholders / UAT — muitas vezes a última parada com autopromoção.

  • Produção

    prod

    Tráfego real — protegido por senha no anel final quando configurado.

Por que as equipes escolhem o Ring Promoter para CI/CD na era da IA

Produtos de IA mudam rápido — modelos, agentes, ferramentas MCP, gateways. O Ring Promoter mantém as promoções disciplinadas sem congelar as entregas.

  • Anéis ordenados, sem pular

    Pipeline compartilhado int → test → acc → prod. Adicionar um anel é uma mudança em um único lugar do pacote ring — as apps declaram onde ficam em cada anel na configuração, não no código.

  • Promoção condicionada à saúde

    Verificações de saúde ao vivo antes e depois de promover. O campo ou cabeçalho opcional health_version_field evita o clássico falso verde: pods antigos respondendo 200 enquanto a nova versão nunca foi implantada.

  • Rollback automático

    Falha de saúde após as tentativas restaura a versão anterior. Inserção, promoção e rollback são todos auditados — com sucesso ou falha.

  • Deployers para Kubernetes + VM/CI

    Um único plano de controle para rollouts com kubectl, workflow-dispatch do GitHub Actions (por exemplo, WSL Proxy em VMs) e executores de Jobs do Kubernetes com logs ao vivo.

  • Concorrência segura

    Serialização por app via advisory locks de sessão do Postgres entre réplicas. As operações se desacoplam do HTTP para que timeouts do balanceador não interrompam um rollback no meio.

  • Interface + API REST

    Console Next.js integrado e API REST com token bearer. As visões de implantação assíncronas transmitem o progresso para operadores que acompanham releases da stack de IA.

  • Apps definidas por configuração

    Adicione uma aplicação com YAML: namespaces, Deployments, repositórios de imagens, URLs de saúde, tipo de deployer — sem precisar de um fork do Ring Promoter.

  • Feito para plataformas de IA

    Promova serviços de agentes, gateways MCP, portas de entrada de inferência em GPU e produtos da TenthMatrix pelos mesmos anéis em que sua equipe de plataforma já confia.

Feito para implantações com IA

Pesos de modelos, runtimes de agentes e gateways de borda são lançados em ritmos diferentes. O Ring Promoter mantém cada mudança no mesmo protocolo de promoção.

  • Promova APIs de agentes de IA e gateways MCP pelos mesmos anéis dos serviços clássicos.
  • A saúde verificada por versão detecta rollbacks silenciosos quando um sidecar de inferência antigo ainda responde OK.
  • Autopromoção nos primeiros anéis para que builds de pesquisa avancem rápido; o controle humano fica em prod.
  • O deployer do GitHub Actions reutiliza o CI de IA/ML existente sem reescrever pipelines.
  • Histórico completo por (app, anel) para revisões de conformidade do que chegou à produção.

Arquitetura da solução

Interfaces limpas: Deployer, Executor, Health Checker, Store — troque backends de produção sem reescrever as regras de promoção.

  1. Plano de controle

    Serviço em Go + interface integrada + API REST em k3s (ou local).

  2. Anéis

    Pipeline ordenado definido uma vez; as apps mapeiam recursos por anel.

  3. Deployers

    Executores kubectl, GitHub Actions ou k8sjob por app.

  4. Armazenamento

    Postgres (prod) ou memória (dev) com histórico e locks.

Orbit + Lanes na v1.0.2

Fique no Orbit para ver a frota. Mude para Lanes quando precisar da matriz de ambientes.

CI/CD Orbit + Lanes — visão da frota Orbit, matriz Lanes, pipeline de anéis
Capa — Orbit, Lanes e Rings com títulos dos objetos
Visão da frota Orbit ao lado da matriz APP × ambiente do Lanes
Diagrama — Orbit (frota) ao lado de Lanes (matriz)

Continuar no site do produto

Acesse https://www.ringpromoter.com/ para demos, documentação e as versões mais recentes do Ring Promoter.

ringpromoter.com

Obter o Ring Promoter

Conheça o produto em ringpromoter.com, leia o artigo aprofundado da TenthMatrix ou fale conosco sobre CI/CD para plataformas de IA.