Document how to use zun devstack plugin
* Add content about how to install Zun with devstack plugin * Move the content about how to manually add Zun to devstack to a separated document. Change-Id: I5737c18fa9b26e43936aa8959e48e5c14d06ef3c
This commit is contained in:
Hongbin Lu
parent
9df621ae66
commit
db7cd407f5
@ -9,6 +9,7 @@ Please fill here a long description which must be at least 3 lines wrapped on
|
|||||||
Note that this is a hard requirement.
|
Note that this is a hard requirement.
|
||||||
|
|
||||||
* Free software: Apache license
|
* Free software: Apache license
|
||||||
|
* Get Started: https://github.com/openstack/zun/blob/master/doc/source/dev/quickstart.rst
|
||||||
* Documentation: http://docs.openstack.org/developer/zun
|
* Documentation: http://docs.openstack.org/developer/zun
|
||||||
* Source: http://git.openstack.org/cgit/openstack/zun
|
* Source: http://git.openstack.org/cgit/openstack/zun
|
||||||
* Bugs: http://bugs.launchpad.net/zun
|
* Bugs: http://bugs.launchpad.net/zun
|
||||||
|
|||||||
162
doc/source/dev/manual-devstack.rst
Normal file
162
doc/source/dev/manual-devstack.rst
Normal file
@ -0,0 +1,162 @@
|
|||||||
|
.. _manual-install:
|
||||||
|
|
||||||
|
===============================
|
||||||
|
Manually Adding Zun to DevStack
|
||||||
|
===============================
|
||||||
|
If you are getting started with zun it is recommended you follow the
|
||||||
|
:ref:`quickstart` to get up and running with zun. This guide covers
|
||||||
|
a more in-depth process to setup zun with devstack.
|
||||||
|
|
||||||
|
This session has only been tested on Ubuntu 14.04 (Trusty).
|
||||||
|
We recommend users to select one of it if it is possible.
|
||||||
|
|
||||||
|
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
|
||||||
|
|
||||||
|
We will run devstack with minimal local.conf settings required to enable
|
||||||
|
required OpenStack services::
|
||||||
|
|
||||||
|
cat > /opt/stack/devstack/local.conf << END
|
||||||
|
[[local|localrc]]
|
||||||
|
HOST_IP=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1 -d'/')
|
||||||
|
DATABASE_PASSWORD=password
|
||||||
|
RABBIT_PASSWORD=password
|
||||||
|
SERVICE_TOKEN=password
|
||||||
|
SERVICE_PASSWORD=password
|
||||||
|
ADMIN_PASSWORD=password
|
||||||
|
END
|
||||||
|
|
||||||
|
More devstack configuration information can be found at
|
||||||
|
http://docs.openstack.org/developer/devstack/configuration.html
|
||||||
|
|
||||||
|
More neutron configuration information can be found at
|
||||||
|
http://docs.openstack.org/developer/devstack/guides/neutron.html
|
||||||
|
|
||||||
|
Run devstack::
|
||||||
|
|
||||||
|
cd /opt/stack/devstack
|
||||||
|
./stack.sh
|
||||||
|
|
||||||
|
Prepare your session to be able to use the various openstack clients including
|
||||||
|
nova, neutron, and glance. Create a new shell, and source the devstack openrc
|
||||||
|
script::
|
||||||
|
|
||||||
|
source /opt/stack/devstack/openrc admin admin
|
||||||
|
|
||||||
|
Create a database in MySQL for zun::
|
||||||
|
|
||||||
|
mysql -h 127.0.0.1 -u root -ppassword mysql <<EOF
|
||||||
|
CREATE DATABASE IF NOT EXISTS zun DEFAULT CHARACTER SET utf8;
|
||||||
|
GRANT ALL PRIVILEGES ON zun.* TO
|
||||||
|
'root'@'%' IDENTIFIED BY 'password'
|
||||||
|
EOF
|
||||||
|
|
||||||
|
Create the service credentials for zun::
|
||||||
|
|
||||||
|
openstack user create --password password zun
|
||||||
|
openstack role add --project service --user zun admin
|
||||||
|
|
||||||
|
Clone and install zun::
|
||||||
|
|
||||||
|
cd ~
|
||||||
|
git clone https://git.openstack.org/openstack/zun
|
||||||
|
cd zun
|
||||||
|
sudo pip install -e .
|
||||||
|
|
||||||
|
Configure zun::
|
||||||
|
|
||||||
|
# create the zun conf directory
|
||||||
|
ZUN_CONF_DIR=/etc/zun
|
||||||
|
ZUN_CONF=$ZUN_CONF_DIR/zun.conf
|
||||||
|
sudo mkdir -p $ZUN_CONF_DIR
|
||||||
|
sudo chown -R ${USER} $ZUN_CONF_DIR
|
||||||
|
|
||||||
|
# generate sample config file and modify it as necessary
|
||||||
|
sudo chown -R ${USER} .
|
||||||
|
tox -egenconfig
|
||||||
|
sudo cp etc/zun/zun.conf.sample $ZUN_CONF_DIR/zun.conf
|
||||||
|
sudo cp etc/zun/api-paste.ini $ZUN_CONF_DIR/api-paste.ini
|
||||||
|
|
||||||
|
# copy policy.json
|
||||||
|
sudo cp etc/zun/policy.json $ZUN_CONF_DIR/policy.json
|
||||||
|
|
||||||
|
# enable debugging output
|
||||||
|
sudo sed -i "s/#debug\s*=.*/debug=true/" $ZUN_CONF
|
||||||
|
|
||||||
|
# set RabbitMQ userid
|
||||||
|
sudo sed -i "s/#rabbit_userid\s*=.*/rabbit_userid=stackrabbit/" \
|
||||||
|
$ZUN_CONF
|
||||||
|
|
||||||
|
# set RabbitMQ password
|
||||||
|
sudo sed -i "s/#rabbit_password\s*=.*/rabbit_password=password/" \
|
||||||
|
$ZUN_CONF
|
||||||
|
|
||||||
|
# set SQLAlchemy connection string to connect to MySQL
|
||||||
|
sudo sed -i "s/#connection\s*=.*/connection=mysql:\/\/root:password@localhost\/zun/" \
|
||||||
|
$ZUN_CONF
|
||||||
|
|
||||||
|
# set keystone_auth
|
||||||
|
source /opt/stack/devstack/openrc admin admin
|
||||||
|
iniset $ZUN_CONF keystone_auth auth_type password
|
||||||
|
iniset $ZUN_CONF keystone_auth username zun
|
||||||
|
iniset $ZUN_CONF keystone_auth password password
|
||||||
|
iniset $ZUN_CONF keystone_auth project_name service
|
||||||
|
iniset $ZUN_CONF keystone_auth project_domain_id default
|
||||||
|
iniset $ZUN_CONF keystone_auth user_domain_id default
|
||||||
|
iniset $ZUN_CONF keystone_auth auth_url ${OS_AUTH_URL/v2.0/v3}
|
||||||
|
|
||||||
|
# NOTE: keystone_authtoken section is deprecated and will be removed.
|
||||||
|
iniset $ZUN_CONF keystone_authtoken username zun
|
||||||
|
iniset $ZUN_CONF keystone_authtoken password password
|
||||||
|
iniset $ZUN_CONF keystone_authtoken project_name service
|
||||||
|
iniset $ZUN_CONF keystone_authtoken auth_url ${OS_AUTH_URL/v2.0/v3}
|
||||||
|
iniset $ZUN_CONF keystone_authtoken auth_version v3
|
||||||
|
iniset $ZUN_CONF keystone_authtoken auth_type password
|
||||||
|
iniset $ZUN_CONF keystone_authtoken user_domain_id default
|
||||||
|
iniset $ZUN_CONF keystone_authtoken project_domain_id default
|
||||||
|
|
||||||
|
Clone and install the zun client::
|
||||||
|
|
||||||
|
cd ~
|
||||||
|
git clone https://git.openstack.org/openstack/python-zunclient
|
||||||
|
cd python-zunclient
|
||||||
|
sudo pip install -e .
|
||||||
|
|
||||||
|
Install docker::
|
||||||
|
|
||||||
|
curl -fsSL https://get.docker.com/ | sudo sh
|
||||||
|
sudo usermod -a -G docker $(whoami)
|
||||||
|
|
||||||
|
Configure the database for use with zun. Please note that DB migration
|
||||||
|
does not work for SQLite backend. The SQLite database does not
|
||||||
|
have any support for the ALTER statement needed by relational schema
|
||||||
|
based migration tools. Hence DB Migration will not work for SQLite
|
||||||
|
backend::
|
||||||
|
|
||||||
|
zun-db-manage upgrade
|
||||||
|
|
||||||
|
Configure the keystone endpoint::
|
||||||
|
|
||||||
|
openstack service create --name=zun \
|
||||||
|
--description="Zun Container Service" \
|
||||||
|
container
|
||||||
|
openstack endpoint create --publicurl http://127.0.0.1:9512/v1 \
|
||||||
|
--adminurl http://127.0.0.1:9512/v1 \
|
||||||
|
--internalurl http://127.0.0.1:9512/v1 \
|
||||||
|
--region=RegionOne \
|
||||||
|
container
|
||||||
|
|
||||||
|
Start the API service in a new screen::
|
||||||
|
|
||||||
|
sg docker zun-api
|
||||||
|
|
||||||
|
Start the compute service in a new screen::
|
||||||
|
|
||||||
|
sg docker zun-compute
|
||||||
|
|
||||||
|
Zun should now be up and running!
|
||||||
@ -81,17 +81,15 @@ required OpenStack services::
|
|||||||
|
|
||||||
cat > /opt/stack/devstack/local.conf << END
|
cat > /opt/stack/devstack/local.conf << END
|
||||||
[[local|localrc]]
|
[[local|localrc]]
|
||||||
|
HOST_IP=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1 -d'/')
|
||||||
DATABASE_PASSWORD=password
|
DATABASE_PASSWORD=password
|
||||||
RABBIT_PASSWORD=password
|
RABBIT_PASSWORD=password
|
||||||
SERVICE_TOKEN=password
|
SERVICE_TOKEN=password
|
||||||
SERVICE_PASSWORD=password
|
SERVICE_PASSWORD=password
|
||||||
ADMIN_PASSWORD=password
|
ADMIN_PASSWORD=password
|
||||||
# zun requires the following to be set correctly
|
enable_plugin zun https://git.openstack.org/openstack/zun
|
||||||
PUBLIC_INTERFACE=eth1
|
|
||||||
END
|
END
|
||||||
|
|
||||||
**NOTE:** Update PUBLIC_INTERFACE as appropriate for your system.
|
|
||||||
|
|
||||||
More devstack configuration information can be found at
|
More devstack configuration information can be found at
|
||||||
http://docs.openstack.org/developer/devstack/configuration.html
|
http://docs.openstack.org/developer/devstack/configuration.html
|
||||||
|
|
||||||
@ -109,119 +107,6 @@ script::
|
|||||||
|
|
||||||
source /opt/stack/devstack/openrc admin admin
|
source /opt/stack/devstack/openrc admin admin
|
||||||
|
|
||||||
Create a database in MySQL for zun::
|
|
||||||
|
|
||||||
mysql -h 127.0.0.1 -u root -ppassword mysql <<EOF
|
|
||||||
CREATE DATABASE IF NOT EXISTS zun DEFAULT CHARACTER SET utf8;
|
|
||||||
GRANT ALL PRIVILEGES ON zun.* TO
|
|
||||||
'root'@'%' IDENTIFIED BY 'password'
|
|
||||||
EOF
|
|
||||||
|
|
||||||
Create the service credentials for zun::
|
|
||||||
|
|
||||||
openstack user create --password password zun
|
|
||||||
openstack role add --project service --user zun admin
|
|
||||||
|
|
||||||
Clone and install zun::
|
|
||||||
|
|
||||||
cd ~
|
|
||||||
git clone https://git.openstack.org/openstack/zun
|
|
||||||
cd zun
|
|
||||||
sudo pip install -e .
|
|
||||||
|
|
||||||
Configure zun::
|
|
||||||
|
|
||||||
# create the zun conf directory
|
|
||||||
ZUN_CONF_DIR=/etc/zun
|
|
||||||
ZUN_CONF=$ZUN_CONF_DIR/zun.conf
|
|
||||||
sudo mkdir -p $ZUN_CONF_DIR
|
|
||||||
sudo chown -R ${USER} $ZUN_CONF_DIR
|
|
||||||
|
|
||||||
# generate sample config file and modify it as necessary
|
|
||||||
sudo chown -R ${USER} .
|
|
||||||
tox -egenconfig
|
|
||||||
sudo cp etc/zun/zun.conf.sample $ZUN_CONF_DIR/zun.conf
|
|
||||||
sudo cp etc/zun/api-paste.ini $ZUN_CONF_DIR/api-paste.ini
|
|
||||||
|
|
||||||
# copy policy.json
|
|
||||||
sudo cp etc/zun/policy.json $ZUN_CONF_DIR/policy.json
|
|
||||||
|
|
||||||
# enable debugging output
|
|
||||||
sudo sed -i "s/#debug\s*=.*/debug=true/" $ZUN_CONF
|
|
||||||
|
|
||||||
# set RabbitMQ userid
|
|
||||||
sudo sed -i "s/#rabbit_userid\s*=.*/rabbit_userid=stackrabbit/" \
|
|
||||||
$ZUN_CONF
|
|
||||||
|
|
||||||
# set RabbitMQ password
|
|
||||||
sudo sed -i "s/#rabbit_password\s*=.*/rabbit_password=password/" \
|
|
||||||
$ZUN_CONF
|
|
||||||
|
|
||||||
# set SQLAlchemy connection string to connect to MySQL
|
|
||||||
sudo sed -i "s/#connection\s*=.*/connection=mysql:\/\/root:password@localhost\/zun/" \
|
|
||||||
$ZUN_CONF
|
|
||||||
|
|
||||||
# set keystone_auth
|
|
||||||
source /opt/stack/devstack/openrc admin admin
|
|
||||||
iniset $ZUN_CONF keystone_auth auth_type password
|
|
||||||
iniset $ZUN_CONF keystone_auth username zun
|
|
||||||
iniset $ZUN_CONF keystone_auth password password
|
|
||||||
iniset $ZUN_CONF keystone_auth project_name service
|
|
||||||
iniset $ZUN_CONF keystone_auth project_domain_id default
|
|
||||||
iniset $ZUN_CONF keystone_auth user_domain_id default
|
|
||||||
iniset $ZUN_CONF keystone_auth auth_url ${OS_AUTH_URL/v2.0/v3}
|
|
||||||
|
|
||||||
# NOTE: keystone_authtoken section is deprecated and will be removed.
|
|
||||||
iniset $ZUN_CONF keystone_authtoken username zun
|
|
||||||
iniset $ZUN_CONF keystone_authtoken password password
|
|
||||||
iniset $ZUN_CONF keystone_authtoken project_name service
|
|
||||||
iniset $ZUN_CONF keystone_authtoken auth_url ${OS_AUTH_URL/v2.0/v3}
|
|
||||||
iniset $ZUN_CONF keystone_authtoken auth_version v3
|
|
||||||
iniset $ZUN_CONF keystone_authtoken auth_type password
|
|
||||||
iniset $ZUN_CONF keystone_authtoken user_domain_id default
|
|
||||||
iniset $ZUN_CONF keystone_authtoken project_domain_id default
|
|
||||||
|
|
||||||
Clone and install the zun client::
|
|
||||||
|
|
||||||
cd ~
|
|
||||||
git clone https://git.openstack.org/openstack/python-zunclient
|
|
||||||
cd python-zunclient
|
|
||||||
sudo pip install -e .
|
|
||||||
|
|
||||||
Install docker::
|
|
||||||
|
|
||||||
curl -fsSL https://get.docker.com/ | sudo sh
|
|
||||||
sudo usermod -a -G docker $(whoami)
|
|
||||||
|
|
||||||
Configure the database for use with zun. Please note that DB migration
|
|
||||||
does not work for SQLite backend. The SQLite database does not
|
|
||||||
have any support for the ALTER statement needed by relational schema
|
|
||||||
based migration tools. Hence DB Migration will not work for SQLite
|
|
||||||
backend::
|
|
||||||
|
|
||||||
zun-db-manage upgrade
|
|
||||||
|
|
||||||
Configure the keystone endpoint::
|
|
||||||
|
|
||||||
openstack service create --name=zun \
|
|
||||||
--description="Zun Container Service" \
|
|
||||||
container
|
|
||||||
openstack endpoint create --publicurl http://127.0.0.1:9512/v1 \
|
|
||||||
--adminurl http://127.0.0.1:9512/v1 \
|
|
||||||
--internalurl http://127.0.0.1:9512/v1 \
|
|
||||||
--region=RegionOne \
|
|
||||||
container
|
|
||||||
|
|
||||||
Start the API service in a new screen::
|
|
||||||
|
|
||||||
sg docker zun-api
|
|
||||||
|
|
||||||
Start the compute service in a new screen::
|
|
||||||
|
|
||||||
sg docker zun-compute
|
|
||||||
|
|
||||||
Zun should now be up and running!
|
|
||||||
|
|
||||||
Using the service
|
Using the service
|
||||||
=================
|
=================
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user