Skip to content

docs: clarify Sovereign Cloud manual setup prerequisites and execution - #587

Merged
Jan Egil Ring (janegilring) merged 1 commit into
microsoft:mainfrom
afetahi:docs/sovereign-manual-setup
Nov 2, 2026
Merged

Jan Egil Ring (janegilring) merged 1 commit into
microsoft:mainfrom
afetahi:docs/sovereign-manual-setup

Conversation

@afetahi

Copy link
Copy Markdown
Contributor

Summary

Expand the Sovereign Cloud manual setup README into an executable guide for individual lab learners and workshop organizers.

  • Document required tools and PowerShell modules, with installation links and verification commands.
  • Establish a consistent starting directory and explain Bash versus PowerShell execution and line continuation.
  • Explain separate Azure CLI and Azure PowerShell authentication, including device authentication in Codespaces.
  • Add provider-registration and quota-check commands, with an explicit warning that the provider script processes all accessible subscriptions regardless of Set-AzContext.
  • Provide complete Bash and PowerShell alternatives for deploying the shared AKS/K3s Bicep template, securely entering the administrator password, and retrieving deployment outputs.
  • Clarify the separate LocalBox deployment, additional quota and cost, post-provisioning location, health-check requirements, and common errors.

Scope

Documentation only: updates resources/manual-setup/readme.md. No deployment scripts or infrastructure templates are changed. All subscription and tenant IDs remain placeholders.

Validation

  • Parsed all PowerShell code blocks without executing them.
  • Checked Bash examples with bash -n.
  • Verified all relative file links and ran git diff --check.
  • No Azure deployments were executed as part of this documentation change; live deployment remains environment- and quota-dependent.

Add explicit prerequisites, shell-specific setup and deployment commands, authentication guidance, and scope and readiness warnings.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@qxsch

Copy link
Copy Markdown
Member

Alban (@afetahi) please accept cla

@afetahi

Copy link
Copy Markdown
Contributor Author

@microsoft-github-policy-service agree

@qxsch

Copy link
Copy Markdown
Member

Jan Egil Ring (@janegilring) please review (and merge this in case everything is ok)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the contribution!

@janegilring
Jan Egil Ring (janegilring) merged commit d7927b1 into microsoft:main Nov 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants