Expanded Plugin Documentation
DivvyCloud supports extension via a comprehensive plugin system. Customers can add new content and workflows to support their unique requirements by writing their own extensions. This capability requires access to our source code and is only available to customers. Reach out to [email protected] for access to both the repo and the additional documentation and instructions surrounding plugins.
Plugins are Python packages that are loaded when a DivvyCloud process starts. These are primarily used for registering custom filters and packaging frontend assets to extend the user interface.
To install, simply copy the plugin directory to the plugins folder and it will be automatically be loaded into the software when the process starts.
dev-box$ cp -r plugin_instance_type_blacklist plugins/ dev-box$ ls -alh plugins/ total 48 drwxr-xr-x 9 cderamus staff 306B Sep 12 07:57 . drwxr-xr-x 74 cderamus staff 2.5K Sep 12 07:27 .. -rw-r--r-- 1 cderamus staff 2.0K Sep 12 07:57 plugin_instance_type_blacklist
docker-compose deployments, the location of the
plugins folder on your local filesystem is defined by mounting it as
./plugins inside the container. In our recommended
docker-compose.yaml, this folder is named
plugins and in the same directory as
docker-compose.yaml, as defined by the
volumes: directive here:
volumes: - ./plugins:/plugins
To remove a plugin from the system you can either remove the file from the plugins folder or simply delete the directory permanently. The snippet below illustrates the removal of the example plugin from the example section.
dev-box$ rm -rf plugins/plugin_instance_type_blacklist dev-box$ ls -alh plugins/ total 48 drwxr-xr-x 9 cderamus staff 306B Sep 12 07:57 . drwxr-xr-x 74 cderamus staff 2.5K Sep 12 07:27 ..
Simply copy/rsync your updates into the plugin directory and restart all processes.
Updated 4 months ago