Atualização da versão de template da instância¶
Solicitar POST /gateway/api/v1/gateways/{id}/template-upgrade. O BFF encaminha ao Template Service, que usa os endpoints internos de contexto, validação, preparação e aplicação do Core.
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Arial, sans-serif","fontSize":"16px","lineColor":"#64748b","primaryTextColor":"#172b4d"},"flowchart":{"htmlLabels":true,"useMaxWidth":true,"nodeSpacing":28,"rankSpacing":38,"padding":14,"curve":"linear","subGraphTitleMargin":{"top":12,"bottom":16}},"sequence":{"useMaxWidth":true,"actorMargin":28,"width":145,"height":45,"diagramMarginX":32,"diagramMarginY":12,"messageMargin":24,"wrap":true,"mirrorActors":false},"themeCSS":".edgeLabel, .edgeLabel p {background-color:var(--diagram-surface)!important;color:var(--diagram-text)!important}\n.cluster rect {fill:var(--diagram-group)!important;stroke:var(--diagram-line)!important}\n.cluster-label span, .cluster-label text {color:var(--diagram-text)!important;fill:var(--diagram-text)!important}\n.flowchart-link, .actor-line {stroke:var(--diagram-line)!important}\nmarker path {fill:var(--diagram-line)!important;stroke:var(--diagram-line)!important}\n.actor {fill:var(--diagram-domain)!important;stroke:var(--diagram-domain-border)!important}\ntext.actor, .messageText, .loopText, .labelText {fill:var(--diagram-text)!important}\n.messageLine0, .messageLine1, .loopLine {stroke:var(--diagram-line)!important}\n.labelBox {fill:var(--diagram-surface)!important;stroke:var(--diagram-line)!important}\n.note {fill:var(--diagram-async)!important;stroke:var(--diagram-async-border)!important}\n.noteText {fill:var(--diagram-text)!important}\n.nodeLabel, .nodeLabel p, .nodeLabel span {color:var(--diagram-text)!important}\n.node .nodeLabel, .node .nodeLabel p {font-size:17px;font-weight:600;line-height:1.4;text-align:center}\n.nodeLabel small {display:inline-block;margin-top:4px;font-size:15px;font-weight:400;line-height:1.4;color:var(--diagram-description)!important}\ntext.actor, text.actor tspan {font-size:17px;font-weight:600}\n.node.entry rect, .node.entry polygon, .node.entry path, .node.entry circle {fill:var(--diagram-entry)!important;stroke:var(--diagram-entry-border)!important}\n.node.domain rect, .node.domain polygon, .node.domain path, .node.domain circle {fill:var(--diagram-domain)!important;stroke:var(--diagram-domain-border)!important}\n.node.security rect, .node.security polygon, .node.security path, .node.security circle {fill:var(--diagram-security)!important;stroke:var(--diagram-security-border)!important}\n.node.store rect, .node.store polygon, .node.store path, .node.store circle {fill:var(--diagram-store)!important;stroke:var(--diagram-store-border)!important}\n.node.async rect, .node.async polygon, .node.async path, .node.async circle {fill:var(--diagram-async)!important;stroke:var(--diagram-async-border)!important}\n.node.external rect, .node.external polygon, .node.external path, .node.external circle {fill:var(--diagram-external)!important;stroke:var(--diagram-external-border)!important}\n text.actor tspan, .loopText tspan, .labelText tspan, .messageText tspan, .noteText tspan {fill:var(--diagram-text)!important}\n\n"}}%%
%%{init: {"sequence":{"width":135,"actorMargin":24,"messageMargin":24,"wrap":true}}}%%
sequenceDiagram
actor A as Cliente
participant B as BFF
participant T as Template Service
participant G as Global Registry
participant C as Core
participant M as MongoDB
A->>B: Solicitar versão posterior
B->>T: POST template-upgrade
T->>C: GET template-upgrade/context
C-->>T: ACTIVE, proveniência e wizard anterior
T->>G: Resolver publicação da versão alvo
G-->>T: Referência de catálogo
T->>C: POST template-upgrade/validate
C->>M: Ler estado e verificar conflitos
C-->>T: 204 — preflight
T->>T: Persistir operação
T->>C: POST template-upgrade/prepare
C->>C: Planejar snapshot e revalidar wizard
C->>M: Substituir pendências por DRAFT isolado e wizard
C-->>T: IDs e configured
T-->>B: 202 — operação preparada
B-->>A: 202 — acompanhamento
Note over T,M: Continuação com setups resolvidos<br/>Independente da entrega do 202
T->>C: Aplicar configuração alvo
C->>C: Validar baseline, referências e configuração
C->>M: Materializar alvo e marcar upgrade completo
C-->>T: 204 — aplicação concluídaResumo: O Core preserva a ACTIVE durante preparação/aplicação. Reaproveita IDs de entidades de template, mantém conteúdo CUSTOM e arquiva pendências substituídas. A preparação revalida valores pelo validador do wizard; a aplicação usa os validadores de Gateway, rota e promoção. Os diagramas dessas etapas detalham as dependências externas.
Resultado: DRAFT com proveniência da nova versão, catálogo alvo e checkpoint. A mesma operação reutiliza preparação/aplicação concluída. Metadados existentes são promovidos ao publicar o Gateway, sem alterar antecipadamente a ACTIVE.
Alternativas relevantes: Conflitos estruturados (409) incluem upgrade concorrente, origem insuficiente, versão inválida, baseline alterada e referências CUSTOM incompatíveis. Setups pendentes impedem apply. Conclusão da operação não publica o Gateway.