DevStack is a series of extensible scripts used to quickly bring up a complete OpenStack environment based on the latest versions of everything from git master. It is used interactively as a development environment and as the basis for much of the OpenStack project’s functional testing.
The source is available at https://opendev.org/openstack/devstack.
DevStack will make substantial changes to your system during installation. Only run DevStack on servers or virtual machines that are dedicated to this purpose.
Start with a clean and minimal install of a Linux system. DevStack attempts to support the two latest LTS releases of Ubuntu, Rocky Linux 9 and openEuler.
If you do not have a preference, Ubuntu 22.04 (Jammy) is the most tested, and will probably go the smoothest.
Add Stack User (optional)¶
DevStack should be run as a non-root user with sudo enabled (standard logins to cloud images such as “ubuntu” or “cloud-user” are usually fine).
If you are not using a cloud image, you can create a separate stack user to run DevStack with
$ sudo useradd -s /bin/bash -d /opt/stack -m stack
Ensure home directory for the
stack user has executable permission for all,
as RHEL based distros create it with
700 and Ubuntu 21.04+ with
which can cause issues during deployment.
$ sudo chmod +x /opt/stack
Since this user will be making many changes to your system, it should have sudo privileges:
$ echo "stack ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/stack
$ sudo -u stack -i
$ git clone https://opendev.org/openstack/devstack
$ cd devstack
devstack repo contains a script that installs OpenStack and
templates for configuration files.
Create a local.conf¶
local.conf file with four passwords preset at the root of the
devstack git repo.
This is the minimum required config to get started with DevStack.
There is a sample
under the samples directory in the devstack repository.
Only use alphanumeric characters in your passwords, as some services fail to work when using special characters.
Start the install¶
This will take 15 - 30 minutes, largely depending on the speed of your internet connection. Many git trees and packages will be installed during this process.
You now have a working DevStack! Congrats!
Your devstack will have installed
horizon. Floating IPs
will be available, guests have access to the external world.
You can access horizon to experience the web interface to OpenStack, and manage vms, networks, volumes, and images from there.
source openrc in your shell, and then use the
openstack command line tool to manage your devstack.
cd /opt/stack/tempest and run tempest tests that have
been configured to work with your devstack.
Read guides for specific setups people have (note: guides are point in time contributions, and may not always be kept up to date to the latest devstack).
Enable devstack plugins to support additional services, features, and configuration not present in base devstack.
If you are a new contributor to devstack please refer: So You Want to Contribute…
- System-wide debugging
- Developing with Devstack
- Contributing to DevStack
- DevStack Networking
- DevStack Plugin Registry
- Using Systemd in DevStack
- Migrating Zuul V2 CI jobs to V3
- Zuul CI Jobs
- Zuul CI Roles