Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Python Makefile Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Dwarf ===== In a nutshell, dwarf is OpenStack API on top of local libvirt/KVM. It supports a subset of the Keystone, Glance and Nova APIs to manage images and instances on the local machine. Restrictions ------------ Lots :-) It only supports a subset of the OpenStack API and it currently doesn't do user authentication. Meaning everybody who can log into the machine can manipulate all images and instances managed through dwarf. Everything is serialized and blocking. All calls to dwarf will be served in the order they're received and only return after they've finished. There's no scheduling and background processing. Configuration ------------- After installation, check that the settings in '/etc/dwarf.conf' match your environment. You need to restart dwarf if you make any modifications: $ sudo initctl restart dwarf Set the OpenStack environment variables (modify the port number accordingly, if you changed it in the config file): $ export OS_AUTH_URL=http://localhost:35357/v2.0/ $ export OS_COMPUTE_API_VERSION=1.1 $ export OS_REGION_NAME=dwarf-region $ export OS_TENANT_NAME=dwarf-tenant $ export OS_USERNAME=dwarf-user $ export OS_PASSWORD=dwarf-password Supported OpenStack CLI commands -------------------------------- At the moment, the following commands are supported: keystone token-get keystone catalog glance image-create glance image-delete glance image-list glance image-show glance image-update nova flavor-create nova flavor-delete nova flavor-list nova flavor-show nova image-list nova image-show nova keypair-add nova keypair-delete nova keypair-list nova keypair-show nova boot nova console-log nova delete nova list nova reboot nova show Notes ----- Default compute flavors are automatically added, check them with: $ nova flavor-list Before you can boot an instance, you need to add an image and a keypair: $ nova keypair-add <key name> $ glance image-create --name 'My Image Name' --file <image filename> When booting an instance, the instance will receive a DHCP IP address from libvirt's dnsmasq. It takes a bit until that happens, check the status with: $ nova show <instance ID or name> Debugging --------- Check the log at /var/lib/dwarf/dwarf.log.