b5835060ca
Just runs `tests/basic_test.sh -m` without building the snap first. Useful for when you want to re-run the basic_test to verify that a sporadic issue has been fixed, without rebuilding the snap each time. Counterargument: you could always just run `tests/basic_test.sh -m` on its own. I find it easier to keep one test command in my fingers, however, rather than having to switch between "tox plus args" and "something else plus args" Change-Id: I5ec28864ed41a4e11726df8aee1d31b8ef097f03 |
||
|---|---|---|
| patches | ||
| snap/hooks | ||
| snap-overlay | ||
| snap-wrappers | ||
| tests | ||
| tools | ||
| .gitignore | ||
| .gitreview | ||
| .zuul.yaml | ||
| CONTRIBUTING.md | ||
| DEMO.md | ||
| README.md | ||
| snapcraft.yaml | ||
| test-requirements.txt | ||
| tox.ini | ||
README.md
microstack
OpenStack in a snap that you can run locally on a single machine!
microstack currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services.
Installation
microstack is frequently updated to provide the latest stable updates of the most recent OpenStack release. The quickest was to get started is to install directly from the snap store. You can install microstack using:
sudo snap install microstack --classic --candidate
Quickstart
To quickly configure networks and launch a vm, run
sudo microstack.init
This will configure various Openstack databases. Then run:
microstack.launch.
This will launch an instance for you, and make it available to manage via the command line, or via the Horizon Dashboard.
To access the Dashboard, visit http://10.20.20.1 in a web browser, and login with the following credentials:
username: admin
password: keystone
To ssh into the instance, use the username "cirros" and the ssh key written to ~/.ssh/id_microstack:
ssh -i ~/.ssh/id_microstack cirros@<IP> (Where 'IP' is listed in the output of microstack.launch)
To run openstack commands, run microstack.openstack <some command>
For more detail and control, read the rest of this README. :-)
Accessing OpenStack
microstack provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the microstack prefix:
microstack.openstack server list
You can setup this command as an alias for openstack if you wish (removing the need for the microstack. prefix):
sudo snap alias microstack.openstack openstack
Alternatively you can access the Horizon OpenStack dashboard on http://127.0.0.1 with the following credentials:
username: admin
password: keystone
Booting and accessing an instance
microstack comes preconfigured with networking and images so you can get starting using OpenStack as soon as microstack is installed; to boot an instance:
microstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-microstack-server
To access the instance, you'll need to assign it a floating IP address:
ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external`
microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP
and as you would expect, microstack is just like a full OpenStack Cloud and does not allow ingress access to the instance by default, so next enable SSH and ping access to the instance:
SECGROUP_ID=`microstack.openstack security group list --project admin -f value -c ID`
microstack.openstack security group rule create $SECGROUP_ID --proto tcp --remote-ip 0.0.0.0/0 --dst-port 22
microstack.openstack security group rule create $SECGROUP_ID --proto icmp --remote-ip 0.0.0.0/0
once this is complete you should be able to SSH to the instance:
ssh cirros@$ALLOCATED_FIP
Happy microstacking!
Stopping and starting microstack
You may wish to temporarily shutdown microstack when not in use without un-installing it.
microstack can be shutdown using:
sudo snap disable microstack
and re-enabled latest using:
sudo snap enable microstack
Raising a Bug
Please report bugs to the microstack project on launchpad: https://bugs.launchpad.net/microstack