openstack/zun
Code Issues Proposed changes
314b3a85da
zun/doc/source/contributor/multinode-devstack.rst
Hongbin Lu 42111f8136 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
2018-01-27 16:07:43 +00:00

2.8 KiB
Raw Blame History

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=<controller's ip>
$ HOST_IP=<your 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 |
+----+-------------+-------------+-------+----------+-----------------+---------------------------+---------------------------+