This is an unofficial Chef Knife plugin for the Nutanix Acropolis Hypervisor. This plugin allows to collect the informations available in the Management API.

If you already downloaded ChefDK you can easily install the gem using:

$ chef gem install knife-acropolis

You can alternatively add this plugin to you normal knife plugin path (like ~/.chef/plugins/knife/) or download it natively as a gem:

$ gem install knife-acropolis

Depending on your system's configuration, you may need to run this command with root privileges.

The simplest way to test the installation is to pass your host (-H), username (-U) and password (-P) with one of the available commands:

knife acropolis ha list (options)
knife acropolis image list (options)
knife acropolis network list (options)
knife acropolis snapshot create (options)
knife acropolis snapshot delete (options)
knife acropolis snapshot list (options)
knife acropolis task list (options)
knife acropolis vdisk list (options)
knife acropolis vm clone (options)
knife acropolis vm create (options)
knife acropolis vm list (options)

You can also add the static options like host, username and password to your knife.rb configuration:

knife[:a_host] = "yourhost.com"
knife[:a_user] = "yourUsername"
knife[:a_pass] = "yourPassword"

This command shows the actual HA state of the cluster.

This command shows all images (ISO/Disk) available.

This command shows all available networks.

This command allows you to create a simple network.

This command allows you to create a snapshot using (-I) for the VM UUID (you can find with "knife acropolis vm list") and (-N) for the snapshot name. The uuid for the snapshot is auto-generated.

This command allows you to delete a snapshot using (-S) for the Snapshot UUID (you can find with "knife acropolis snapshot list").

This command shows all available snapshots in the cluster.

This command shows all the actual tasks. When using (-C) all completed tasks will be shown as well.

This command shows all available vdisks in a path. You have to use (-N) to set the NDFS path. Using "/" shows the root path.

This command shows all available virtual machines in the cluster. Adding (-S) will show them sorted by name.

This command allows to create a virtual machine.

This command allows to clone a virtual machine.

Author: Christian Johannsen (c.johannsen@clickedways.de) License: Apache License, Version 2.0