Commit afb88d9
Reshuffle deployment docs: new pages, sidebar restructure, messaging updates (#644)
* Reshuffle deployment docs structure
- Move pipelines doc from get-started to deployment section
- Move manifest-format under deployment/azure with deprecation notice
- Create new Deploy to Docker Compose page
- Create new Deploy to Kubernetes page
- Create new Azure Developer CLI (azd) page (legacy/alternative path)
- Create new Customize Azure Container Apps page
- Remove stale preview labels (aspire deploy and Docker are GA)
- Update Docker package version from preview to 13.1.0
- Remove manifest references from general-purpose docs
- Position aspire deploy as primary Azure deployment path
- Trim integration pages (Docker, K8s) to link to deployment pages
- Update sidebar, redirects, and cross-references
- Update stale aspire-8.0.json schema reference
Addresses: #354, #331, #335, #358, #359
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Move Japanese pipelines translation to match new slug
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix localized pipeline links to new deployment path
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix duplicate K8s sidebar entry and remove pipelines from docs.topics.ts
- Remove duplicate 'Deploy to Kubernetes' sidebar entry
- Remove pipelines from get-started sidebar (already in deployment sidebar)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add TypeScript AppHost tabs to all deployment pages
- Add C#/TypeScript tabs to 14 AppHost code blocks across 4 pages
- Add 'not yet available' notes for 3 APIs without TS support:
ConfigureEnvFile, WithImagePushOptions, ConfigureCustomDomain
- Fix Docker package version to 13.2.0
- Add Preview badge to Kubernetes deployment page
- Remove manifest schema ref from hosting-integrations
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix TypeScript API examples to match actual compiler-verified signatures
- addProject needs 3 args (name, path, launchProfile)
- addContainer uses single image:tag string
- Callbacks must be async (publishAsDockerComposeService, etc.)
- Properties use .set() pattern (service.name.set, k8s.helmChartName.set)
- ImagePullPolicy uses enum import, not string literal
- addContainerRegistryFromString for string args
- publishAsExisting takes strings, not ParameterResource
- withResourceGroup removed from TS (takes ParameterResource)
- publishAsAzureContainerApp callback simplified (ContainerAppHandle)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Reorder deployment sidebar: group targets, add Advanced section
- Move deploy targets (Docker, K8s, Azure) right after Pipelines
- Move azd to bottom of Azure section (legacy)
- Move Deploy JavaScript apps below targets
- Group state caching + custom pipelines under collapsed Advanced
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix 3 critical issues found by doc-tester
- K8s: Remove invalid resource.Deployment reference (use comment placeholder)
- ACA: Fix PublishAsExisting to require 2 params (name + resourceGroup)
- ACA: Fix WithResourceGroup — it's on AzureEnvironmentResource, not individual resources
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add TypeScript tab to pipelines page with 'not yet available' note
Follow existing pattern: show TS tab with :::note when API isn't in TS SDK.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Use tab pattern for unavailable TS APIs instead of standalone Aside
Convert ConfigureEnvFile, WithImagePushOptions, and ConfigureCustomDomain
to show a TypeScript tab with :::note inside, matching the established
pattern used in container-files.mdx and other docs.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Move app lifecycle guide to deployment section
- Move fundamentals/app-lifecycle.mdx to deployment/app-lifecycle.mdx
- Add to deployment sidebar as 'App lifecycle (CI/CD)'
- Update slug in docs.topics.ts
- Add redirect from old path
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Clean .NET-centric language from app lifecycle guide
- Frame example as C# with note that TS AppHosts follow same pattern
- Replace AppHost.cs references with generic 'AppHost'
- Change '.NET process' to 'local process'
- Add tip about TypeScript AppHost equivalence
- Note --project flag purpose in CI/CD example
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix doc-tester final round issues
- Remove app-lifecycle from docs.topics.ts (fixes wrong prev/next nav)
- Fix WellKnownSteps → WellKnownPipelineSteps (8 occurrences in prose)
- Add missing using/pragma to pipelines code example
- Add missing 'using Aspire.Hosting.Docker' to ConfigureEnvFile example
- Add missing ASPIRECOMPUTE003 pragma to AddContainerRegistry example
- Add missing ASPIREACADOMAINS001 pragma to ConfigureCustomDomain example
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix K8s deploy column: no aspire deploy support for Kubernetes
Kubernetes uses aspire publish + Helm/kubectl, not aspire deploy.
Addresses review feedback.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Address PR review feedback from @JamesNK
- docker-compose: mention AddDockerComposeEnvironment in prose, highlight key lines
- docker-compose: change example resource name to avoid 'docker-compose-down-compose'
- kubernetes: rename to 'Publish to Kubernetes', clarify no aspire deploy support
- kubernetes: mention AddKubernetesEnvironment in prose, highlight key lines
- kubernetes: replace plaintext tree with FileTree component
- kubernetes: update sidebar label to match
- redirects: add missing Japanese locale redirect for pipelines
- deploy-first-app: fix lowercase 'when' at sentence start
- customize-container-apps: add TS tab to Resource groups section
- docker-compose: margin-bottom issue is a site-wide CSS concern (noted for @IEvangelist)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Address round 2 PR feedback from @JamesNK
- kubernetes: make TS samples match C# scope (snippet-only, not full builder)
- kubernetes: remove ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL caution (dashboard-only)
- azd: make TS sample match C# scope
- customize-aca: make all TS samples match C# scope (5 blocks fixed)
- customize-aca: link 'Azure Container Apps' to ACA about page
- customize-aca: add TS tab to Resource groups with :::note pattern
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Revert Kubernetes rename — keep 'Deploy to Kubernetes' in deployment section
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix C#/TypeScript sample parity across deployment pages
- docker-compose: remove builder boilerplate from registry TS sample
- customize-aca: clarify ContainerAppHandle scaling in TS comment
- customize-aca: clean up publishAsExisting TS sample (strings, not params)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Use 'env' as Docker Compose resource name in examples
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix 'front end' -> 'frontend' consistency in deploy-first-app
Addresses review feedback: standardize on 'frontend' (one word) throughout
prose and mermaid diagram labels.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fix remaining C#/TS sample mismatches
- docker-compose: use addParameterFromConfiguration to match C# config binding
- customize-aca: use publishAsExistingFromParameters with parameters to match C#
- ACA scaling: genuine API gap (ContainerAppHandle), comment is accurate
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Clean up content, fix issues with C# APIs being incorrect, link to aspire.dev API ref - instead of MS Learn, fix #645
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>1 parent dbc5b32 commit afb88d9
File tree
50 files changed
+2636
-365
lines changed- src/frontend
- config
- sidebar
- src
- content/docs
- app-host
- da
- deployment
- azure
- de
- es
- fr
- fundamentals
- get-started
- hi
- id
- integrations
- cloud/azure
- compute
- custom-integrations
- it
- ja
- deployment
- get-started
- whats-new
- ko
- pt-br
- reference/cli/commands
- ru
- tr
- uk
- whats-new
- zh-cn
- styles
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
50 files changed
+2636
-365
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
450 | 450 | | |
451 | 451 | | |
452 | 452 | | |
453 | | - | |
| 453 | + | |
| 454 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
72 | 72 | | |
73 | 73 | | |
74 | 74 | | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
75 | 79 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
64 | 64 | | |
65 | 65 | | |
66 | 66 | | |
67 | | - | |
68 | | - | |
| 67 | + | |
| 68 | + | |
69 | 69 | | |
70 | 70 | | |
71 | | - | |
72 | | - | |
73 | | - | |
74 | | - | |
75 | | - | |
76 | | - | |
77 | | - | |
78 | | - | |
79 | | - | |
80 | | - | |
81 | | - | |
82 | | - | |
83 | | - | |
84 | | - | |
85 | | - | |
86 | | - | |
87 | | - | |
88 | | - | |
89 | | - | |
90 | | - | |
91 | | - | |
92 | | - | |
93 | | - | |
94 | | - | |
95 | | - | |
96 | | - | |
97 | | - | |
98 | | - | |
99 | | - | |
100 | | - | |
101 | | - | |
102 | | - | |
103 | | - | |
104 | | - | |
105 | | - | |
106 | | - | |
107 | | - | |
108 | | - | |
109 | | - | |
110 | | - | |
| 71 | + | |
| 72 | + | |
111 | 73 | | |
112 | 74 | | |
113 | | - | |
114 | | - | |
115 | | - | |
116 | | - | |
117 | | - | |
118 | | - | |
119 | | - | |
120 | | - | |
121 | | - | |
122 | | - | |
123 | | - | |
124 | | - | |
125 | | - | |
126 | | - | |
127 | | - | |
128 | | - | |
129 | | - | |
130 | | - | |
131 | | - | |
| 75 | + | |
| 76 | + | |
132 | 77 | | |
133 | 78 | | |
134 | 79 | | |
| |||
172 | 117 | | |
173 | 118 | | |
174 | 119 | | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
175 | 124 | | |
176 | 125 | | |
177 | 126 | | |
| |||
193 | 142 | | |
194 | 143 | | |
195 | 144 | | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
196 | 181 | | |
197 | 182 | | |
198 | 183 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
529 | 529 | | |
530 | 530 | | |
531 | 531 | | |
532 | | - | |
533 | | - | |
534 | | - | |
535 | | - | |
536 | | - | |
537 | | - | |
538 | | - | |
539 | | - | |
540 | | - | |
541 | | - | |
542 | | - | |
543 | | - | |
544 | | - | |
545 | | - | |
546 | | - | |
547 | | - | |
548 | | - | |
549 | | - | |
550 | | - | |
551 | | - | |
552 | | - | |
553 | 532 | | |
554 | 533 | | |
555 | 534 | | |
| |||
571 | 550 | | |
572 | 551 | | |
573 | 552 | | |
574 | | - | |
575 | | - | |
576 | | - | |
577 | | - | |
578 | | - | |
579 | | - | |
580 | | - | |
581 | | - | |
582 | | - | |
583 | | - | |
584 | | - | |
585 | | - | |
586 | | - | |
587 | | - | |
588 | | - | |
589 | | - | |
590 | | - | |
591 | | - | |
592 | | - | |
593 | | - | |
594 | | - | |
595 | 553 | | |
596 | 554 | | |
597 | 555 | | |
| |||
1340 | 1298 | | |
1341 | 1299 | | |
1342 | 1300 | | |
1343 | | - | |
| 1301 | + | |
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
629 | 629 | | |
630 | 630 | | |
631 | 631 | | |
632 | | - | |
| 632 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
97 | 97 | | |
98 | 98 | | |
99 | 99 | | |
100 | | - | |
| 100 | + | |
101 | 101 | | |
102 | 102 | | |
103 | 103 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
99 | 99 | | |
100 | 100 | | |
101 | 101 | | |
102 | | - | |
| 102 | + | |
103 | 103 | | |
104 | 104 | | |
105 | 105 | | |
| |||
Lines changed: 19 additions & 8 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | | - | |
| 9 | + | |
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
| |||
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
| 28 | + | |
| 29 | + | |
28 | 30 | | |
29 | 31 | | |
30 | 32 | | |
| |||
104 | 106 | | |
105 | 107 | | |
106 | 108 | | |
107 | | - | |
| 109 | + | |
108 | 110 | | |
109 | 111 | | |
110 | 112 | | |
| |||
132 | 134 | | |
133 | 135 | | |
134 | 136 | | |
135 | | - | |
| 137 | + | |
136 | 138 | | |
137 | 139 | | |
138 | 140 | | |
| |||
193 | 195 | | |
194 | 196 | | |
195 | 197 | | |
196 | | - | |
| 198 | + | |
197 | 199 | | |
198 | 200 | | |
199 | 201 | | |
| |||
204 | 206 | | |
205 | 207 | | |
206 | 208 | | |
| 209 | + | |
207 | 210 | | |
208 | 211 | | |
209 | 212 | | |
| |||
241 | 244 | | |
242 | 245 | | |
243 | 246 | | |
244 | | - | |
| 247 | + | |
245 | 248 | | |
246 | 249 | | |
247 | 250 | | |
| |||
264 | 267 | | |
265 | 268 | | |
266 | 269 | | |
| 270 | + | |
| 271 | + | |
| 272 | + | |
| 273 | + | |
267 | 274 | | |
268 | | - | |
| 275 | + | |
269 | 276 | | |
270 | 277 | | |
271 | 278 | | |
| |||
329 | 336 | | |
330 | 337 | | |
331 | 338 | | |
332 | | - | |
| 339 | + | |
333 | 340 | | |
334 | 341 | | |
335 | 342 | | |
336 | | - | |
| 343 | + | |
| 344 | + | |
| 345 | + | |
| 346 | + | |
| 347 | + | |
337 | 348 | | |
338 | 349 | | |
339 | 350 | | |
| |||
0 commit comments