Funcionalidade vps docker - BrunodosSantosVaz/big-bang GitHub Wiki

Alvo VPS com Docker Compose

Funcionalidade BB-F-043 · requisito RF-BB-043 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.

Finalidade

Atualizar serviços publicados em servidor existente por SSH, preservando serviços não publicados e permitindo voltar.

Atores

Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.

Pré-condições

Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.

Fluxo principal

Ler conjunto imutável; preparar acesso, executar precheck e migração da nova imagem antes da troca; gravar conjunto anterior; iniciar serviços definidos; conferir saúde; voltar pelo digest da release anterior.

Validações

Banco e proxy fora de deploy.servicos não são recriados; falha de migração mantém a versão em execução; rollback não roda migração inversa.

Alternativas e erros

SSH, precheck, migração, digest ou saúde inválidos geram falha; recuperação de dados depende do backup documentado pelo projeto.

Permissões

Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.

Resultados

Resultado esperado: Atualizar serviços publicados em servidor existente por SSH, preservando serviços não publicados e permitindo voltar. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.

Referência da implementação

Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.