This repository contains command-line extensions for the .NET Core CLI which make it easy to create
deployment packages (such as .zip
files, tarballs or installers) for .NET Core applications.
The following commands are already available:
dotnet tarball
- Create a.tar.gz
file for Linux and OS Xdotnet rpm
- Create a CentOS/RedHat Linux installerdotnet zip
- Create a.zip
file
These commands are currently in development:
dotnet deb
- Create a Ubuntu/Debian Linux installer
And finally these are up next:
dotnet choco
- Create a Chocolatey packagedotnet msi
- Create a Windows Installer (msi) packagedotnet pkg
- Create a macOS installer
Did we miss anything? Feel free to file a feature request, or send a PR!
Add the following entry to your .csproj
file, under the Project
node. You do not need to add all dotnet-*
entries;
only add those you are going to use.
<ItemGroup>
<PackageReference Include="Packaging.Targets" Version="0.1.1-*" />
<DotNetCliToolReference Include="dotnet-tarball" Version="0.1.1-*" />
<DotNetCliToolReference Include="dotnet-zip" Version="0.1.1-*" />
<DotNetCliToolReference Include="dotnet-rpm" Version="0.1.1-*" />
</ItemGroup>
From the command line, run dotnet rpm
, dotnet zip
or dotnet tarball
to create a .rpm
, .zip
or .tar.gz
archive of the published output of your project.
All commands take the following command line arguments:
-r
,--runtime
: Required. The target runtime has to be specified in the project file. For example,win7-x64
orubuntu.16.10-x64
.-f
,--framework
: Required. The target framework has to be specified in the project file. For example,netcoreapp1.1
ornet462
.-c
,--configuration
: Target configuration. The default for most projects is 'Debug'.---version-suffix
: Defines the value for the$(VersionSuffix)
property in the project.
If you have multiple .csproj
files in a single directory, .NET Core CLI tools don't work.
If that's the case, you can still invoke the packaging tools manually:
dotnet msbuild [your-project].csproj /t:CreateZip /p:TargetFramework=netcoreapp1.1 /p:RuntimeIdentifier=win7-x64 /p:Configuration=Release