Last 20 commits touching this section.
Update 3P offering (#21798) * Update 3P offering * Add Arc-enabled server reuse article for Azure Migrate to Azure Local Adds migrate-arc-reuse.md covering retention of existing Azure Arc resources during VMware and Hyper-V migration, and updates the requirements, prerequisites, replicate, FAQ, overview, and what's new articles that previously stated the Connected Machine agent must always be uninstalled before migration. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Update azure-local/migrate/migrate-vmware-prerequisites.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * changing minor * update 3p * removing discovered arc section and reword arc rename requirement * remove discovery arc section and reword the arc rename setion * Apply batched suggestions from code review Co-authored-by: Manika Dhiman <v-dhimanm@microsoft.com> * changes from PR review * fix formatting * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * update screenshots with placeholder strings and red boxes, and PR suggestions * retry commit * removing redundant steps * update and fix issues * one minor fix --------- Co-authored-by: trumanbrown-msft <trumanbrown@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Co-authored-by: Manika Dhiman <v-dhimanm@microsoft.com>
631459: What's new discoverability + workload availability for Azure Local deployment types (#21776) * Proposal: add What's new in Azure Local hub and align multi-rack what's new - Add whats-new-hub.md as a single What's new landing page linking to hyperconverged, multi-rack, VM migration, and disconnected operations release notes. - Wire TOC What's new node to the hub and nest the four what's-new pages. - Remove monikers from multi-rack what's new and restructure to date-based sections (Azure Migrate style). * Fix TOC: remove href from parent What's new node, add hub as leaf child * Optimize what's new titles, descriptions, and H1 for search and AI retrievability * Fix YAML: remove colon from description values in what's new frontmatter * Replace What's new hub with TOC listing; add What's new column to deployment type guide * Merge workload availability matrix (#21748) into what's new PR; apply Manika's review comments and add reusable note include * Simplify workload availability to a workload list per Manika's feedback; drop Yes/No matrix * Link first mention of disconnected operations to its overview * Link Connected/Disconnected options in Step 1; remove duplicate disconnected links * Reword workload availability paragraph * Reword Connected mode description in Step 1 * Restore Yes/No workload availability matrix
Post-publish review: disconnected operations post-restore rehydration docs (#21679) * Document automated post-restore recovery * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * Clarify post-restore automation availability * Bound manual recovery steps to pre-2609 * Document post-restore command parameters * Post-publish review: disconnected operations post-restore rehydration docs - Add post-restore rehydration overview article and TOC entry - Fix malformed link and cross-link remediation in restore article - Replace ALDO acronym with 'disconnected operations for Azure Local' in prose - Standardize ARB naming to 'Azure Arc resource bridge (ARB)' - Standardize Next step/Related content sections; remove duplicate link - Add forward links from backup article to restore/rehydration flow Work item: AB#628782 * Updated text * Address review feedback: 2609 automation, disjoint data-cluster cases, scope framing * Add skip note for management cluster stages on before-cloud-deployment path * Updated metadata date --------- Co-authored-by: Anupam Kumar <kumaranupam@microsoft.com> Co-authored-by: anupam8995 <anupam8995@gmail.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com>
Release aldo 2607 (#21550) * Updated new certificates list * 38378156 Added messaging/note about keeping up to date * Fixed issue with ZDU and OEM images: #39011132 * AKS arc deployment failure in 2604 upgrades * fixed moniker on ZDU issue * 37903282 added section on IDP/IDS * Added certificate rotation * updated moniker * Apply suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * added identity provider trust certificates * fixed moniker * Apply suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Included TOC * Added platform expansion packs * Update to platform expansion packs * Removed wording typo * Update certificate rotation details and improve clarity Updated the date for certificate rotation and improved clarity in the description of Azure Local disconnected operations. Enhanced the explanation of certificate management best practices and added moniker ranges for versioning. * Revise release notes for disconnected operations Updated the release notes for disconnected operations for Azure Local, including changes to known issues, mitigations, and formatting improvements. * Fix typos and update date in expansion packs documentation Updated the date and corrected typos in the document. Improved clarity in the prerequisites and cmdlet references. * Refine mitigation details in known issues document Updated mitigation instructions for log collection and AKS Arc deployment issues. Reformatted sections for clarity and consistency. * Fix formatting issues in known issues documentation Corrected formatting of error message headings and mitigation sections for consistency. * Remove duplicate sentence in expansion packs article Removed redundant sentence about managing platform expansion packs. * Apply suggestion from @learn-build-service-prod-04[bot] Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Eliminate redundancy in platform expansion packs section Removed duplicate explanation of platform expansion packs. * Added release notes and 2607 version * fixed moniker * removed file not in use causing conflict * Correct capitalization in OEM golden images section * Fix typo in 64-node cluster support description * Clarify description for managing expansion packs Updated the description to clarify management of platform expansion packs for Azure Local disconnected operations. * Fix typo in disconnected operations documentation * Correct capitalization in OEM golden images section * Update date for disconnected operations article * Update publication date for disconnected operations article * Update release date for disconnected operations article * Update date for disconnected operations guide * fixed issues from review * Update moniker ranges for platform expansion packs --------- Co-authored-by: Seth Manheim <sethm@microsoft.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Co-authored-by: Ronmia Bess <61058899+ronmiab@users.noreply.github.com> Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com>
454986: Regenerated content - Add Azure Local private path network documentation (#20736) * New PR for previous work - Final review * Updated TOC to include new files * Updated to include preview tag since disclaimer is there * Updated text and TOC * Updated text and TOC * Apply suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Resolve TOC.yml merge conflicts: rebuild from main and add Review Azure Private Path node under connected hyperconverged Plan * TOC: move private path deploy article under Deploy > registration methods as 'With Arc gateway Private Path'; keep overview in Plan * Updated text via PM comments * Updated text for quality, style, and scope * Updated ms.date * updated image * Updated syntax * Updated syntax * Updated text per peer review * Updated text per peer review * Updated acronym references * Updated acronym references * updated text * Updated spacing * updated spacing --------- Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com>
Add docs for storage errors (#21359) * first draft * markups + add new file for ALRS * add to contents page for almr * update to use appropriate link and remove file links that shouldn't be present * markups * move where file displays * remove reference to SA RRC commands not advertised in ALMR * Apply suggestion from @v-regandowner --------- Co-authored-by: Regan Downer <v-rdowner@microsoft.com>
627613: Clean up disconnected environments TOC #1 (#21649) * Clean up disconnected environments TOC: remove RAC, AD-less deploy, and generic Update entries not yet in ALDO (AB#627613) * Remove Upgrade node from disconnected environments; not relevant to ALDO (AB#627613)
Update Go SDK reference link to pkg.go.dev (AB#598411) (#21647) Replace deprecated godoc.org URL with canonical pkg.go.dev URL for the azurestackhci Go SDK reference in the Azure Local TOC.
Add What's new for Multi-rack (ALRS 1.3, 1.4, 1.5) (#21460) * Add What's new and Known issues for Multi-rack ALRS 1.3, 1.4, 1.5 Adds two new articles under azure-local/multi-rack/: - multi-rack-whats-new.md: Business-value features for ALRS 1.3, 1.4, and 1.5 - multi-rack-known-issues.md: Customer-facing fixed and known issues per release Content follows the hyperconverged azure-local/whats-new.md and known-issues.md structure with moniker blocks. Placeholders azloc-2605/2606/2607 are used pending finalization of the multi-rack moniker set (flagged with HTML comments). Release build/version strings and dates are marked as TODOs for PM confirmation. Also adds a Release notes node under Multi-rack deployments in azure-local/TOC.yml. * Split ALRS 1.4 and 1.5 known issues into new + carried-over sections Adds explicit 'Known issues from previous releases' subsection to the ALRS 1.4 (azloc-2606) and 1.5 (azloc-2607) moniker blocks. Each subsection includes a disclaimer noting the items are carried over from earlier releases. - ALRS 1.4: 11 new-in-release items + 32 carried over from 1.3 - ALRS 1.5: 23 new-in-release items + 33 carried over from 1.3/1.4 Also re-adds bugs 27783182 (VM excessive memory timeout) and 27933232 (NodeFailure handler restarts user-stopped VMs) to 1.4's carried-over section. Both remain unresolved in the source wiki bug view for 1.4. * Apply Learn Authoring Assistant style suggestions to whats-new * Apply Learn Authoring Assistant grammar tweaks to known issues Kept: 'a user has stopped' -> 'a user stopped' in the Node Failure known-issue rows for 1.3 and 1.4. Reverted: frontmatter title changes that violated Learn style (Title Case on known-issues; trailing '?' on whats-new). * Apply suggestion from @learn-build-service-prod-01[bot] Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Align multi-rack whats-new and known-issues with reference style whats-new.md: - Rewrite intro to match reference article pattern - Trim/genericize feature descriptions; add links to existing multi-rack articles where they exist - Consolidate portal parity items into a single 'Azure portal' bucket - Rename bucket 'Runtime update visibility' -> 'Update management' - Rename bucket 'AKS enabled by Arc on multi-rack deployments' -> 'AKS enabled by Azure Arc' - Drop internal 'NC 4.11/4.12 runtime' references and internal component names (VMC, credential manager, etc.) - Drop 'ALRS' codename; use 'multi-rack' or bare version numbers matching reference 'in 2607' pattern known-issues.md: - Drop 'customer-facing' from all table intro sentences (matches reference) - Prose 'HCI VM' -> 'Azure Local VM' (product rename) - Split 'Known issues' into 'Known issues' (new) + 'Known issues from previous releases' (carried over), with disclaimer sentences, for 1.4 and 1.5 moniker blocks - Convert third-person 'customer(s)' / 'user(s)' to second person 'you/your' (or 'people' for accessibility) - Drop 'ALRS' codename throughout (section headers, TODO comments, prose) - Feature column: Portal -> Azure portal (17 rows); reclassify 'CLI' rows by affected feature (Azure Local VMs, HAKS, Networking) per reference pattern - Fix 'Consumer Storage Network' typo -> 'Cloud Services Network (CSN)' - Remove internal prose references (Nexus VM/portal/cluster -> Azure Local VM/Azure portal/cluster) - Expand acronyms on first use per moniker block: NAKS, HAKS, CSN, VNF, CSI, NFS, PVC, SDN * Match reference heading structure in known-issues - Rename section headers 'Known issues for X.Y' -> 'Known issues for version X.Y' (matches reference 'for version 2607' pattern) - Promote Fixed issues, Known issues, Known issues from previous releases from H3 to H2 for scannability, matching reference structure * Generalize carried-over intro and fix a/an grammar * Generalize 1.4 carried-over intro; fix 'a Azure' -> 'an Azure' * Apply suggestion from @learn-build-service-prod-06[bot] Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * Update azure-local/multi-rack/multi-rack-whats-new.md Co-authored-by: Andrew Karandjeff <7432527+eak13@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Update title and description in multi-rack-whats-new.md * Fix formatting for Kubernetes version support entry * Update documentation via Quick Workspace * Clarify secondary NIC IP assignment and static-only LNET support in 1.5 --------- Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Andrew Karandjeff <7432527+eak13@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>
591320: Azure Local TOC modernization: scenario-first navigation (#21093) * Add Azure Local TOC modernization mockup for stakeholder review Side-by-side scenario-first TOC mockup (TOC.modernization-mockup.yml) that implements the structure proposed in the Azure Local TOC Modernization & Content Consolidation Plan: L1 Connected | Disconnected | Workloads | Operate Azure Local L2 Hyperconverged | Disaggregated | Multi-rack | Small form factor L3 Evaluate | Plan | Set up | Operate (deployment-specific) L4 Tasks / articles Shared operations (monitor, update, troubleshoot, backup, migrate) are consolidated under a single Operate Azure Local branch. Workloads (VM, AKS, SQL, AVD, AI) are lifted out of deployment branches. Real hrefs from the current TOC.yml are reused where they map cleanly; TODO comments mark nodes that need new or consolidated articles. The live TOC.yml is unchanged. This file is not wired into docfx.json. * Refactor TOC mockup to strict scenario > deployment-model > Set up | Operate * Populate strict-alignment TOC mockup with all existing articles * Add missing disconnected troubleshoot articles to mockup * Consolidate all multi-rack articles under Connected > Multi-rack Per stakeholder request, all multi-rack articles now live exclusively under Connected > Multi-rack: - Multi-rack VM articles moved from Workloads > Azure Local VMs back into Connected > Multi-rack > Set up (create) and Operate (manage). - Multi-rack-specific concepts (compute, network fabric, load balancer, NAT, VM mgmt overview, security) consolidated under Set up. - Multi-rack reference (Network Cloud REST API, Network Fabric CLI, stack-hci-vm CLI) moved from top-level Reference into Operate > Reference. - Workloads > Azure Local VMs and top-level Reference now carry NOTE comments pointing to the multi-rack space. * Hyperconverged: apply scenario-first L4 phase grouping Set up restructured into six explicit L4 phases for a readable scenario flow: About / Evaluate / Plan / Prepare / Deploy / Enable add-ons. Use this as the template for Disaggregated, Multi-rack, and Small form factor. Set up changes: - New About phase (deployment-model intro only). - Plan phase wraps requirements, network reference patterns, Arc gateway, private endpoints, network considerations, security, env readiness, AD settings (previously flat L4 siblings). - New Prepare phase: prerequisites, AD prep, software download. - Deploy phase: install/register/deploy steps + Key Vault alt deploy + Deploy rack aware cluster (moved from Operate, since it's an end-to-end deploy workflow, not a day-2 op). - New Enable add-ons phase: Enable SDN + Enable external storage. Operate changes: - Rack aware cluster removed (moved to Set up > Deploy). - Migrate now precedes Troubleshoot (lifecycle order). Cross-cutting items relocated out of Hyperconverged Set up: - Compare to Windows Server -> top-level Concepts. - Release information / Known issues / Security updates -> top-level Overview as 'Current release' subgroup. - OEM license information / OEM license FAQ -> top-level Resources as 'OEM licensing' subgroup. Coverage: 399 unique articles preserved. * Propagate scenario-first L4 phase template to all Connected deployment models Disaggregated: - Set up reshaped to About / Plan / Prepare / Deploy / Enable add-ons. - 6 cross-cutting product items (Compare, Release info, Known issues, Security updates, OEM x2) removed; they live under top-level Concepts / Overview / Resources only. - Operate: Migrate moved before Troubleshoot (lifecycle order). - No Evaluate phase (no virtual deploy / jumpstart article today). Multi-rack: - Set up reshaped to About / Plan / Prepare / Deploy. - Concept articles grouped under Plan; CLI ext + prereqs under Prepare; L3 isolation, networking prereqs, SDN infra, VM workloads under Deploy. - No Evaluate / Enable add-ons phases today. Small form factor: - Set up reshaped to About / Evaluate / Plan / Prepare / Deploy. - About holds model intro + SFF-specific lifecycle (Known issues, FAQ). - Plan holds concepts + security/firewall. - Evaluate keeps VM-install path; Prepare = subscription; Deploy keeps install/connect/run/deploy applications/GPU workloads. - No Enable add-ons phase today. Coverage: 399 unique articles preserved. * Disconnected > Hyperconverged: apply minimal L4 phase grouping Set up reshaped to About / Plan / Deploy (no Evaluate, Prepare, or Enable add-ons phases since disconnected has no articles for those). Operate uses L4 grouping only where it pays off: - Manage (group: CLI, PowerShell, Policy, Billing) - Update disconnected operations (single article, kept flat at L4) - Back up and restore (group: Back up, Restore) - Monitor (disconnected) (single article, kept flat at L4) - Troubleshoot (disconnected) (existing group) Single-article verbs stay as flat L4 siblings rather than wrapping them in items: lists just to look uniform. Disaggregated / Multi-rack / SFF disconnected placeholders left as TODO pending confirmation those combos ship. Coverage: 399 unique articles preserved. * Disconnected > Hyperconverged > Operate: rename 'Manage' to 'Manage with Azure tooling' The bare 'Manage' bucket sat next to specific verbs (Update, Back up and restore, Monitor, Troubleshoot) and read ambiguous. The renamed form makes the bucket's intent (CLI / PowerShell / Policy / Billing admin) explicit. * Update strict-mode rules header: six-phase Set up, fixed Operate order, SFF/multi-rack carve-out * Exclude TOC.modernization-mockup.yml from azure-local docfx build The mockup is a side-file for stakeholder review and isn't a real TOC. Excluding it from both content groups stops the OPS validator from flagging schema-not-found and the filename-rule warnings against it. * Fix mockup file validation: add schema directive and rename - Prepend '### YamlMime:TableOfContent' so the Learn validator recognizes the schema (fixes schema-not-found error). - Rename TOC.modernization-mockup.yml -> toc-modernization-mockup.yml (lowercase + hyphens only, no dot separator) fixes filename-invalid-character warning and filename-incomplete suggestion. - Update docfx.json exclude entries to match the new filename. * Updated existing TOC for mockup * Updated to remove unnecessary aarticle * Updated TOC - Hyperconverged - Evaluate * Updated TOC * Add topology-first TOC mockup as alternative for stakeholder review Side-by-side comparison candidate to the connectivity-first L2 in TOC.yml. Excluded from build via docfx.json. Same Set up/Operate templates, same Manage L5 areas - only the L2 axis differs (topology-first vs connectivity-first). * Fully populate topology-first TOC mockup (all 500 hrefs from TOC.yml) Generated programmatically via .build-topology-first.js so both models share identical article inventory. Verified: same 500 unique hrefs in both TOC.yml and the topology-first side-file. * TOC modernization: add Find your deployment type, flatten Set up, consolidate What's new/Release notes/Operations at connectivity level * Apply suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Remove topology-first mockup artifacts (PR #21102 closed) Drops .build-topology-first.js and toc-modernization-topology-first.yml, and reverts azure-local/docfx.json exclusions for both stale mockup files. Connectivity-first remains the sole proposal in TOC.yml. * TOC: move Operations to last position, rename Enable add-ons to Enable, promote Network ATC - Connected environments: Operations moved from before Hyperconverged to after Small form factor (last L2). Same in Disconnected environments.\n- Renamed 'Enable add-ons' L3 node to 'Enable' under Hyperconverged and Disaggregated (plus matching comment markers).\n- Concepts: replaced 'Host networking' L2 wrapper with a direct 'Network ATC' L2 entry pointing to the same article. * find-your-deployment-type: rewrite arc summary in active voice, second person, present tense Replaces the 'six-phase template' list-style sentence with an active-voice sentence aligned to the actual TOC (no Evaluate in the universal arc; Enable instead of Enable add-ons). * TOC comments: clean up after Operations move and other recent edits - Header docblock: fix layout (Operations is last), drop stale 'Not wired up to docfx.json' status, scope the Disconnected reduced-set claim to Hyperconverged only.\n- Connected/Disconnected env intros: reword to reflect that Operations now sits at the end of each connectivity branch.\n- Hyperconverged SET UP comment: drop the 'Evaluate' phase that doesn't exist for HCI.\n- Remove stale 'OPERATE' separator comments between Connected deployment models (Operate is consolidated under shared Operations).\n- Move misplaced 'SCENARIO 2: Disconnected environments' and 'WORKLOADS' section banners to sit above their actual L1 nodes (they were stranded inside the previous parent after the Operations move).\n- Move the Disconnected Operations NOTE (L4 template explainer) so it attaches to the relocated Operations node. * TOC: apply reviewer feedback — merge HC+Disagg, split Workloads, consolidate Resources - Move Billing under Resources (from Hyperconverged>Manage and Disconnected>Manage) - Nest Reference and Related under Resources as L2 - Merge Hyperconverged + Disaggregated into a single L2 under Connected, with separate Set up (hyperconverged)/Set up (disaggregated) and a shared Operate (moves the former Connected>Operations L2 inside as Operate L3) - Move Azure Local observability and Network ATC from top-level Concepts into the merged L2 as a Concepts L3 - Split top-level Workloads L1 into two L2s: one under Connected environments (all workload categories minus 3 disconnected leaves) and one under Disconnected environments (Azure Local VMs, AKS, and ACR in disconnected) Addresses PR feedback items R1-#1, #3, #4, #5 and R2-#1, #3. * TOC: move Network ATC overview from Concepts to Operate>Manage>Networking Groups the overview with its two how-tos (Add NICs / Replace a failed NIC in a Network ATC intent). Concepts L3 wrapper now contains only Azure Local observability. * TOC: move Azure Local observability to top-level Concepts L1 Removes the now-empty Concepts L3 wrapper inside Hyperconverged and disaggregated. Top-level Concepts L1 now contains Compare to Windows Server and Azure Local observability. * TOC: prune Disaggregated/Multi-rack/SFF TODO stubs under Disconnected environments Removes the three L2 placeholders that had no supporting documentation: - Disaggregated - Multi-rack - Small form factor Disconnected environments now lists only the deployment models that have existing content today (Hyperconverged), plus Workloads and Operations. Addresses reviewer feedback R1-#2 (partial): don't surface deployment models without docs on the disconnected pillar. * TOC: refresh header and section intro comments to match current structure Updates the doc comments to reflect the recent restructuring so future readers of the mockup see an accurate map of the layout: - Header layout diagram now shows the six current L1s (Overview, Connected environments, Disconnected environments, Concepts, Resources) and drops the removed top-level Workloads branch. - Header rules note the merged 'Hyperconverged and disaggregated' L2 on the connected pillar (with Set up (hyperconverged) / Set up (disaggregated) / Operate L3s) and clarify the disconnected pillar only surfaces Hyperconverged today. - Header adds a Workloads-split-by-connectivity rule and a Resources consolidation rule (Billing / Reference / Related now grouped under Resources). - Connected shared intro comment reflects the merged L2 with an internal Operate L3 instead of a separate top-level Operations node. - Disconnected shared intro comment reflects the removal of the Disaggregated / Multi-rack / SFF stubs. No structural TOC changes. * TOC: rewrite legend to match how FROM/REUSE/TODO are actually used The prior legend implied # FROM would appear on individual articles, but in practice it's used on section-header comments to trace a grouped block back to its original TOC section (only 1 of ~10 uses is on an article line). Update the legend text so it matches actual practice and adds usage location hints for REUSE and TODO. * Refine TOC labels and restructure Monitor - Rename "Set up (hyperconverged/disaggregated)" to "Install and deploy (...)" - Rename "Operate" to "Configure and manage"; add scope suffix on the shared Hyperconverged+Disaggregated node only - Move "Azure Local observability" from top-level Concepts to Configure and manage > Monitor > About - Group Monitor into subsections: About, Insights, Metrics and alerts, Health Service, Drift detection - Sync all header comments to match new node names * docs: rework Disconnected environments around Control Plane, refine Multi-rack/SFF/Overview/Resources per PM feedback * Updated TOC * docs: add install/deploy callout to control plane hardware article * docs: duplicate deployment-model TOC nodes for disconnected env * docs: remove deployment-model callout from control plane appliance * docs: merge Connected Configure-and-manage into one shared node * docs: fix REUSE tag gap, trim wordy comments, fix spacing * docs: fix customer intent persona in find-your-deployment-type * docs: nest Disconnected Install-and-deploy/Configure-and-manage under a Hyperconverged and disaggregated node * docs: hoist Deployment overview above Prepare in all four Install and deploy sections * docs: apply PM feedback -- suite grouping in Workloads, Partner Ecosystem + Odin under Resources, mirrored Overview headers - Connected > Workloads: grouped into AI suite / Data suite / Productivity suite / Bring your own apps / Other. Added Microsoft 365 Local, GitHub Enterprise Local, Azure IoT Operations. AKS nested under Bring your own apps (with note about planned move to AKS docs). - Disconnected > Workloads: grouped into AI suite / Productivity suite / Bring your own apps. Added AI workloads overview and Microsoft 365 Local. - Resources: removed 'Renaming to Azure Local'; added Odin for Azure Local link; added Partner Ecosystem section (solutions catalog, WAF); updated Pricing URL to azure.microsoft.com/pricing/details/azure-local/. - Mirrored Connected and Disconnected openers: wrapped What's new and Release notes under an Overview header in both sections. * docs: restructure Disconnected > Operate the Control Plane per PM feedback - Drop the 'Services' wrapper so Operate the Control Plane's children sit one level up. - Split the old 'Manage' node into siblings: Azure CLI, Azure PowerShell, and Backup and restore (nesting the back up and restore articles). - Add TODO stubs for Certificate rotation and Platform expansions. - Simplify labels (drop '(disconnected)' and 'disconnected operations' suffixes) to match the PM's list. - Reorder to PM's sequence: Update / Backup and restore / Certificate rotation / Monitor / Azure CLI / Azure PowerShell / Platform expansions / Troubleshoot / Azure Policy (kept and flagged -- PM's list didn't mention it). * docs: link Certificate rotation to disconnected-operations-cert-rotation.md (PR #21434) * docs: sync stale hrefs with upstream/main renames (cert rotation + SFF prepare-to-deploy) - disconnected-operations-cert-rotation.md -> disconnected-operations-certificate-rotation.md (renamed during PR #21504 merge). - small-form-factor-subscription-setup.md -> small-form-factor-prepare-to-deploy.md (renamed upstream); relabeled 'Set up subscription' -> 'Prepare to deploy' to match the article's broader scope. * docs: wire 17 new upstream articles into modernized TOC + relabel Key Vault node New article placements: - Deploy > 'Deploy using local identity with Azure Key Vault': add 'Overview' (deployment-local-identity-with-key-vault-overview.md) in all four blocks (Connected/Disconnected x Hyperconverged/Disaggregated). Also relabel the parent from 'Key Vault' to 'Azure Key Vault' to match the full product name and article titles. - Install and deploy (disaggregated) > Plan > Review disaggregated network reference patterns: add 'iSCSI 6-NIC disaggregated pattern' (Connected + Disconnected). - Configure and manage > Manage > SDN: add 'Optimize SDN availability and performance' (Connected + Disconnected). - Configure and manage > Manage > Systems: add 'Configure local availability zones' (Connected + Disconnected). - Configure and manage > Manage > GPUs: add 'REST APIs for GPU management' (Connected + Disconnected). - Disconnected > Operate the Control Plane > Backup and restore: add 5 post-restore recovery articles. - Connected > Workloads > Bring your own apps > Azure Local VMs: add new 'Confidential VMs' subsection (6 CVM articles, AB#600938). Verified: 897 TOC nodes, 0 broken relative hrefs against upstream/main + local file tree. * docs: rename Key Vault 'Overview' node to 'About local identity with Azure Key Vault' (4 places) * docs(find-your-deployment-type): align intro wording with style guide * docs(toc): trim comment noise for publication review Remove placeholder TOC nodes that were waiting on articles that don't exist yet (About workloads on Azure Local, Platform expansions), drop recurring # NOTE rationale blocks that duplicated content already documented in the PR description, and trim the mockup-specific header comment. Section markers, banner blocks, and inline # REUSE / # FROM / # TODO tags are preserved. * Update documentation via Quick Workspace * Update documentation via Quick Workspace * Update documentation via Quick Workspace * Update documentation via Quick Workspace * Update documentation via Quick Workspace * Update documentation via Quick Workspace * Update documentation via Quick Workspace --------- Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: Ronmia Bess <content-mentor@example.com>
Merge pull request #21597 from MicrosoftDocs/release-local-2608 Merge release-local-2608 to main for release
Sync main into release-local-2608 (#21593) Sync main into release-local-2608
SFF update OS (#21577) * add upgrade page * add skeleton of update docs * Update date for Small Form Factor upgrade documentation * Apply suggestions from code review Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Update A/B image-based update mechanism description Clarified the description of the A/B image-based update mechanism in the Small Form Factor Deployments documentation. * Clarify small form factor deployment update instructions Updated terminology to clarify the document's focus on small form factor deployments. Improved descriptions and formatting for better readability. * Apply suggestion from @learn-build-service-prod-03[bot] Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Refine update tracking and rollback documentation Removed redundant sentences about update completion and rollback. Clarified rollback mechanism and testing instructions. * Update failure status wording in upgrade guide * Delete azure-local/small-form-factor/media/small-form-factor-update-available.png * Delete azure-local/small-form-factor/media/small-form-factor-update-initiated.png * Delete azure-local/small-form-factor/media/small-form-factor-update-status-failed.png * Delete azure-local/small-form-factor/media/small-form-factor-update-status-started.png * Delete azure-local/small-form-factor/media/small-form-factor-update-status-success.png * update image * Delete azure-local/small-form-factor/media/small-form-factor-update-disk-layout.png * Rename small-form-factor-update-disk-layout.png to azure-local/small-form-factor/media/small-form-factor-update-disk-layout.png --------- Co-authored-by: Adam Sarsony <adamsarsony@microsoft.com> Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com>
SFF reset OS (#21576) * Add SFF OS reset and installation guidance * Add SFF OS maintenance articles to TOC * Clarify SFF OS reset guidance * Update azure-local/small-form-factor/small-form-factor-os.md Co-authored-by: sipastak <61058798+sipastak@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-os.md Co-authored-by: sipastak <61058798+sipastak@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-os.md Co-authored-by: sipastak <61058798+sipastak@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-os.md Co-authored-by: sipastak <61058798+sipastak@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-os.md Co-authored-by: sipastak <61058798+sipastak@users.noreply.github.com> * Revise OS management article for small form factor Updated title and content to specify small form factor deployments of Azure Local. * Update OS management link in TOC.yml * Remove OS version update link from next steps --------- Co-authored-by: Roycey Cheeran <103701589+rcheeran@users.noreply.github.com>
Sync main into release-local-2608 (#21579) Sync main into release-local-2608
Sync main into release-local-sff-2607 (#21583) Sync main into release-local-sff-2607
SFF Manage network interfaces (#21574) * Add files via upload * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update azure-local/small-form-factor/small-form-factor-resources.md Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Add files via upload * Revise small form factor resources documentation Adding screen shots. * Fixing !NOTE notation Correcting !NOTE Notation indent * Apply suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Fixed !NOTE indentation * Update small form factor network interfaces documentation * Apply suggestions from code review Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Revise small form factor network interfaces documentation Updated article to better describe a local change of network address scenario per feedback. * Revise small form factor network interfaces documentation Updated metadata and content formatting for clarity and consistency. * Apply suggestions from code review Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Revise article metadata and content for clarity Updated metadata and content for the Azure Local Small Form Factor Network Interfaces article. * Rename small-form-factor-NetworkInterfaceDetail.png to small-form-factor-network-interface-detail.png * Rename small-form-factor-NetworkInterfaceList.png to small-form-factor-network-interface-list.png * Rename small-form-factor-NetworkInterfaceModifyDHCP.png to small-form-factor-network-interface-modify-dhcp.png * Rename small-form-factor-NetworkInterfaceModifyStatic.png to small-form-factor-network-interface-modify-static.png * Rename small-form-factor-NetworkInterfaceReconciliation.png to small-form-factor-network-interface-reconciliation.png * Update metadata and images in network interfaces doc * Update TOC.yml with new connectivity modes and items * Update small-form-factor-network-interfaces.md --------- Co-authored-by: Tony Joint <ajoint@gmail.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com>