Emilien Macchi 6cd603610b Update docs structure

The upstream docs structure is changing, so this change updates our
existing docs into contributor and install guide sections.

Change-Id: I37fabd25fdda6bc56fcfb331b74e3294e31e68bb

2017-07-07 20:04:52 +00:00

2.9 KiB

Raw Blame History

tripleo.sh

tripleo.sh is a script that can be used to help bootstrap development environments. It automates many of the steps in this documentation to help get setup faster. It's opinionated automation around other production tooling (python-tripleoclient , etc). tripleo.sh is also used by tripleo-ci to test TripleO patches.

Get tripleo.sh

tripleo.sh is from the tripleo-ci project. git clone tripleo-ci, and the script is under the scripts/ directory:

git clone https://git.openstack.org/openstack-infra/tripleo-ci
tripleo-ci/scripts/tripleo.sh --help

Using tripleo.sh

The tripleo.sh script is intended to run on an new instack undercloud setup. That is, you would follow the environment setup docs through to and including instack-virt-setup (for a virt setup), ssh onto the resulting undercloud node and then run tripleo.sh with the options identified below.

Options

The help text shows what options are available, and the options are listed in corresponding order with how a TripleO deployment is done.

Repository setup:

tripleo-ci/scripts/tripleo.sh --repo-setup

Installing the undercloud:

tripleo-ci/scripts/tripleo.sh --undercloud

Building overcloud images:

tripleo-ci/scripts/tripleo.sh --overcloud-images

Registering nodes:

tripleo-ci/scripts/tripleo.sh --register-nodes

Introspect nodes:

tripleo-ci/scripts/tripleo.sh --introspect-nodes

Deploy overcloud:

tripleo-ci/scripts/tripleo.sh --overcloud-deploy

Alternatively, all of the above options can be execute at once with:

tripleo-ci/scripts/tripleo.sh --all

Test overcloud:

tripleo-ci/scripts/tripleo.sh --overcloud-pingtest

Requirements for testing the overcloud: overcloudrc file (Located by default in the undercloud current user’s directory).

This option will check that the overcloud is able to create a stack, testing several OpenStack components in the process. The following steps are made in order to check the stack creation:

Download a Linux image and upload it to glance with the name pingtest_image.
Create an external neutron network called nova.
Create a subnet in the nova network.
Create a test stack called tenant-stack, using heat, which spawns a guest in the overcloud and attach it to the nova network.
Ping the floating IP address assigned to the new guest.

After the test, the created resources are deleted.

Environment variables

Certain values and assumptions can be changed via environment variables. See the tripleo.sh source code for details.

2.9 KiB Raw Blame History Unescape Escape