From caeeee81e68409d01c297a52ad79831122390b13 Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Fri, 6 Nov 2026 22:33:54 +0000 Subject: [PATCH 1/2] Document initial WSLc publish support --- .../src/content/docs/app-host/configuration.mdx | 2 +- .../src/content/docs/get-started/prerequisites.mdx | 11 +++++++---- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/src/frontend/src/content/docs/app-host/configuration.mdx b/src/frontend/src/content/docs/app-host/configuration.mdx index 1013a3d63a..b363f5819c 100644 --- a/src/frontend/src/content/docs/app-host/configuration.mdx +++ b/src/frontend/src/content/docs/app-host/configuration.mdx @@ -113,7 +113,7 @@ In TypeScript AppHosts, profiles live in `aspire.config.json`: | Option | Default value | Description | | ---------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ASPIRE_ALLOW_UNSECURED_TRANSPORT` | `false` | Allows communication with the AppHost without https. `ASPNETCORE_URLS` (dashboard address) and `ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL` (AppHost resource service address) must be secured with HTTPS unless true. | -| `ASPIRE_CONTAINER_RUNTIME` | Auto-detected | Selects the runtime for container resources. Supported values are `docker`, `podman`, and `wslc`. WSLc is supported only on Windows and only for local development. Publish and deploy are not yet supported. See [container runtime prerequisites](/get-started/prerequisites/#install-an-oci-compliant-container-runtime). | +| `ASPIRE_CONTAINER_RUNTIME` | Auto-detected | Selects the runtime for container resources. Supported values are `docker`, `podman`, and `wslc`. WSLc is supported only on Windows. Publishing has initial, limited support: Dockerfile builds without platform selection, image tag/remove/push, registry login, and single-platform .NET SDK publishing to the WSLc local image store (requires an SDK with WSLc support). Compose deployment, platform-selected Dockerfile builds, manifest inspection, and multi-platform local publishing aren't supported and fail with an explicit error. Daemon-free .NET SDK archive publishing still works. See [container runtime prerequisites](/get-started/prerequisites/#install-an-oci-compliant-container-runtime). | | `ASPIRE_DCP_USE_DEVELOPER_CERTIFICATE` | `true` | When `true` (the default), Aspire uses the ASP.NET Core developer certificate to secure the internal DCP server instead of an ephemeral certificate generated by DCP. On Windows, Aspire passes the certificate thumbprint to DCP. On macOS and Linux, Aspire passes the certificate and private key file paths (plus the thumbprint) so DCP can verify the loaded certificate. Set to `false` to opt out and use DCP's default ephemeral certificate. If no trusted developer certificate is found, Aspire automatically falls back to the ephemeral certificate. For more information, see [Certificate configuration](/app-host/certificate-configuration/). | | `ASPIRE_ENVIRONMENT` | `null` | Configures the AppHost environment when no higher-priority environment source is set. If no environment is configured, the AppHost uses `Production`. | | `ASPIRE_VERSION_CHECK_DISABLED` | `false` | When set to `true`, Aspire doesn't check for newer versions on startup. | diff --git a/src/frontend/src/content/docs/get-started/prerequisites.mdx b/src/frontend/src/content/docs/get-started/prerequisites.mdx index 6bf27f85d5..28a8c02666 100644 --- a/src/frontend/src/content/docs/get-started/prerequisites.mdx +++ b/src/frontend/src/content/docs/get-started/prerequisites.mdx @@ -83,9 +83,9 @@ Ready to dive into Aspire? Before you begin, make sure your development environm title: 'WSLc', href: 'https://aka.ms/aspire/containers', linkLabel: 'Set up WSLc', - statusLabel: 'Windows local development only', + statusLabel: 'Windows only; limited publish support', description: - 'A supported container runtime for local development on Windows. Requires WSLc version 3.0.2.0 or later. Publishing and deployment are not supported yet.', + 'A supported container runtime for local development on Windows. Requires WSLc version 3.0.2.0 or later. Publishing has initial, limited support; Compose deployment isn't supported.', }, { id: 'rancher', @@ -112,8 +112,11 @@ Ready to dive into Aspire? Before you begin, make sure your development environm :::note[WSLc on Windows] `aspire doctor` auto-detects installed runtimes in Docker, Podman, WSLc priority order. Set `ASPIRE_CONTAINER_RUNTIME=wslc` to select WSLc explicitly. WSLc isn't supported - when Aspire runs inside a Linux WSL distribution. It is currently supported only - for local development on Windows, not for publishing or deployment. + when Aspire runs inside a Linux WSL distribution. Publishing has initial, + limited support: Dockerfile builds (Dockerfile resources default to `linux/amd64`, which WSLc + can't build, so set `TargetPlatform = null` in `WithContainerBuildOptions`), image tag/remove/push, + registry login, and single-platform .NET SDK publishing to the local image store. Compose + deployment and multi-platform local publishing aren't supported. ::: 1. ## Install an integrated development environment (IDE) From 442928e32a133b209cb9de2065e8fffb49babad7 Mon Sep 17 00:00:00 2001 From: danegsta <50252651+danegsta@users.noreply.github.com> Date: Mon, 16 Nov 2026 21:29:12 +0000 Subject: [PATCH 2/2] Update WSLc Playwright expectations for limited publishing support Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> --- src/frontend/tests/e2e/custom-components.spec.ts | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/frontend/tests/e2e/custom-components.spec.ts b/src/frontend/tests/e2e/custom-components.spec.ts index 325b136e14..7046cf4bab 100644 --- a/src/frontend/tests/e2e/custom-components.spec.ts +++ b/src/frontend/tests/e2e/custom-components.spec.ts @@ -351,9 +351,11 @@ test('prerequisites presents runtime choices with Podman setup and WSLc limitati await expect(wslcChoice).toBeVisible(); await expect(podmanChoice).toBeHidden(); - await expect(wslcChoice).toContainText('Windows local development only'); + await expect(wslcChoice).toContainText('Windows only; limited publish support'); await expect(wslcChoice).toContainText('Requires WSLc version 3.0.2.0 or later.'); - await expect(wslcChoice).toContainText('Publishing and deployment are not supported yet.'); + await expect(wslcChoice).toContainText( + "Publishing has initial, limited support; Compose deployment isn't supported." + ); await expect(wslcChoice.getByRole('link', { name: 'Set up WSLc' })).toHaveAttribute( 'href', 'https://aka.ms/aspire/containers'