One of the barriers to entry for trying out TripleO and its derivatives has been the relative difficulty in getting an environment up quickly.
This set of ansible roles is meant to help.
You will need a host machine with at least 16G of RAM, preferably 32G, with CentOS 7 installed, and able to be ssh'd to as root without password from the machine running ansible.
A quick way to test that your host machine is ready to rock is:
export VIRTHOST='my_test_machine.example.com' ssh root@$VIRTHOST -C 'uname -a'
The defaults are meant to "just work", so it is as easy as downloading and running the quickstart.sh script.
Or rather it will be once we have a good place to host the
images. The centosci artifacts server drops the http connection
regularly, so we need to use wget for the built in retry with
resume. From the machine that will be the virthost, create a
directory for the undercloud image and wget it. Note, the
image location should be world readable since a stack
user
is used for most steps.:
mkdir -p /usr/share/quickstart_images/mitaka/ cd /usr/share/quickstart_images/mitaka/ wget https://ci.centos.org/artifacts/rdo/images/mitaka/delorean/stable/undercloud.qcow2.md5 \ https://ci.centos.org/artifacts/rdo/images/mitaka/delorean/stable/undercloud.qcow2 # Check that the md5sum's match (The playbook will also # check, but better to know now whether the image download # was ok.) md5sum -c undercloud.qcow2.md5
Then use the quickstart.sh script to install this repo along
with ansible in a virtual environment and run the quickstart
playbook. Note, the quickstart playbook will delete the stack
user on the virthost and recreate it.:
export VIRTHOST='my_test_machine.example.com' export UNDERCLOUD_QCOW2_LOCATION=file:///usr/share/quickstart_images/mitaka/undercloud.qcow2 bash <(curl -s https://raw.githubusercontent.com/redhat-openstack/tripleo-quickstart/master/quickstart.sh) [release]
This script will output instructions at the end to access the
deployed undercloud. If a release name is not given, mitaka
is used. Note that to use a different release you will need to
download a different undercloud image in the first step above.
For example, for liberty:
https://ci.centos.org/artifacts/rdo/images/liberty/delorean/stable/undercloud.qcow2
More in-depth documentation is a work in progress. Patches welcome!
To install tripleo-quickstart
yourself instead of via the
quickstart.sh script:
pip install git+https://github.com/redhat-openstacktripleo-quickstart.git@master#egg=tripleo-quickstart
Playbooks will be located in either /usr/local/share/tripleo-quickstart
or
in $VIRTUAL_ENV/usr/local/share/tripleo-quickstart
if you have installed in
a virtual environment.
John Trowbridge
Copyright 2015 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.