MM-68718: Document Azure Blob Storage as a file storage backend#8976
Draft
agarciamontoro wants to merge 3 commits into
Draft
MM-68718: Document Azure Blob Storage as a file storage backend#8976agarciamontoro wants to merge 3 commits into
agarciamontoro wants to merge 3 commits into
Conversation
Adds Azure Blob Storage to the File storage system reference: a new azureblob driver-name option and individual entries for the FileSettings.AzureStorageAccount, AzureContainer, AzurePathPrefix, AzureAccessKey, AzureEndpoint, AzureSSL, and AzureRequestTimeoutMilliseconds settings. Extends the dedicated export filestore list with the matching Export* variants. Calls out the restart-required behaviour when changing file storage settings so admins know Save in System Console isn't enough on its own. ------ AI assisted commit
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 08315ba |
agarciamontoro
changed the title
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 71cd497 |
Folds the full prereqs, Azure portal/CLI provisioning, System Console walk-through, Test Connection semantics, restart-required warning, verification, optional export backend, and troubleshooting sections into a dedicated configure/azure-blob-storage page. Wires the new page into the configuration-settings toctree and bullet list, and adds a seealso link from the File storage section of environment-configuration-settings so admins can find it from the reference page. ------ AI assisted commit
agarciamontoro
force-pushed
the
MM-67096-azure-blob-storage-docs
branch
from
71cd497 to
eaa2e51
Compare
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA eaa2e51 |
Combs7th
added
1: Dev Review
Contributor
|
Thank you for the docs, @agarciamontoro! Is there a dev who you can recommend we tag to be the technical reviewer for this one? |
Member
Author
|
Hey, @Combs7th, I'll assign someone as soon as this is ready for review. For now, it's just an info dump of everything in progress, I'm still waiting for some PRs to be merged. Will move the PR to ready for review and assign a dev when it's done, thanks! |
Member
Author
|
This will ship in v11.9, btw, not in v11.8 |
Adds a Migrate existing files from Amazon S3 section to the Azure Blob Storage walk-through. Covers the recommended trickle-then-cutover pattern (long rclone sync, short AzCopy maintenance window), the prerequisites for the migration host, phase-by-phase commands, verification queries (object count parity, sha256 spot-check), the rollback path, and caveats (S3 versioning, sync vs copy, prefix rewrites, cross-region cost, Storage Mover preview status). Updates the migration note under step 4 and the troubleshooting entry for missing pre-cutover files to cross-reference the new section. ------ AI assisted commit
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 9c68289 |
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
3 participants
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.
Summary
Documents the new Azure Blob Storage filestore backend. Two layers:
Reference (
source/administration-guide/configure/environment-configuration-settings.rst):azureblobdriver-name option.ExportAzure*keys.seealsopointer from the File storage section to the walk-through page below.Walk-through (
source/administration-guide/configure/azure-blob-storage.rst, new):azCLI commands for creating the storage account, container, and retrieving the shared key.Both pages are wired into the existing
configure/configuration-settings.rsttoctree and bullet list so they're discoverable.Ticket Link
Notes for reviewers
configure/next to the reference; if the docs team prefers it underdeployment-guide/instead, easy to move.