0.01
No commit activity in last 3 years
No release in over 3 years
Knife plugin to manage OpenNebula VMs
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 11.0
>= 1.26.0
 Project Readme

knife plugin for opennebula

Description

This plugin gives knife the ability to create, bootstrap, and manage OpenNebula Virtual Machines

Development

To contribute bug patches or new features, you can use the github Pull Request model. It is assumed that code and documentation are contributed under the Apache License 2.0.

More info:

Authors

Compatibility

This add-on is compatible with OpenNebula 4.4, 4.6, 4.12

Requirements

Chef

Hosted Chef 11.0.x (or) On Premises Chef (http://www.getchef.com/chef/choose-your-version/) configured with a client.

For more information about Chef

Installation

To install the plugin you need to do the following in your workstation:

  • gem install chef
  • gem install knife-opennebula

Configuration

Configuration can be done either of any three ways.

1. Configuring the ENV variables

  • export OPENNEBULA_USERNAME="MY_OPENNEBULA_USERNAME"

  • export OPENNEBULA_PASSWORD="MY_OPENNEBULA_PASSWORD"

  • export OPENNEBULA_ENDPOINT="MY_OPENNEBULA_ENDPOINT"

2. Configuring knife.rb

  • knife[:opennebula_username] = "MY_OPENNEBULA_USERNAME"

  • knife[:opennebula_password] = "MY_OPENNEBULA_PASSWORD"

  • knife[:opennebula_endpoint] = "MY_OPENNEBULA_ENDPOINT"

3. Configure while running commands by passing options

  • -A or --username -> OPENNEBULA_USERNAME
  • -K or --password -> OPENNEBULA_PASSWORD
  • -e or --endpoint -> OPENNEBULA_ENDPOINT

Specific command options can be found by invoking the subcommand with a --help flag

Usage

This plugin provides the following Knife subcommands. Specific command options can be found by invoking the subcommand with a --help flag

To list the virtual resource templates

knife opennebula template list

To list the virual machines

knife opennebula server list

To create a virtual machine by instantiating a template

knife opennebula server create

To undeploy and delete a virtual machine

knife opennebula server delete SERVER_NAME

eg:

knife opennebula template list -A OPENNEBULA_USERNAME -K OPENNEBULA_USER_PASSWORD -e http://my-opennebula.com:2633/RPC2

knife opennebula server create -A OPENNEBULA_USERNAME -K OPENNEBULA_USER_PASSWORD -e http://my-opennebula.com:2633/RPC2 -t MY_TEMPLATE_NAME -i IDENTITY_FILE -x USER -r 'role[test]' -N TEST1

knife opennebula server list -A OPENNEBULA_USERNAME -K OPENNEBULA_USER_PASSWORD -e http://my-opennebula.com:2633/RPC2

knife opennebula server delete SERVER_NAME -A OPENNEBULA_USERNAME -K OPENNEBULA_USER_PASSWORD -e http://my-opennebula.com:2633/RPC2 -P -N NODE_NAME

To launch ubuntu-precise template on opennebula host http://canvpn.megam.co.in:2633/RPC2 using private key canvpn.key and role recipe[apt] with name tom

knife opennebula server create -A oneadmin -K ephamnilnik5 -e http://canvpn.megam.co.in:2633/RPC2 -t Ubuntu-precise -i ~/canvpn.key -x root -r 'recipe[apt]' -N tom