/
Packages & Plugins

Packages & Plugins

Remote Agents support the same custom device (plugin) packages as Connexion. These Nuget packages are the only way to deploy custom devices (plugins) to a set of Remote Agents, and can be built via your CI/CD pipeline, or, created via the Connexion UI.

The Gateway maintains a list of packages which can be deployed either in bulk, or to individual Remote Agents. Use the following procedure to import and deploy packages:

Import the package into the Gateway

Before a package can be deployed, it must be added to the Gateway’s packages collection. This can be done in two places:

  1. The Plugin Packages view associated with a remote agent.

    image-20250929-160433.png

  2. The Bulk Deploy Packages dialog.

    image-20250929-160611.png

     

Simply select one or more package files to make them available for deployment.

ImportPlugins.mp4

Deploy (Individual Remote Agent)

If you want to deploy one or more plugin packages to a specific Remote Agent, select that remote agent and select the Deploy Plugins view.

image-20250929-161214.png

Then select the packages you want to deploy (using ctrl or shift to multi-select). Click the right-arrow icon to push those packages to the Remote Agent. Once deployed, any existing instances of those custom device(s) will be automatically upgraded or downgraded.

DeployPackages.gif

Deployed packages are shown within the right pane. Packages can be removed from the Remote Agent by clicking the remove button, or replaced by a different version of the package by simply deploying the new version.

image-20250929-162157.png
PluginUpgrade.gif

Bulk Deploy

When deploying a new version of a package, you typically want to deploy it to all your Remote Agents (for example, to mesh with a new product release). In this case, you use the Bulk Deploy dialog.

image-20250929-181947.png

To use this dialog:

  1. Select the package to deploy from the left pane.

  2. Select the remote agents to deploy to from the right pane.

  3. Click the Deploy button.

When you select the package from the left pane, the current version of the package will be displayed beside each remote agent in the right pane (if it is deployed). A status will also be displayed which describes the action to be taken.

image-20250929-182512.png

Click the Deploy button to start the deployment process.

BulkDeploy.gif

Packages are sent to multiple remote agents concurrently.