Pete Vander Giessen
Added build-environment to qemu (works around issue where patchelf was not finding libs). Added hack to force wrapping of all non bash apps, to work around snapd issue with multiple instances of PATH in the snap environment. Also snuck in fix for horizon build. Horizon is specified in upstream constraints now, which means that our build fails if we try to build it from source in the same part that looks at the constriants file. Misc fixes to make the tests nicer. Change-Id: I50c88878c4f9dbb07006cab899a717e334be07d0
|2 years ago|
|patches||2 years ago|
|snap/hooks||2 years ago|
|snap-overlay||2 years ago|
|snap-wrappers||2 years ago|
|tests||2 years ago|
|tools||2 years ago|
|.gitignore||2 years ago|
|.gitreview||2 years ago|
|.zuul.yaml||2 years ago|
|CONTRIBUTING.md||2 years ago|
|DEMO.md||2 years ago|
|README.md||2 years ago|
|snapcraft.yaml||2 years ago|
|test-requirements.txt||2 years ago|
|tox.ini||2 years ago|
MicroStack is a single-machine, snap-deployed OpenStack cloud.
Common purposes include:
- Development and testing of OpenStack workloads
- Continuous integration (CI)
- IoT and appliances
- Edge clouds (experimental)
- Introducing new users to OpenStack
Currently provided OpenStack services are: Nova, Keystone, Glance, Horizon, and Neutron.
MicroStack is frequently updated to provide the latest stable updates of the most recent OpenStack release.
Requirements: You will need at least 2 CPUs, 8 GiB of memory, and 100 GiB of disk space.
See the full MicroStack documentation.
At this time you can install from the
--edge snap channels:
sudo snap install microstack --classic --beta
Initialisation will set up databases, networks, flavors, an SSH keypair, a CirrOS image, and open ICMP/SSH security groups:
sudo microstack.init --auto
The OpenStack client is bundled as
microstack.openstack. For example:
microstack.openstack network list microstack.openstack flavor list microstack.openstack keypair list microstack.openstack image list microstack.openstack security group rule list
Creating an instance
To create an instance (called "awesome") based on the CirrOS image:
microstack.launch cirros --name awesome
SSH to an instance
The launch output will show you how to connect to the instance. For the CirrOS image, the user account is 'cirros'.
ssh -i ~/.ssh/id_microstack cirros@<ip-address>
The launch output will also provide information for the Horizon dashboard. Its credentials are:
username: admin password: keystone
To remove MicroStack, run:
sudo microstack.remove --auto
This will clean up the Open vSwitch bridge device and uninstall
MicroStack. If you remove MicroStack with the
snap remove command
instead, don't worry -- the Open vSwitch bridge will disappear the
next time that you reboot your system.
Note that you can pass any arguments that you'd pass to the
snap remove command to
microstack.remove. To purge the snap,
for example, run:
sudo microstack.remove --auto --purge
Customising and contributing
To customise services and settings, look in the
.d directories under
/var/snap/microstack/common/etc. You can add services with your package
manager, or take a look at
CONTRIBUTING.md and make a code based argument for
adding a service to the default list.
Reporting a bug
Please report bugs to the MicroStack project on Launchpad.