Skip to main content
← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone

Relationships

#2132 Docs: update managed config and Kubernetes deployment guides for extension seeding workflow

Opened by stack72 · 9/13/2026

Context

swamp-club/swamp#2061 identified that the managed config deployment docs need updates to reflect the correct operator workflow for seeding pulled-extension source files into the remote datastore.

Changes needed

content/manual/how-to/swamp-serve/enable-managed-config.md

Add a prerequisite step: run swamp extension install + swamp datastore sync --push before swamp datastore config migrate. Without this, the config/pulled-extensions/ tree in the remote datastore may be incomplete because config migrate copies from local .swamp/pulled-extensions/ which may be empty.

content/manual/how-to/swamp-serve/deploy-on-kubernetes.md

  1. Document the correct init container ordering:
    • Create .swamp.yaml
    • swamp datastore setup extension
    • swamp datastore sync --pull
    • swamp datastore config migrate
    • swamp extension install (restores missing source files, pushes to datastore)
  2. Recommend --hot-reload for managed config deployments so swamp serve reload --server works for remote recovery.
  3. Document the recovery procedure for the "N pulled extension(s) have missing source files" warning.
  • swamp-club/swamp#2061
  • Design doc: design/enablers/datastores.md § Managed Config Deployment Architecture

Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/2444

02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED

Closed

9/14/2026, 6:55:16 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 9/14/2026, 6:55:15 PM

Fixed in #1200. Added a new prerequisite step (extension seeding via swamp extension install + swamp datastore sync --push) to the managed config guide, and added an init container startup sequence section, --hot-reload recommendation, and missing-source-files recovery procedure to the Kubernetes deployment guide.

Sign in to post a ripple.