The upstream docs structure is changing, so this change updates our existing docs into contributor and install guide sections. Change-Id: I37fabd25fdda6bc56fcfb331b74e3294e31e68bb
2.9 KiB
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.