vagrant-delphix

vagrant-delphix is a vagrant provisioner plugin that supports the management of Delphix environments.

Features include:

• create Delphix environments from a virtual machine
• disable environments and containers (dSource or VDB) when the virtual machine is stopped or suspended
• delete environments and containers when the virtual machine is destroyed

The provisioner supports the lifecycle of a vagrant box by creating an environment in Delphix when the virtual machine is provisioned (vagrant up), it disables the environment when the virtual machine is shutdown (vagrant halt) and deletes the environment when the virtual machine is destroyed (vagrant destroy).

The provisioner stops active containers (VDBs or dSources) and disables them when the virtual machine is shutdown. They remain stopped and disabled when the virtual machine is restarted !

WARNING

Destroying the virtual machine deletes all VDBs and dSources that are provisioned on the virtual machine !!

Installation

Install the provisioner plugin using the Vagrant command-line interface:

$ vagrant plugin install vagrant-delphix

Configuration

Once the provider has been installed, you will need to configure your project to use it. The most basic Vagrantfile to create a Delphix environment is shown below:

# global config of the delphix provisioner

config.delphix.enabled = true # false by default
config.delphix.engine_url = DELPHIX_ENGINE_URL
config.delphix.engine_user = 'delphix engine username'
config.delphix.engine_password = 'delphix engine password'
config.delphix.trace = true # logs Delphix Engine API request/responses, false by default

# configure the environment

config.vm.define "source" do |node|
  node.delphix.env_name = 'source'
  node.delphix.env_ip = public_ipv4
  node.delphix.env_port = 22 # optional, 22 by default
  node.delphix.user = 'delphix user name'
  node.delphix.password = 'delphix user password'
  node.delphix.toolkit_path = 'path to toolkit location'
end

Contributing to vagrant-delphix

• Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet.
• Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright © 2016 Michael Kuehl. See LICENSE.txt for
further details.