Skip to content

feat(deploy): faable deploy volumes - #17

Merged
boyander merged 2 commits into
mainfrom
feat/deploy-volumes
Nov 2, 2026
Merged

boyander merged 2 commits into
mainfrom
feat/deploy-volumes

Conversation

@boyander

@boyander boyander commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Comandos de volúmenes — backlog §460, puntos 1 y 2; comparativa en arch/deploy/volumenes-cli-comparativa.md.

Punto 1, sobre la api existente:

  • volumes list — volúmenes de la app con el uso medido frente a la cuota.
  • volumes backups / volumes backup.
  • volumes restore <backup> — confirma; para la app y hace backup antes; dice qué backup lo deshace.
  • volumes export [-o file] — espera y descarga.
  • volumes import <dir|tar.gz> [--to] — para la app, backup antes, fusiona.

Punto 2: volumes put <ficheros y dirs..> --to <dir> — unos pocos ficheros (≤ 100 MB) con la app sirviendo: cada fichero se coloca con rename, sin backup previo. Depende de faablecloud/controller-deploy#41 y faablecloud/api#60 (en ese orden).

Oculto en la ayuda como los endpoints (x-internal) hasta publicar las blueprints.

Probado: tests de --to, espera, formato y del empaquetado (layout del tar); list y backups reales contra fundacion-erp. lib › stdin en la suite completa: intermitente preexistente.

…kups, backup, restore, export and import of an app's volumes (backlog §460)

Over the api's /volume and /volume-operation, which already had all of it.
restore and import ask before going (--yes in non-interactive mode): both stop
the app while they write, and both back the volume up first — the command ends
saying which backup undoes it. import takes a directory (with --to, where it
lands inside the volume) or a .tar.gz, packs it with the system tar
(COPYFILE_DISABLE: no AppleDouble files from macOS), PUTs it to the signed URL
and applies it. export waits and downloads to <app>-<volume>-<date>.tar.gz.

Hidden in the help, like the api endpoints (x-internal), until the blueprints
are published.
…ume, the app keeps serving (backlog §460)

put <files and directories..> --to <dir in the volume>: a file keeps its name,
a directory's contents go into --to. Packed like an import (pack.ts, its own
module and tested on the archive's layout) and sent as kind put: the platform
renames each file into place with the app serving and no backup first (api
POST /volume/:id/put, controller-deploy put; up to 100 MB). Asks before going
(--yes in non-interactive mode): same names are replaced. import now says to
use put for loose files.
@boyander
boyander merged commit 9e026de into main Nov 2, 2026
1 check passed
@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown

🎉 This PR is included in version 4.27.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

1 participant