dotnet-subset is a .NET tool that copies a subset of files from a repository to a directory. The tool is mainly used in Dockerfiles to optimize the docker build caching for "dotnet restore" instructions.
$ dotnet add package dotnet-subsetdotnet-subset is a .NET tool that copies a subset of files from a repository to a directory.
The tool is mainly used in Dockerfiles to optimize the docker build caching for "dotnet restore" instructions.
To learn more about the motivation behind dotnet-subset, please read the related blog post.
dotnet-subset also supports custom NuGet configuration filepath defined in the project's csproj.NuGetLockFilePath property. See https://learn.microsoft.com/en-us/nuget/consume-packages/package-references-in-project-files#lock-file-extensibility.dotnet tool install --global dotnet-subset
Prerequisite: .NET SDK 2.1 or newer
dotnet pack --configuration Release --version-suffix localdotnet tool update dotnet-subset --global --prerelease --add-source ./artifacts/Release/nupkg/dotnet-subset/Description:
Create a subset for the restore operation.
Usage:
dotnet-subset restore <projectOrSolution> [options]
Arguments:
<projectOrSolution> Project or solution to restore.
Options:
--root-directory <root-directory> (REQUIRED) Directory from where the files will be copied, usually the
repository's root.
--output <output> (REQUIRED) Directory where the subset files will be copied,
preserving the original hierarchy.
-?, -h, --help Show help and usage information
Example with a project:
dotnet subset restore /source/complexapp/complexapp.csproj --root-directory /source/ --output /tmp/restore_subset/
Example with a solution:
dotnet subset restore /source/complexapp.sln --root-directory /source/ --output /tmp/restore_subset/
Please check these pull requests to see how to use dotnet-subset in your Dockerfile:
Copyright © Nimbleways, Othmane Kinane and contributors.
dotnet-subset is provided as-is under the MIT license. For more information see LICENSE.