foreman-ovm enables provisioning and managing of Oracle VM instances in Foreman, all of that under the GPL v3+ license.
- Website: TheForeman.org
- ServerFault tag: Foreman
- Issues: foreman-ovm Github Issues
- Wiki: Foreman wiki
- Community and support: #theforeman for general support, #theforeman-dev for development chat in Freenode
- Mailing lists:
This gem is likely broken until version 0.1.x. It is currently undergoing heavy development
Please see the Foreman manual for appropriate instructions:
Set up the repo as explained in the link above, then run
# yum install ruby193-rubygem-foreman_ovm
Set up the repo as explained in the link above, then run
# apt-get install ruby-foreman-ovm
Add the following to bundler.d/Gemfile.local.rb in your Foreman installation directory (/usr/share/foreman by default)
$ gem 'foreman_ovm'
Then run bundle install from the same directory
To verify that the installation was successful, go to Foreman, top bar Administer > About and check 'foreman_ovm' shows up in the System Status menu under the Plugins tab.
| Foreman Version | Plugin Version |
|---|---|
| >= 1.13.0 | ~> 0.0.2 |
Go to Infrastructure > Compute Resources and click on "New Compute Resource".
Choose the OVM provider, and fill in all the fields. You need a service account with read and write access. It will be encrypted in the database.
That's it. You're now ready to create and manage droplets in your new OVM compute resource.
You should see something like this in the Compute Resource page:
Generally, follow the Foreman guidelines. For code-related contributions, fork this project and send a pull request with all changes. Some things to keep in mind:
- Follow the rules about commit message style and create a Redmine issue. Doing this right will help reviewers to get your contribution merged faster.
- Rubocop will analyze your code, you can run it locally with
rake rubocop. - All of our pull requests run the full test suite in our Jenkins CI system. Please include tests in your pull requests for any additions or changes in functionality
You can get the nightly branch of the plugin by specifying your Gemfile in this way:
gem 'foreman_ovm', :git => "https://github.com/mattwilmott/foreman-ovm.git"
It is licensed as GPLv3 since it is a Foreman plugin.
See LICENSE for more details.