This document describes the functionality provided by the xlr-nuget-trigger-plugin.

See the XL Release Documentation for background information on XL Release and release concepts.

This plugin is a XL Release plugin that enables triggering new releases based on a new NuGet package version showing up in your NuGet server.

• This plugin requires XLR 6.0.x+
• This plugins uses the NuGet v2 API and has no support for v1 or v3

Place the latest released version under the plugins subdirectory in the XL Release installation directory.

• Go to Settings > Shared configuration and click Add Server under Nuget: Server
• Enter the URL in the URL field, for example https://www.nuget.org for the public NuGet server.
• You can enter your API Key if it's required for your organization. Generally, read only access doesn't require an API Key.
• Username/password is very uncommon, but your organization might have implemented it.
• You can enter a 'test package' to search for and click Test. You will get feedback if XL Release could retrieve the latest version for that package.
• Don't forget to click Save before you leave.

See here for the generic trigger documentation. This plugin allows you to specify the Package ID as input and it provides the variable packageVersion for the triggered release.

Once you have all prerequisies, run ./gradlew runDockerCompose to spin up an XL Release conainer with this plugin (+ test data loaded).

Now open up XL Release (see docker-compose.yml which port, but at time of writing localhost:15516) go into Design > Templates, find the registry-triggered-template and click on it, navigate to Triggers in the white dropdown (renders default with 'Release Flow').

For NuGet Server docs and commands, see here