dotnet-installer/Documentation/manpages/sdk/dotnet-nuget-push.1

95 lines
3.2 KiB
Groff
Raw Normal View History

2018-03-30 15:45:24 +00:00
.\" Automatically generated by Pandoc 2.1.3
.\"
.TH "dotnet nuget push command \- .NET Core CLI" "1" "" "" ".NET Core"
.hy
.SH dotnet nuget push
.PP
.SH NAME
.PP
\f[C]dotnet\ nuget\ push\f[] \- Pushes a package to the server and publishes it.
.SH SYNOPSIS
.PP
\f[C]dotnet\ nuget\ push\ [<ROOT>]\ [\-s|\-\-source]\ [\-ss|\-\-symbol\-source]\ [\-t|\-\-timeout]\ [\-k|\-\-api\-key]\ [\-sk|\-\-symbol\-api\-key]\ [\-d|\-\-disable\-buffering]\ [\-n|\-\-no\-symbols]\ [\-\-force\-english\-output]\ [\-h|\-\-help]\f[]
.SH DESCRIPTION
.PP
The \f[C]dotnet\ nuget\ push\f[] command pushes a package to the server and publishes it.
The push command uses server and credential details found in the system's NuGet config file or chain of config files.
For more information on config files, see Configuring NuGet Behavior.
NuGet's default configuration is obtained by loading \f[I]%AppData%.config\f[] (Windows) or \f[I]$HOME/.local/share\f[] (Linux/macOS), then loading any \f[I]nuget.config\f[] or \f[I].nuget.config\f[] starting from the root of drive and ending in the current directory.
.SS Arguments
.PP
\f[C]ROOT\f[]
.PP
Specifies the file path to the package to be pushed.
.SH OPTIONS
.PP
\f[C]\-h|\-\-help\f[]
.PP
Prints out a short help for the command.
.PP
\f[C]\-s|\-\-source\ <SOURCE>\f[]
.PP
Specifies the server URL.
This option is required unless \f[C]DefaultPushSource\f[] config value is set in the NuGet config file.
.PP
\f[C]\-\-symbol\-source\ <SOURCE>\f[]
.PP
Specifies the symbol server URL.
.PP
\f[C]\-t|\-\-timeout\ <TIMEOUT>\f[]
.PP
Specifies the timeout for pushing to a server in seconds.
Defaults to 300 seconds (5 minutes).
Specifying 0 (zero seconds) applies the default value.
.PP
\f[C]\-k|\-\-api\-key\ <API_KEY>\f[]
.PP
The API key for the server.
.PP
\f[C]\-\-symbol\-api\-key\ <API_KEY>\f[]
.PP
The API key for the symbol server.
.PP
\f[C]\-d|\-\-disable\-buffering\f[]
.PP
Disables buffering when pushing to an HTTP(S) server to decrease memory usage.
.PP
\f[C]\-n|\-\-no\-symbols\f[]
.PP
Doesn't push symbols (even if present).
.PP
\f[C]\-\-force\-english\-output\f[]
.PP
Forces all logged output in English.
.SH EXAMPLES
.PP
Pushes \f[I]foo.nupkg\f[] to the default push source, providing an API key:
.PP
\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-k\ 4003d786\-cc37\-4004\-bfdf\-c4f3e8ef9b3a\f[]
.PP
Push \f[I]foo.nupkg\f[] to the custom push source \f[C]http://customsource\f[], providing an API key:
.PP
\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-k\ 4003d786\-cc37\-4004\-bfdf\-c4f3e8ef9b3a\ \-s\ http://customsource/\f[]
.PP
Pushes \f[I]foo.nupkg\f[] to the default push source:
.PP
\f[C]dotnet\ nuget\ push\ foo.nupkg\f[]
.PP
Pushes \f[I]foo.symbols.nupkg\f[] to the default symbols source:
.PP
\f[C]dotnet\ nuget\ push\ foo.symbols.nupkg\f[]
.PP
Pushes \f[I]foo.nupkg\f[] to the default push source, specifying a 360 second timeout:
.PP
\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-\-timeout\ 360\f[]
.PP
Pushes all \f[I].nupkg\f[] files in the current directory to the default push source:
.PP
\f[C]dotnet\ nuget\ push\ *.nupkg\f[]
.PP
Pushes all \f[I].nupkg\f[] files in the current directory to the default push source, specifying a custom config file \f[I]./config/My.Config\f[]:
.PP
\f[C]dotnet\ nuget\ push\ *.nupkg\ \-\-config\-file\ ./config/My.Config\f[]
.SH AUTHORS
karann\-msft.