vvzvlad/portainer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat(stacks): file-based stack versioning with full history + rollback (#27)

Browse Source 
Adds append-only version history on disk (compose/{id}/v{N}/<files>) for
file-based (WorkflowID==0) Compose/Swarm stacks, with rollback to any past
version. Git stacks (versioned by commit) and Kubernetes are untouched.

Backend:
- Stack model: StackFileVersion, PreviousDeploymentInfo, Versions[]; new
  StackFileVersionInfo type. APIVersion 2.43.0 -> 2.44.0.
- Versioned multi-file snapshot (entrypoint + AdditionalFiles) into v{N}/;
  ProjectPath repointed via GetStackProjectPathByVersion each deploy. Retention
  cap (20): Versions[] trimmed in-tx, old dirs deleted only AFTER the tx commits.
- Update handlers: RollbackTo (content read server-side from the target version,
  never trusted from the client; validated 1..current & present in Versions).
- Create paths seed v1. stackFile reads ?version= (validated; negative -> 400).
- New GET /stacks/{id}/versions endpoint.
- Migration 2.44.0: move existing file-based stacks' files into v1/ (idempotent,
  atomic pre-read of the full file set, skips git/kube/orphans).

Frontend:
- useStackVersions query + stackVersions key; StackEditorTab builds the full
  history list; StackVersionSelector shows 'v{N} · date · author'; file/versions
  caches invalidated (by prefix) after deploy/rollback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
agent_coder
2026-07-02 16:07:26 +03:00
parent 549e916c3e
commit d0d3c068ba
25 changed files with 1237 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files
api/stacks/stackbuilders/stack_builder.go
+21
View File
@@ -117,6 +117,27 @@ func (b *StackBuilder) storeStackFile(content []byte) error {
return nil
}
// storeStackFileVersioned stores the initial file of a file-based (non-git) Compose/Swarm stack
// into the v1 version folder and seeds the append-only version history. Note that
// StoreStackFileFromBytesByVersion returns the base path (not the version path), so ProjectPath
// is set explicitly via GetStackProjectPathByVersion.
func (b *StackBuilder) storeStackFileVersioned(content []byte) error {
stackFolder := strconv.Itoa(int(b.stack.ID))
if _, err := b.fileService.StoreStackFileFromBytesByVersion(stackFolder, b.stack.EntryPoint, 1, content); err != nil {
return err
}
b.stack.ProjectPath = b.fileService.GetStackProjectPathByVersion(stackFolder, 1, "")
b.stack.StackFileVersion = 1
b.stack.Versions = []portainer.StackFileVersionInfo{{
Version: 1,
CreatedAt: time.Now().Unix(),
CreatedBy: b.stack.CreatedBy,
}}
return nil
}
func (b *StackBuilder) initComposeDeployment(secCtx *security.RestrictedRequestContext, endpoint *portainer.Endpoint) error {
config, err := deployments.CreateComposeStackDeploymentConfigTx(b.dataStore, secCtx, b.stack, endpoint, b.fileService, b.stackDeployer, false, false, false)
if err != nil {