From 42111f8136d9a9ecbc7c7f23b3b9d0b05fa3f587 Mon Sep 17 00:00:00 2001 From: Hongbin Lu Date: Wed, 24 Jan 2018 02:34:42 +0000 Subject: [PATCH] Doc: split second-node setup out of quickstart guide The quickstart guide is for new developers to quickly setup the environment and they are unlike to setup additional nodes as part of the quick start. So let's split the multi-node setup session out. Change-Id: I83f7aa61ec0c2681a5b9e79950ebde27879ca961 --- doc/source/contributor/index.rst | 1 + doc/source/contributor/multinode-devstack.rst | 68 +++++++++++++++++++ doc/source/contributor/quickstart.rst | 41 ----------- 3 files changed, 69 insertions(+), 41 deletions(-) create mode 100644 doc/source/contributor/multinode-devstack.rst diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index edfba3dfa..654af088f 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -28,6 +28,7 @@ project. Setting Up Your Development Environment Under Mod WSGI Running Tempest Tests Running Unit Tests + Multinode Devstack There are some other important documents also that helps new contributors to contribute effectively towards code standards to the project. diff --git a/doc/source/contributor/multinode-devstack.rst b/doc/source/contributor/multinode-devstack.rst new file mode 100644 index 000000000..6a0d68ba2 --- /dev/null +++ b/doc/source/contributor/multinode-devstack.rst @@ -0,0 +1,68 @@ +.. + 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. + +=================== +Multi-host Devstack +=================== + +This is a guide for developers who want to setup Zun in more than one hosts. + +Prerequisite +============ + +You need to deploy Zun in a devstack environment in the first host. + +Refer the ``Exercising the Services Using Devstack`` session at `Developer +Quick-Start Guide `_ +for details. + +Enable additional zun host +========================== + +Refer to the `Multi-Node lab +`__ +for more information. + +On the second host, clone devstack:: + + # Create a root directory for devstack if needed + $ sudo mkdir -p /opt/stack + $ sudo chown $USER /opt/stack + + $ git clone https://git.openstack.org/openstack-dev/devstack /opt/stack/devstack + +The second host will only need zun-compute service along with kuryr-libnetwork +support. You also need to tell devstack where the SERVICE_HOST is:: + + $ SERVICE_HOST= + $ HOST_IP= + $ git clone https://git.openstack.org/openstack/zun /opt/stack/zun + $ cat /opt/stack/zun/devstack/local.conf.subnode.sample \ + | sed "s/HOST_IP=.*/HOST_IP=$HOST_IP/" \ + | sed "s/SERVICE_HOST=.*/SERVICE_HOST=$SERVICE_HOST/" \ + > /opt/stack/devstack/local.conf + +Run devstack:: + + $ cd /opt/stack/devstack + $ ./stack.sh + +On the controller host, you can see 2 zun-compute hosts available:: + + $ zun service-list + +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+ + | Id | Host | Binary | State | Disabled | Disabled Reason | Created At | Updated At | + +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+ + | 1 | zun-hosts-1 | zun-compute | up | False | None | 2017-05-18 07:06:45+00:00 | 2017-05-19 03:20:55+00:00 | + | 2 | zun-hosts-2 | zun-compute | up | False | None | 2017-05-18 07:09:44+00:00 | 2017-05-19 03:21:10+00:00 | + +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+ diff --git a/doc/source/contributor/quickstart.rst b/doc/source/contributor/quickstart.rst index 5a240d482..b9180123f 100644 --- a/doc/source/contributor/quickstart.rst +++ b/doc/source/contributor/quickstart.rst @@ -96,44 +96,3 @@ You should see a similar output to:: Delete the container:: $ zun delete test - -Enable the second zun host -========================== - -Refer to the `Multi-Node lab -`__ -for more information. - -On the second host, clone devstack:: - - # Create a root directory for devstack if needed - $ sudo mkdir -p /opt/stack - $ sudo chown $USER /opt/stack - - $ git clone https://git.openstack.org/openstack-dev/devstack /opt/stack/devstack - -The second host will only need zun-compute service along with kuryr-libnetwork -support. You also need to tell devstack where the SERVICE_HOST is:: - - $ SERVICE_HOST= - $ HOST_IP= - $ git clone https://git.openstack.org/openstack/zun /opt/stack/zun - $ cat /opt/stack/zun/devstack/local.conf.subnode.sample \ - | sed "s/HOST_IP=.*/HOST_IP=$HOST_IP/" \ - | sed "s/SERVICE_HOST=.*/SERVICE_HOST=$SERVICE_HOST/" \ - > /opt/stack/devstack/local.conf - -Run devstack:: - - $ cd /opt/stack/devstack - $ ./stack.sh - -On the controller host, you can see 2 zun-compute hosts available:: - - $ zun service-list - +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+ - | Id | Host | Binary | State | Disabled | Disabled Reason | Created At | Updated At | - +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+ - | 1 | zun-hosts-1 | zun-compute | up | False | None | 2017-05-18 07:06:45+00:00 | 2017-05-19 03:20:55+00:00 | - | 2 | zun-hosts-2 | zun-compute | up | False | None | 2017-05-18 07:09:44+00:00 | 2017-05-19 03:21:10+00:00 | - +----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+