Skip to content

fix: preserve dashboard migration sites on deploy #337

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kptdobe merged 1 commit into from
Nov 5, 2026
Merged

fix: preserve dashboard migration sites on deploy #337

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,14 @@ Browse to `http://localhost:8787/list` to ensure you see the expected buckets.
2. Cloudflare KV, which is used for org properties and session login info is locally stored when developing locally. You will need to make your own local KVs to test against.

### Helix 6 migration (dual write)
Sites listed in the `HLX6_MIGRATION_SITES` env variable (see `wrangler.toml`) are being migrated to Helix 6. Every successful modification on those sites (source create/update/delete, folder creation, copy, move, version creation) is also propagated, in the background, to the Helix 6 source bus at `AEM_API` (`https://api.aem.live`) using the caller's IMS token. Failures are logged but do not affect the DA response.
Sites listed in the `HLX6_MIGRATION_SITES` env variable are being migrated to Helix 6. Every successful modification on those sites (source create/update/delete, folder creation, copy, move, version creation) is also propagated, in the background, to the Helix 6 source bus at `AEM_API` (`https://api.aem.live`) using the caller's IMS token. Failures are logged but do not affect the DA response.

For production and stage, manage `HLX6_MIGRATION_SITES` in the Cloudflare dashboard.
It is intentionally omitted from those environments in `wrangler.toml`:
`keep_vars = true` preserves dashboard values, but an explicit declaration would
override them on deployment. Local and test environments retain their own defaults.
If a previous deployment cleared the value, restore it in the dashboard; this
configuration change cannot recover the previous value.

Entries are either:
- `org/site`: the same org/site on Helix 6
Expand Down
9 changes: 2 additions & 7 deletions wrangler.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,7 @@ DA_CONTENT = "https://content.da.live"
AEM_BUCKET_NAME = "aem-content"
AEM_ADMIN_MEDIA_API = "https://admin.hlx.page/media"
AEM_API = "https://api.aem.live"
# Sites being migrated to hlx6: modifications are propagated to the AEM_API source bus.
# Format: "org/site" (same org/site on hlx6) or "org/site -> org2/site2" (different hlx6 site)
HLX6_MIGRATION_SITES = []
# HLX6_MIGRATION_SITES is dashboard-managed; keep_vars preserves it on deploy.

# ----------------------------------------------------------------------
# stage environment
Expand Down Expand Up @@ -59,9 +57,7 @@ DA_CONTENT = "https://stage-content.da.live"
AEM_BUCKET_NAME = "aem-content-stage"
AEM_ADMIN_MEDIA_API = "https://admin.hlx.page/media"
AEM_API = "https://api.aem.live"
# Sites being migrated to hlx6: modifications are propagated to the AEM_API source bus.
# Format: "org/site" (same org/site on hlx6) or "org/site -> org2/site2" (different hlx6 site)
HLX6_MIGRATION_SITES = []
# HLX6_MIGRATION_SITES is dashboard-managed; keep_vars preserves it on deploy.

# ----------------------------------------------------------------------
# ci environment (using stage content)
Expand Down Expand Up @@ -153,4 +149,3 @@ AEM_API = "https://api.aem.live"
# Sites being migrated to hlx6: modifications are propagated to the AEM_API source bus.
# Format: "org/site" (same org/site on hlx6) or "org/site -> org2/site2" (different hlx6 site)
HLX6_MIGRATION_SITES = []

Loading