DotNetNuke.BulkInstall 10.4.0-rc.1

DNN Platform

Bulk Install

Deploy Client

Bulk Install is an extension for DNN Platform which supports installing many extension packages at once. For Continuous Deployment scenarios, this Deploy Client can be used to remotely install packages via the extension's API.

Examples

Installation

Install the Deploy Client as a global NuGet tool during deployment:

dotnet tool install --global DotNetNuke.BulkInstall;

Alternatively, install the Deploy Client as a local tool:

dotnet new tool-manifest;
dotnet tool install DotNetNuke.BulkInstall;

During deployment, restore local tools using the following command:

dotnet tool restore;

Usage

In order to do a deployment, the Deploy Client needs the following information:

• --target-uri: The URL of the site to which the packages will be deployed (HTTPS is required unless --legacy-api is used)
• --api-key: The API key associated with the Bulk Install API user
• --encryption-key: The encryption key associated with the Bulk Install API user
• --packages-directory: A folder with packages. If not supplied, uses the current working directory.

For local development with a self-signed HTTPS certificate, add --allow-untrusted-certificates.

A typical basic example could look something like this:

dotnet tool run dnn-bulkinstall --target-uri https://dnn.example.com --api-key abc123 --encryption-key zyx789;

An example specifying all the options could look like this:

dotnet tool run dnn-bulkinstall --target-uri https://dnn.example.com --api-key abc123 --encryption-key zyx789 --packages-directory ./Install/ --recurse --log-level Trace --installation-status-timeout 120;

For local development with a self-signed certificate:

dotnet tool run dnn-bulkinstall --target-uri https://dnndev.loc --api-key abc123 --encryption-key zyx789 --allow-untrusted-certificates;

Finally, the Deploy Client also supports the older PolyDeploy extension, using the --legacy-api argument.