(There are detailed instructions available below, the overview and configuration sections provide background information).

  • Define a VM that is your seed node
  • Define N VMs to pretend to be your cluster
  • Create a seed VM
  • Create an undercloud
  • Create an overcloud
  • Deploy a sample workload in the overcloud
  • Add environment variables to be included to ~/.devtestrc, e.g. http_proxy
  • Go to town testing deployments on them.
  • For troubleshooting see Troubleshooting tips
  • For generic deployment information see Deploying TripleO

This document is extracted from, our automated bring-up story for CI/experimentation.


These scripts are designed to be run under your normal user account. The scripts make use of sudo when elevated privileges are needed. You will either need to run this attended, entering your password when sudo needs it, or enable passwordless sudo for your user. Another option is to extend the timeout of sudo sessions so that passwordless sudo will be allowed enough time on the controlling terminal to complete the devtest run. If there are any circumstances where running as a normal user, and not root, fails, this is considered a critical bug.


In order to set the sudo session timeout higher, add this to /etc/sudoers:

Defaults    timestamp_timeout=240 # 4 hours

This will result in 4 hour timeouts for sudo session credentials. To reset the timeout run:

sudo -k; sudo -v

In order to set a user to full passwordless operation add this (typically near the end of /etc/sudoers):

username    ALL = NOPASSWD: ALL

Initial Checkout

  1. Choose a base location to put all of the source code.


    exports are ephemeral - they will not survive across new shell sessions or reboots. If you put these export commands in ~/.devtestrc, you can simply source ~/.devtestrc to reload them. Alternatively, you can $TRIPLEO_ROOT/tripleo-incubator/scripts/write-tripleorc and then source the generated tripleorc file.

    export TRIPLEO_ROOT=~/tripleo


    By default, uses ~/.cache/tripleo for $TRIPLEO_ROOT. Unless you’re planning to do a one-shot run of and never look at the code installed or the artifacts generated, you should set this value to something more convenient to you.

  2. Create the directory and check out the code

    mkdir -p $TRIPLEO_ROOT
    git clone
    cd tripleo-incubator

Optional: stable branch

Note that every effort is made to keep the published set of these instructions updated for use with only the master branches of the TripleO projects. There is NO guaranteed stability in master. There is also no guaranteed stable upgrade path from release to release or from one stable branch to a later stable branch. The stable branches are a point in time and make no guarantee about deploying older or newer branches of OpenStack projects correctly.

If you wish to use the stable branches, you should instead checkout and clone the stable branch of tripleo-incubator you want, and then build the instructions yourself. For instance, to create a local branch named icehouse based on the upstream branch stable/icehouse:

git checkout -b icehouse origin/stable/icehouse
tox -evenv python build_sphinx
# View doc/build/html/devtest.html in your browser and proceed from there

Next Steps:

When run as a standalone script, runs the following commands to configure the devtest environment, bootstrap a seed, deploy under and overclouds. Many of these commands are also part of our documentation. Readers may choose to either run the commands given here, or instead follow the documentation for each command and walk through it step by step to see what is going on. This choice can be made on a case by case basis - for instance, if bootstrapping is not interesting, run that as devtest does, then step into the undercloud setup for granular details of bringing up a baremetal cloud.

  1. See devtest_variables for documentation. Assuming you’re still at the root of your checkout:

    source scripts/
  2. See devtest_setup for documentation. $CONTINUE should be set to ‘–trash-my-machine’ to have it execute unattended. $CONTINUE
  3. See devtest_testenv for documentation. Note that you can make your test environment just once and reuse it thereafter. TE_DATAFILE should specify where you want your test environment JSON file created. (A default value is set in $TE_DATAFILE $NODES_ARG $NETS_ARG
  4. See devtest_ramdisk for documentation:
  5. See devtest_seed for documentation. If you are not deploying an undercloud, (see below) then you will want to add –all-nodes to your invocation of,which will register all your nodes directly with the seed cloud.:
    export no_proxy=${no_proxy:-},
    source $TRIPLEO_ROOT/tripleo-incubator/seedrc
  6. See devtest_undercloud for documentation. The undercloud doesn’t have to be built - the seed is entirely capable of deploying any baremetal workload - but a production deployment would quite probably want to have a heat deployed (and thus reconfigurable) deployment infrastructure layer). If you are only building images you won’t need to update your no_proxy line or source the undercloudrc file.

    :: $TE_DATAFILE export no_proxy=$no_proxy,$(os-apply-config –type raw -m $TE_DATAFILE –key undercloud.endpointhost) source $TRIPLEO_ROOT/tripleo-incubator/undercloudrc

  7. See devtest_overcloud for documentation. If you are only building images you won’t need to update your no_proxy line or source the overcloudrc file.
    export no_proxy=$no_proxy,$(os-apply-config --type raw -m $TE_DATAFILE --key overcloud.endpointhost)
    source $TRIPLEO_ROOT/tripleo-incubator/overcloudrc
  8. See devtest_end for documentation:

Table Of Contents

Previous topic

Using TripleO

Next topic


This Page