Document the post-sync URL override - #1241
Merged
Merged
Conversation
Adds docs for extra.altis.cloud.post-sync.{env}.url, which sets the site URL the post-sync cache flush and post-sync actions run against. Needed on subdirectory multisite installs where the internal domain root is not a registered site.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ferschubert-hm
requested review from
jerico,
joehoyle,
mikelittle and
wisyhambolu
September 7, 2026 17:21
joehoyle
approved these changes
Sep 7, 2026
wisyhambolu
approved these changes
Sep 8, 2026
wisyhambolu
left a comment
Contributor
There was a problem hiding this comment.
Looks good, one nit.
Co-authored-by: Wisdom Hambolu <wisdom@humanmade.com>
|
Git push to origin failed for v27-branch with exitcode 1 |
|
Successfully created backport PR for |
|
Successfully created backport PR for |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the
extra.altis.cloud.post-sync.{env}.urlconfig added in humanmade/vantage-backend#2741.Why
After a database sync, the cache flush and post-sync actions run against the destination environment's internal domain root. On subdirectory multisite installs the root is not always a registered site — if the main site lives under a path such as
/blog/, WP-CLI cannot bootstrap WordPress there and those steps fail. The new config sets the URL explicitly per destination environment.Changes
docs/dashboard/post-sync-url.md— what the setting does, thecomposer.jsonshape, and the default behaviour when it is absent. Modelled on the existingsearch-replace.mdpage, since both are sync-time config read fromcomposer.jsonat the deployed SHA and keyed by destination environment ID.docs/dashboard/import-export.md— notes the override on the Run post-sync actions sync option and links to the new page.docs/dashboard/search-replace.md— reciprocal link, as the two settings sit in the samecomposer.jsonblock.Note on ordering
The Vantage-side change (humanmade/vantage-backend#2741) is not merged yet. Worth holding this until it is, so the docs don't describe a setting that has no effect.