Microsoft.NET.Build.Containers
8.0.103
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.NET.Build.Containers --version 8.0.103
NuGet\Install-Package Microsoft.NET.Build.Containers -Version 8.0.103
<PackageReference Include="Microsoft.NET.Build.Containers" Version="8.0.103" />
paket add Microsoft.NET.Build.Containers --version 8.0.103
#r "nuget: Microsoft.NET.Build.Containers, 8.0.103"
// Install Microsoft.NET.Build.Containers as a Cake Addin #addin nuget:?package=Microsoft.NET.Build.Containers&version=8.0.103 // Install Microsoft.NET.Build.Containers as a Cake Tool #tool nuget:?package=Microsoft.NET.Build.Containers&version=8.0.103
.NET SDK Containers
This package lets you build container images from your projects with a single command.
Getting Started
To build a container from the SDK, add this package and run the publish
command,
specifying the DefaultContainer
PublishProfile. You can learn more about Publish Profiles in the documentation.
>dotnet add package Microsoft.NET.Build.Containers
>dotnet publish --os linux --arch x64 -p:PublishProfile=DefaultContainer
...
Pushed container '<your app name>:<your app version>' to registry 'docker://'
...
Out of the box, this package will infer a number of properties about the generated container image, including which base image to use, which version of that image to use, and where to push the generated image. You have control over all of these properties, however. You can read more about these customizations here.
Note: This package only supports Web projects (those that use the Microsoft.NET.Sdk.Web
SDK) in this version.
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- No dependencies.
NuGet packages (5)
Showing the top 5 NuGet packages that depend on Microsoft.NET.Build.Containers:
Package | Downloads |
---|---|
UtilityBelt.Server
UBNet server. |
|
IPP.PORTIC.SAFHE.Library
This software regards the project number 070200, SAFHE - Safe Health Elderly Monitoring, an EU funded project, and constitutes the technical contribution of the PORTIC-IPP together with the ESS-IPP (specifically both entities PORTIC - Porto Research, Technology and Innovation Center, and ESS - Escola Superior de Saúde, both sub-entities from the institution IPP - Instituto Politécnico do Porto) to the project.! The url of the project is: https://www.portic.ipp.pt/project.html |
|
MultiChannelReportLog-ex-1
Package Description |
|
SotracomEntities
Package Description |
|
SotracomEntities_2024
Package Description |
GitHub repositories (5)
Showing the top 5 popular GitHub repositories that depend on Microsoft.NET.Build.Containers:
Repository | Stars |
---|---|
microsoft/dotnet-podcasts
.NET reference application shown at .NET Conf featuring ASP.NET Core, Blazor, .NET MAUI, Microservices, Orleans, Playwright, and more!
|
|
asynkron/protoactor-dotnet
Proto Actor - Ultra fast distributed actors for Go, C# and Java/Kotlin
|
|
mehdihadeli/food-delivery-microservices
🍔 A practical and imaginary food delivery microservices, built with .Net 8, MassTransit, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
|
|
rstropek/Samples
|
|
richlander/container-workshop
Documents fundamental .NET Container workflows
|
Version | Downloads | Last updated | |
---|---|---|---|
9.0.100 | 2,017 | 11/12/2024 | |
9.0.100-rc.2.24474.11 | 319 | 10/8/2024 | |
9.0.100-rc.1.24452.12 | 178 | 9/10/2024 | |
9.0.100-preview.7.24407.12 | 185 | 8/13/2024 | |
9.0.100-preview.6.24328.19 | 164 | 7/9/2024 | |
9.0.100-preview.5.24307.3 | 393 | 6/11/2024 | |
9.0.100-preview.4.24267.43 | 207 | 5/21/2024 | |
9.0.100-preview.3.24204.14 | 258 | 4/11/2024 | |
9.0.100-preview.2.24157.36 | 266 | 3/12/2024 | |
9.0.100-preview.1.24101.1 | 1,110 | 2/13/2024 | |
8.0.404 | 1,587 | 11/12/2024 | |
8.0.403 | 11,867 | 10/8/2024 | |
8.0.402 | 3,314 | 9/24/2024 | |
8.0.401 | 18,730 | 8/15/2024 | |
8.0.400 | 2,004 | 8/13/2024 | |
8.0.307 | 130 | 11/12/2024 | |
8.0.306 | 199 | 10/8/2024 | |
8.0.304 | 212 | 8/13/2024 | |
8.0.303 | 10,981 | 7/9/2024 | |
8.0.302 | 12,336 | 6/11/2024 | |
8.0.301 | 3,355 | 5/28/2024 | |
8.0.300 | 9,332 | 5/14/2024 | |
8.0.206 | 218 | 5/28/2024 | |
8.0.205 | 263 | 5/14/2024 | |
8.0.204 | 27,950 | 4/9/2024 | |
8.0.202 | 16,837 | 3/12/2024 | |
8.0.200 | 33,008 | 2/13/2024 | |
8.0.111 | 129 | 11/12/2024 | |
8.0.110 | 183 | 10/8/2024 | |
8.0.108 | 218 | 8/13/2024 | |
8.0.107 | 238 | 7/9/2024 | |
8.0.106 | 254 | 5/28/2024 | |
8.0.105 | 225 | 5/14/2024 | |
8.0.104 | 319 | 4/9/2024 | |
8.0.103 | 338 | 3/12/2024 | |
8.0.102 | 414 | 2/13/2024 | |
8.0.101 | 40,092 | 1/9/2024 | |
8.0.100 | 69,181 | 11/14/2023 | |
8.0.100-rc.2.23480.5 | 2,140 | 10/10/2023 | |
8.0.100-rc.1.23462.41 | 1,175 | 9/14/2023 | |
8.0.100-rc.1.23455.21 | 610 | 9/12/2023 | |
8.0.100-preview.7.23376.5 | 1,306 | 8/8/2023 | |
8.0.100-preview.6.23330.7 | 1,184 | 7/11/2023 | |
8.0.100-preview.5.23303.1 | 1,123 | 6/13/2023 | |
8.0.100-preview.4.23260.11 | 1,094 | 5/16/2023 | |
7.0.410 | 11,649 | 5/28/2024 | |
7.0.409 | 904 | 5/14/2024 | |
7.0.408 | 2,038 | 4/9/2024 | |
7.0.407 | 2,336 | 3/12/2024 | |
7.0.406 | 5,466 | 2/13/2024 | |
7.0.405 | 23,971 | 1/9/2024 | |
7.0.404 | 22,168 | 11/14/2023 | |
7.0.403 | 34,221 | 10/24/2023 | |
7.0.402 | 17,075 | 10/10/2023 | |
7.0.401 | 54,550 | 9/12/2023 | |
7.0.400 | 124,070 | 8/8/2023 | |
7.0.317 | 211 | 5/28/2024 | |
7.0.316 | 232 | 5/14/2024 | |
7.0.315 | 346 | 4/9/2024 | |
7.0.314 | 340 | 3/12/2024 | |
7.0.313 | 372 | 2/13/2024 | |
7.0.312 | 346 | 1/9/2024 | |
7.0.311 | 793 | 11/14/2023 | |
7.0.310 | 454 | 10/24/2023 | |
7.0.309 | 493 | 10/10/2023 | |
7.0.308 | 529 | 9/12/2023 | |
7.0.307 | 7,717 | 8/8/2023 | |
7.0.306 | 46,949 | 7/11/2023 | |
7.0.305 | 33,108 | 6/22/2023 | |
7.0.304 | 15,682 | 6/13/2023 | |
7.0.302 | 70,003 | 5/16/2023 | |
0.4.0 | 198,029 | 3/22/2023 | |
0.3.2 | 181,652 | 1/20/2023 | |
0.2.7 | 150,564 | 10/27/2022 | |
0.1.8 | 14,800 | 8/25/2022 |
# Microsoft.NET.Build.Containers 8.0.100
This version brings the following new features and enhancements:
* For .NET 8-targeting applications, the generated container user will not have root permissions by default. This is a breaking change from previous versions, but it is a more secure default. If you need to run your container as root, you can set the `ContainerUser` property to `root` in your project file. Note also that in .NET 8 several changes were made to the Microsoft .NET base images, like changing the default ASP.NET port to 8080, so applications newly-targeting .NET may have to adjust to these settings.
* Generated container images now default to using the `latest` tag instead of the value of the MSBuild `Version` property, to align with other container tooling. You can still override this behavior by setting the `ContainerTag` property in your project file.
* The `ContainerFamily` property was added to support choosing from different variants of image tags without needing to specify the entire base image. For example, to target Alpine Linux you can now set `ContainerFamily` to `alpine`.
* The generated images will now correctly set `User` and `ExposedPort` metadata based on well-known .NET Environment variables for these settings.
* We now support using base images that set `Entrypoint` instead of `Cmd`. The previous `ContainerEntrypoint` and `ContainerEntrypointArgs` properties are still supported, but will log a warning when used. You should now use `ContainerAppCommand` and `ContainerAppCommandArgs` instead to set the desired start application - these properties allow the tooling to select the proper app start command based on the base images' use of Entrypoint or Cmd. Thanks to @tmds for this functionality!
* We explicitly support using podman as a local destination for your containers. If `podman` is present on the system and `docker` is not, we will opt to use `podman` instead. If you'd like to make this behavior explicit you can set `LocalRegistry` to either `docker` or `podman`. Thanks to @tmds for this contribution!
* Permissions for files in the images not don't have the executable bit set unless it is necessary.
* Support for authenticating using Identity Token flows was added. This unblocks support for Azure Managed Identities, as well as all other registries where the result of `docker login <registry url>` is an Identity Token instead of an Access Token or Username/Password pair.