Skip to content

Commit 480c3c7

Browse files
author
Cam Soper
authored
Add documentation for ContainerPublishInParallel property (#45905)
* Add documentation for the `ContainerPublishInParallel` MSbuild property Fixes #45547 * Fix typo in `ContainerPublishInParallel` documentation for clarity
1 parent e29a17c commit 480c3c7

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/core/containers/publish-configuration.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,18 @@ The preceding project configuration results in a final tag of `8.0-alpine` for a
9898

9999
This field is free-form, and often can be used to select different operating system distributions, default package configurations, or any other _flavor_ of changes to a base image. This field is ignored when `ContainerBaseImage` is set. For more information, see [.NET container images](../docker/container-images.md).
100100

101+
### `ContainerPublishInParallel`
102+
103+
For multi-RID containers, certain project types (like Blazor WebAssembly) may encounter build race conditions. To address this, starting with .NET SDK versions 8.0.408, 9.0.300, and 10.0, you can control the parallelism of the publish process using the `ContainerPublishInParallel` property. By default, publishing occurs in parallel for each Runtime Identifier (RID). Setting this property to `false` ensures sequential publishing, which increases stability but may take longer.
104+
105+
```xml
106+
<PropertyGroup>
107+
<ContainerPublishInParallel>false</ContainerPublishInParallel>
108+
</PropertyGroup>
109+
```
110+
111+
For more information on multi-RID publishing, see [ContainerRuntimeIdentifier(s)](#containerruntimeidentifiers).
112+
101113
### `ContainerRuntimeIdentifier(s)`
102114

103115
The `ContainerRuntimeIdentifier` property specifies the OS and architecture for your container if the `ContainerBaseImage` supports multiple platforms. For example, the `mcr.microsoft.com/dotnet/runtime` image supports `linux-x64`, `linux-arm`, `linux-arm64`, and `win10-x64`. By default, this is set to the `RuntimeIdentifier` used when publishing the container. Typically, you don't need to set this property explicitly; instead, use the `-r` option with the `dotnet publish` command. If the chosen image doesn't support the specified `RuntimeIdentifier`, an error indicates the supported identifiers.

0 commit comments

Comments
 (0)