Allows Jenkins jobs to connect to the Delphix Engine
The Delphix Plugin allows Jenkins to connect to multiple Delphix Engines and execute operations on Self Service Containers and Self Service Bookmarks.
Table of Contents
- Delphix Engine Requirements
- Reporting Issues
- Statement of Support
This plugin is designed to automate routine and/or triggered jobs with Delphix Self Service Containers and Bookmarks. An example automation would be during a build phase, if some automated tests failed while running in a database, that Self Service Container could have it's current state bookmarked, and that bookmark could be shared with the rest of the team. It might also be required to refresh a development database from the production source during deployment. These are just a few examples of possible automations.
Install through Jenkins Plugin Manager or download here.
Delphix Engine v5.0.0 or higher.
After the plugin has been installed, Delphix engines will need to be connected. Go to System Configuration page, scroll down to the Delphix section. Enter your Engine Address, Username, and password, then click "Test Connection". If Jenkins is able to reach the engine and log in, you will see a "Login Successful" reply message. If you wish to add multiple engines, click the "Add Engine" button for each engine you wish to connect to Jenkins.
Self Service Container
To interact with Self Service Containers, select "Delphix - Self Service Container" from the "Add Build Step" drop down in the Build phase section. Select an engine that was configured in the global configuration, select one of the operations listed below. Depending on the operation selected, it will either depend on a specified Self Service Container or a Bookmark. Read more about Delphix Self Service Containers.
Self Service Bookmark
To interact with Self Service Bookmarks, select "Delphix - Self Service Bookmark" from the "Add Build Step" drop down in the Build phase section. Select an engine that was configured in the global configuration, select one of the operations listed below. Depending on the operation selected, it will either depend on a specified Self Service Container or a Bookmark. Read more about Delphix Self Service Bookmarks.
It is possible to share assets created between build steps. For instance, if you wanted to create a bookmark from a container and then restore a different container with the newly created bookmark. The create operation for both Self Service Containers and Bookmarks will have their output saved if the "Save to Properties" box is checked. The Self Service Container operation "restore" requires a Bookmark for reference. This Bookmark can be loaded a previous build step when "Load Bookmark from Properties" is checked. Likewise, the referenced Self Service Container in the Bookmark build step can be loaded from the properties file.
- Fork the project.
- Make your bug fix or new feature.
- Add tests for your code.
- Send a pull request.
Contributions must be signed as
User Name <email@example.com>. Make sure to set up Git with user name and email address. Bug fixes should branch from the current stable branch. New features should be based on the
This project operates under the Delphix Code of Conduct. By participating in this project you agree to abide by its terms.
All contributors are required to sign the Delphix Contributor agreement prior to contributing code to an open source repository. This process is handled automatically by cla-assistant. Simply open a pull request and a bot will automatically check to see if you have signed the latest agreement. If not, you will be prompted to do so as part of the pull request process. Read the full Delphix Contributor License Agreement.
Please submit bug reports, suggestions and pull requests to the GitHub issue tracker.
This software is provided as-is, without warranty of any kind or commercial support through Delphix. See the associated license for additional details. Questions, issues, feature requests, and contributions should be directed to the community as outlined in the Delphix Community Guidelines.
This is code is licensed under the Apache License 2.0. Full license is available here.