92d96f514a
This commit improves the setup scripts to support multi-nics: 1. update kube_master playbook to read kubeadm init parameter from environment variable 2. add one note into development-environment-devstack doc Change-Id: Ie5fa11cc0d0b1a4cf5bd388b80a12a3f00295788
124 lines
3.9 KiB
ReStructuredText
124 lines
3.9 KiB
ReStructuredText
..
|
|
Copyright 2017 Catalyst IT Ltd
|
|
All Rights Reserved.
|
|
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.
|
|
|
|
Setting up a development environment with devstack
|
|
==================================================
|
|
|
|
This page describes how to setup a working development
|
|
environment that can be used in deploying qinling on latest releases
|
|
of Ubuntu. These instructions assume you are already familiar
|
|
with git. Refer to `Getting the code`_ for additional information.
|
|
|
|
.. _Getting the code: http://wiki.openstack.org/GettingTheCode
|
|
|
|
Following these instructions will allow you to have a fully functional qinling
|
|
environment using the devstack project (a shell script to build
|
|
complete OpenStack development environments) on Ubuntu 16.04.
|
|
|
|
Configuring devstack with Qinling
|
|
---------------------------------
|
|
|
|
Qinling can be enabled in devstack by using the plug-in based interface it
|
|
offers.
|
|
|
|
.. note::
|
|
|
|
The following steps have been fully verified only on Ubuntu 16.04.
|
|
|
|
Start by cloning the devstack repository using a non-root user:
|
|
|
|
::
|
|
|
|
git clone https://github.com/openstack-dev/devstack
|
|
|
|
Change to devstack directory:
|
|
|
|
::
|
|
|
|
cd devstack/
|
|
|
|
Create the ``local.conf`` file with the following minimal devstack
|
|
configuration:
|
|
|
|
.. code-block:: ini
|
|
|
|
[[local|localrc]]
|
|
RECLONE=True
|
|
enable_plugin qinling https://github.com/openstack/qinling
|
|
|
|
LIBS_FROM_GIT=python-qinlingclient
|
|
DATABASE_PASSWORD=password
|
|
ADMIN_PASSWORD=password
|
|
SERVICE_PASSWORD=password
|
|
SERVICE_TOKEN=password
|
|
RABBIT_PASSWORD=password
|
|
LOGFILE=$DEST/logs/stack.sh.log
|
|
LOG_COLOR=False
|
|
LOGDAYS=1
|
|
|
|
ENABLED_SERVICES=rabbit,mysql,key,tempest
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
For multiple network cards, you need to update the Kubernetes apiserver's advertise address
|
|
to the address on the interface which is used to get to the default gateway by adding one
|
|
environment variable.
|
|
|
|
.. code-block:: console
|
|
|
|
export EXTRA_KUBEADM_INIT_OPTS="--apiserver-advertise-address <default-host-ip>"
|
|
|
|
.. end
|
|
|
|
Running devstack
|
|
----------------
|
|
|
|
Run the ``stack.sh`` script:
|
|
|
|
::
|
|
|
|
./stack.sh
|
|
|
|
After it completes, verify qinling service is installed properly:
|
|
|
|
.. code-block:: console
|
|
|
|
$ source openrc admin admin
|
|
$ openstack service list
|
|
+----------------------------------+----------+-----------------+
|
|
| ID | Name | Type |
|
|
+----------------------------------+----------+-----------------+
|
|
| 59be2ecc8b8d4e61af184ea3495bf207 | qinling | function-engine |
|
|
| e5891d41a929402384ef00ce7135a16d | keystone | identity |
|
|
+----------------------------------+----------+-----------------+
|
|
$ openstack runtime list --print-empty
|
|
+----+------+-------+--------+-------------+------------+------------+------------+
|
|
| Id | Name | Image | Status | Description | Project_id | Created_at | Updated_at |
|
|
+----+------+-------+--------+-------------+------------+------------+------------+
|
|
+----+------+-------+--------+-------------+------------+------------+------------+
|
|
|
|
.. end
|
|
|
|
Kubernetes Integration
|
|
----------------------
|
|
|
|
By default, Qinling uses Kubernetes as its orchestrator backend, so a k8s
|
|
all-in-one environment (and some other related tools, e.g. kubectl) is also
|
|
set up during devstack installation.
|
|
|
|
Qinling devstack script uses `kubeadm <https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/>`_
|
|
for Kubernetes installation, refer to ``tools/gate/kubeadm/setup_gate.sh`` for
|
|
more detailed information about Qinling devstack installation. |