A tool to promote NuGet packages and their dependencies from one feed to another.
The promote command promotes a set of packages from one feed to another.
The promote package command promotes the specified package from one feed to another. If --version specified, it promotes the specified version; otherwise, the latest version will be promoted.
> promote-nuget promote package --help
USAGE:
Promote.NuGet.exe promote package <id> [OPTIONS]
ARGUMENTS:
<id> Id of the package to promote
OPTIONS:
-h, --help Prints help information
-s, --source Source repository
--source-api-key Source repository's API key
-d, --destination Destination repository
--destination-api-key Destination repository's API key
--no-cache Do not use local cache
--dry-run Evaluate packages to promote, but don't actually promote them
--verbose Enable verbose logs
-v, --version Version of the package. If not specified, the most recent version will be promoted
Example:
# Promotes the latest version of a package to the specified feed.
promote-nuget promote package Newtonsoft.Json --destination '<TARGET-NUGET-FEED-URL>' --destination-api-key '<API-KEY>'
# Promotes the specified version of a package to the specified feed.
promote-nuget promote package Newtonsoft.Json --version 13.0.1 --destination '<TARGET-NUGET-FEED-URL>' --destination-api-key '<API-KEY>'The promote from-config command promotes packages specified in a configuration file from one feed to another.
In the configuration, you can specify a set of packages with a list of versions, either exact (e.g., 13.0.1) or range (e.g., [12.0.0,)).
> promote-nuget promote from-config --help
DESCRIPTION:
Promotes packages as configured in the specified file.
USAGE:
Promote.NuGet.dll promote from-config <file> [OPTIONS]
ARGUMENTS:
<file> Path to the configuraton file (in YAML format). Example:
packages:
- id: System.Runtime
versions: 4.3.1
- id: System.Text.Json
versions:
- '[6, 7)'
- '[8, 9)'
OPTIONS:
-h, --help Prints help information
-s, --source Source repository
--source-api-key Source repository's API key
-d, --destination Destination repository
--destination-api-key Destination repository's API key
--no-cache Do not use local cache
--dry-run Evaluate packages to promote, but don't actually promote them
--verbose Enable verbose logs
--always-resolve-deps Always resolve dependencies of a package, even if the package itself
exists in the destination repository. This option allows to restore
the integrity of the destination repository by promoting missing
dependencies
--force-push Push packages and their dependencies even if they already exist in the
destination repository. Use that option to restore the integrity of
the destination repository (i.e. when some packages in the feed are
broken)
Example:
# packages:
# - id: System.Globalization
# versions: 4.3.0
# - id: System.Runtime
# versions:
# - '[4.1.0,4.1.2)'
# - 4.3.1
promote-nuget promote from-config packages.yml --destination '<TARGET-NUGET-FEED-URL>' --destination-api-key '<API-KEY>'
# Resolving package requests:
# ├── System.Globalization (= 4.3.0)
# └── System.Runtime (>= 4.1.0 && < 4.1.2), (= 4.3.1)
# Matching packages for System.Globalization (= 4.3.0): 4.3.0
# Matching packages for System.Runtime (>= 4.1.0 && < 4.1.2), (= 4.3.1): 4.1.0, 4.1.1, 4.3.1
# Resolving packages to promote:
# ├── System.Globalization 4.3.0
# ├── System.Runtime 4.1.0
# ├── System.Runtime 4.1.1
# └── System.Runtime 4.3.1
# Processing package System.Globalization 4.3.0
# New dependency to process: Microsoft.NETCore.Platforms (>=
# 1.1.0)
# New dependency to process: Microsoft.NETCore.Targets (>=
# 1.1.0)
# New dependency to process: System.Runtime (>= 4.3.0)
# ... skipped ...
# Found 13 package(s) to promote:
# ├── Microsoft.NETCore.Platforms 1.0.1
# ├── Microsoft.NETCore.Platforms 1.0.2
# ├── Microsoft.NETCore.Platforms 1.1.0
# ├── Microsoft.NETCore.Platforms 1.1.1
# ├── Microsoft.NETCore.Targets 1.0.1
# ├── Microsoft.NETCore.Targets 1.0.6
# ├── Microsoft.NETCore.Targets 1.1.0
# ├── Microsoft.NETCore.Targets 1.1.3
# ├── System.Globalization 4.3.0
# ├── System.Runtime 4.1.0
# ├── System.Runtime 4.1.1
# ├── System.Runtime 4.3.0
# └── System.Runtime 4.3.1
# (1/13) Promote Microsoft.NETCore.Platforms 1.0.1
# (2/13) Promote Microsoft.NETCore.Platforms 1.0.2
# (3/13) Promote Microsoft.NETCore.Platforms 1.1.0
# (4/13) Promote Microsoft.NETCore.Platforms 1.1.1
# (5/13) Promote Microsoft.NETCore.Targets 1.0.1
# (6/13) Promote Microsoft.NETCore.Targets 1.0.6
# (7/13) Promote Microsoft.NETCore.Targets 1.1.0
# (8/13) Promote Microsoft.NETCore.Targets 1.1.3
# (9/13) Promote System.Globalization 4.3.0
# (10/13) Promote System.Runtime 4.1.0
# (11/13) Promote System.Runtime 4.1.1
# (12/13) Promote System.Runtime 4.3.0
# (13/13) Promote System.Runtime 4.3.1
# 13 package(s) promoted.You can use --help argument to find all available commands and options. Example:
> promote-nuget promote --help
DESCRIPTION:
Promote packages and their dependencies from one feed to another.
USAGE:
Promote.NuGet.dll promote [OPTIONS] <COMMAND>
OPTIONS:
-h, --help Prints help information
COMMANDS:
package <id> Promotes the specified package and its dependencies from one feed to another
list <file> Promotes packages listed in the specified file, and their dependencies
from-config <file> Promotes packages as configured in the specified file
- This application uses NuGet.Client libraries. These libraries are available under the Apache 2.0 license.
- This application uses FluentValidation library. The library is available under the Apache 2.0 license.