openstack/kayobe
Code Issues Proposed changes

Ubuntu: document overcloud development environment

Browse Source 
Updates the contributor documentation for the overcloud development
environment to include steps for running on Ubuntu.

Change-Id: I1dbb5978342261e8c8e36fbe270f238750808ad6
Story: 2004960
Task: 41550
This commit is contained in:
Mark Goddard 2021-01-07 16:37:01 +00:00
parent 0e3ec62471
commit 1d55a33094
1 changed files with 36 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/source/contributor/automated.rst
View File

@ -56,6 +56,11 @@ Clone the ``kayobe-config-dev`` repository to ``config/src/kayobe-config``::
Inspect the Kayobe configuration and make any changes necessary for your
environment.
If using Ubuntu, configure Kolla Ansible to use the Ubuntu source images::
sed -i -e 's/#kolla_base_distro:/kolla_base_distro: ubuntu/' config/src/kayobe-config/etc/kayobe/kolla.yml
sed -i -e 's/#kolla_install_type:/kolla_install_type: source/' config/src/kayobe-config/etc/kayobe/kolla.yml
If using Vagrant, follow the steps in :ref:`contributor-vagrant` to prepare
your environment for use with Vagrant and bring up a Vagrant VM.
@ -65,7 +70,8 @@ control plane traffic. The bridge should be named ``breth1`` with a single
port ``eth1``, and an IP address of ``192.168.33.3/24``. This can be modified
by editing
``config/src/kayobe-config/etc/kayobe/inventory/group_vars/controllers/network-interfaces``.
Alternatively, this can be added using the following commands::
On CentOS, this can be added using the following commands::
sudo ip l add breth1 type bridge
sudo ip l set breth1 up
@ -74,6 +80,30 @@ Alternatively, this can be added using the following commands::
sudo ip l set eth1 up
sudo ip l set eth1 master breth1
On Ubuntu, the interface configuration must be persistent::
sudo apt update
sudo apt -y install ifupdown
sudo ip l add breth1 type bridge
sudo ip l add eth1 type dummy
cat << EOF | sudo tee /etc/network/interfaces.d/ifcfg-eth1
auto eth1
iface eth1 inet manual
EOF
cat << EOF | sudo tee /etc/network/interfaces.d/ifcfg-breth1
auto breth1
iface breth1 inet static
address 192.168.33.3
netmask 255.255.255.0
bridge_ports eth1
EOF
sudo ifup eth1
sudo ifup breth1
Usage
-----
@ -148,6 +178,11 @@ services::
./dev/configure-firewall.sh
On Ubuntu, the ``nova_libvirt`` image does not contain the ``qemu-utils``
package necessary for image operations used by Tenks. Install it as follows::
sudo docker exec -u root nova_libvirt bash -c 'apt update && apt -y install qemu-utils'
We are now ready to run the ``dev/overcloud-test-baremetal.sh`` script. This
will run the ``init-runonce`` setup script provided by Kolla Ansible that
registers images, networks, flavors etc. It will then deploy a bare metal