The Virtualization SDK is a Python package on PyPI. Install it in your local development environment so that you can build and upload a plugin.
The SDK consists of three parts:
- A CLI
The platform and libs modules expose objects and methods needed to develop a plugin. The CLI is used to build and upload a plugin.
- macOS 10.14+, Ubuntu 16.04+, or Windows 10
- Python 2.7 (Python 3 is not supported)
- Java 7+
- Delphix Engine 22.214.171.124 or above
To install the latest version of the SDK run:
$ pip install dvp
Use a Virtual Environment
We highly recommended that you develop plugins inside of a virtual environment. To learn more about virtual environments, refer to Virtualenv's documentation.
The virtual environment needs to use Python 2.7. This is configured when creating the virtualenv:
$ virtualenv -p /path/to/python2.7/binary ENV
To install a specific version of the SDK run:
$ pip install dvp==<version>
To upgrade an existing installation of the SDK run:
$ pip install dvp --upgrade
API Build Version
The version of the SDK defines the version of the Virtualization Platform API your plugin will be built against.
Our CLI reference describes commands, provides examples, and a help section.
To build your plugin:
$ dvp build -c <plugin_config> -a <artifact_file>
This will generate an upload artifact at
<artifact_file>. That file can then be uploaded with:
$ dvp upload -e <delphix_engine_address> -u <delphix_admin_user> -a <artifact_file>
You will be prompted for the Delphix Engine user's password.