Enabling plugin multiplexing

You must enable plugin multiplexing to allow multiple integrations that use the same plugin type and version to share a pod, which can reduce the number of pods required for plugin executions. By default, plugin multiplexing is enabled for the DevOps Plan, DevOps Deploy, DevOps Build, and DevOps Control plugins. You can update the list of multiplexed plugin types in the values.yaml file.

Before you begin

  • You must have access to the values.yaml file for Velocity.
  • You must have permission to modify the installation configuration and redeploy or upgrade the installation after you make the change.

About this task

The multiplexedPlugins configuration in the values.yaml file controls plugin multiplexing. This configuration specifies the plugin types for which integrations can run in multiplexed mode.

By default, plugin multiplexing is enabled for the DevOps Plan, DevOps Deploy, DevOps Build, and DevOps Control plugins. To change the default set of multiplexed plugins, you must update the multiplexedPlugins value.

Procedure

  1. Open the values.yaml file for your Velocity installation.
  2. Locate the multiplexedPlugins configuration.

    The configuration contains a comma-separated list of plugin types that run in multiplexed mode.

  3. Set multiplexedPlugins to the plugin types that you want to run in multiplexed mode.

    For example: 

    
                        multiplexedPlugins: "ucv-ext-compass,ucv-ext-control,ucv-ext-build,ucv-ext-ucd,ucv-ext-launch"
  4. Save the values.yaml file.
  5. Redeploy or upgrade the installation to apply the updated configuration.
    Note:
    The updated configuration takes effect after the installation successfully redeploys or upgrades.
  6. Verify that the configured plugin types run in multiplexed mode.
  7. Check the plugin logs.
  8. When a plugin runs in multiplexed mode, the first line in the plugin logs displays the following message: 
    Running plugin in multiplexing mode...

    If this message is displayed as the first line in the plugin logs, the plugin runs in multiplexed mode.

  9. Search the plugin logs by using the integration ID to view information for an individual integration.

    The logs currently contain execution logs for all integrations that use the same plugin type and version. The logs do not separate execution information by integration. To view the execution status of a specific integration or investigate a failure for that integration, search the logs by using the integration ID.

Results

Plugin multiplexing is enabled for the plugin types specified in multiplexedPlugins.

What to do next

If you need to change the default sync interval for a plugin type, you must disable all active integrations that use the plugin type. Then you must modify the sync interval on one integration, and then enable the remaining integrations. The updated sync interval is automatically applied to all integrations that use the same plugin type and version.

Note:

You cannot configure different sync intervals for different integrations that use the same plugin type and version when the integrations run in multiplexed mode.