- Uses MicroStack
- Works on a workstation or a VM
- Suitable for testing and development
This tutorial shows how to install MicroStack in the simplest way possible. It will deploy an OpenStack 2023.1 (Antelope) cloud.
The cloud will only allow access to its VMs from the local host. To enable access from any host on your network, follow the Single-node guided tutorial instead.
You will need a single machine whose requirements are:
- physical or virtual machine running Ubuntu 22.04 LTS
- a multi-core amd64 processor ideally with 4+ cores
- a minimum of 16 GiB of free memory
Caution: Any change in IP address of the local host will be detrimental to the deployment. A virtual host will generally have a more stable address.
Deploy the cloud
Install the openstack snap
Begin by installing the openstack snap:
sudo snap install openstack --channel 2023.1
Prepare the machine
Sunbeam can generate a script to ensure that the machine has all of the required dependencies installed and is configured correctly for use in MicroStack - you can review this script using:
or the script can be directly executed in this way:
sunbeam prepare-node-script | bash -x && newgrp snap_daemon
The script will ensure some software requirements are satisfied on the host. In particular, it will:
openssh-serverif it is not found
- configure passwordless sudo for all commands for the current user (
Bootstrap the cloud
Deploy the OpenStack cloud using the
cluster bootstrap command and accept software defaults:
sunbeam cluster bootstrap --accept-defaults
Configure the cloud and obtain credentials
Now configure the deployed cloud using the
sunbeam configure --accept-defaults --openrc demo-openrc
The above command provides normal user credentials (file
demo-openrc). Admin credentials can be obtained in this way (file
sunbeam openrc > admin-openrc
Launch a VM
Verify the cloud by launching a VM called ‘test’ based on the ‘ubuntu’ image (Ubuntu 22.04 LTS). The
launch command is used:
sunbeam launch ubuntu --name test
Launching an OpenStack instance ... Access instance with `ssh -i /home/ubuntu/.config/openstack/sunbeam email@example.com`
Connect to the VM over SSH using the provided command. Note that the VM will not be ready instantaneously; waiting time is mostly determined by the cloud’s available resources.
Now that OpenStack is set up, be sure to check out the following howto guides:
Multi-node mode with bare metal automation
- Uses OpenStack Charms
- Uses MAAS for bare metal automation
- Suitable for large-scale production environments
Check the OpenStack Charms Deployment Guide for detailed instructions on how to set up OpenStack in multi-node mode with bare metal automation using OpenStack Charms.
Take the next step
Is your OpenStack already up and running? If so, we hope you liked it and are now ready to take the next step.
Learn OpenStack through a series of tutorials. Starting with just your workstation, learn how to use OpenStack for cloud infrastructure implementation purposes, from a single-node installation to large-scale clusters.
The OpenStack User Survey provides users an opportunity to influence the community and software direction. By sharing information about your configuration and requirements, the Open Infrastructure Foundation User Committee will be able to advocate on your behalf.
Canonical provides full commercial support for OpenStack clouds deployed with MicroStack. Simply get any Ubuntu Pro subscription with Support, attach it to all nodes in your cluster and benefit from phone and ticket support.
Liked OpenStack but don't want to manage it yourself? Don't worry - Canonical can design, build and operate the cloud for you. Offload OpenStack operations to our team of cloud experts and benefit from public cloud -like experience.