From 67404b21e17a1f77daea5fd891b11c5ec04d97ca Mon Sep 17 00:00:00 2001 From: Nguyen Hai Date: Wed, 14 Feb 2018 17:03:04 +0900 Subject: [PATCH] Update the Devstack Tacker install guide & local.conf.example For stable/queens. Change-Id: I6d8d1bbe54b1a382fcbf83a1aef1fa389c43c1fc (cherry picked from commit 4cddc815c2b9ae06103ed48ad4f8b3edc6313d0e) --- devstack/local.conf.example | 42 ++++------- doc/source/install/devstack.rst | 123 ++++++++++++++++++++++++++++++-- 2 files changed, 131 insertions(+), 34 deletions(-) diff --git a/devstack/local.conf.example b/devstack/local.conf.example index bb88a05a9..3bf122252 100644 --- a/devstack/local.conf.example +++ b/devstack/local.conf.example @@ -28,50 +28,38 @@ ENABLE_DEBUG_LOG_LEVEL=True ENABLE_VERBOSE_LOG_LEVEL=True # Neutron ML2 with OpenVSwitch - Q_PLUGIN=ml2 Q_AGENT=openvswitch -#Disable security groups +# Disable security groups Q_USE_SECGROUP=False LIBVIRT_FIREWALL_DRIVER=nova.virt.firewall.NoopFirewallDriver -#NET K8S NETWORK CONFIGURATION -#FIXED_RANGE_K8S=${FIXED_RANGE_K8S:-192.168.72.0/22} -#NETWORK_GATEWAY_K8S=${NETWORK_GATEWAY_K8S:-192.168.72.1} -#NETWORK_GATEWAY_K8S_IP=${NETWORK_GATEWAY_K8S_IP:-192.168.72.1/24} - -# Required for l3-agent to connect to external-network-bridge -PUBLIC_BRIDGE=br-ext - # Enable heat, networking-sfc, barbican and mistral -enable_plugin heat https://git.openstack.org/openstack/heat master -enable_plugin networking-sfc git://git.openstack.org/openstack/networking-sfc master -enable_plugin barbican https://git.openstack.org/openstack/barbican master -enable_plugin mistral https://git.openstack.org/openstack/mistral master +enable_plugin heat https://git.openstack.org/openstack/heat stable/queens +enable_plugin networking-sfc git://git.openstack.org/openstack/networking-sfc stable/queens +enable_plugin barbican https://git.openstack.org/openstack/barbican stable/queens +enable_plugin mistral https://git.openstack.org/openstack/mistral stable/queens -#Ceilometer +# Ceilometer #CEILOMETER_PIPELINE_INTERVAL=300 -enable_plugin ceilometer https://git.openstack.org/openstack/ceilometer master -enable_plugin aodh https://git.openstack.org/openstack/aodh master +enable_plugin ceilometer https://git.openstack.org/openstack/ceilometer stable/queens +enable_plugin aodh https://git.openstack.org/openstack/aodh stable/queens -#Tacker -enable_plugin tacker https://git.openstack.org/openstack/tacker master +# Tacker +enable_plugin tacker https://git.openstack.org/openstack/tacker stable/queens enable_service n-novnc enable_service n-cauth disable_service tempest -#TACKER CONFIGURATION -USE_BARBICAN=True - # Enable Kubernetes and kuryr-kubernetes -KUBERNETES_VIM=True -NEUTRON_CREATE_INITIAL_NETWORKS=False -enable_plugin kuryr-kubernetes https://git.openstack.org/openstack/kuryr-kubernetes master -enable_plugin neutron-lbaas git://git.openstack.org/openstack/neutron-lbaas master -enable_plugin devstack-plugin-container https://git.openstack.org/openstack/devstack-plugin-container master +#KUBERNETES_VIM=True +#NEUTRON_CREATE_INITIAL_NETWORKS=False +#enable_plugin kuryr-kubernetes https://git.openstack.org/openstack/kuryr-kubernetes stable/queens +#enable_plugin neutron-lbaas git://git.openstack.org/openstack/neutron-lbaas stable/queens +#enable_plugin devstack-plugin-container https://git.openstack.org/openstack/devstack-plugin-container stable/queens [[post-config|/etc/neutron/dhcp_agent.ini]] [DEFAULT] diff --git a/doc/source/install/devstack.rst b/doc/source/install/devstack.rst index 6874cba6b..3dc2f02ed 100644 --- a/doc/source/install/devstack.rst +++ b/doc/source/install/devstack.rst @@ -19,17 +19,110 @@ Install via Devstack ==================== -The devstack supports installation from different code branch by specifying +The Devstack supports installation from different code branch by specifying below. If there is no preference, it is recommended to install -Tacker from master branch, i.e. the is master. If pike branch -is the target branch, the is stable/pike. +Tacker from master branch, i.e. the is master. If queens branch +is the target branch, the is stable/queens. -1. Download DevStack:: +1. Download DevStack: + +.. code-block:: console $ git clone https://git.openstack.org/openstack-dev/devstack -b $ cd devstack -2. Enable tacker related devstack plugins in ``local.conf`` file:: +.. + +2. Enable tacker related Devstack plugins in **local.conf** file: + +First, the **local.conf** file needs to be created by manual or copied from +Tacker Repo [#f1]_ and renamed to **local.conf**. We have two Tacker +configuration installation files. First, it is the all-in-one mode that +installs full Devstack environment including Tacker in one PC or Laptop. +Second, it is the standalone mode which only will install a standalone +Tacker environment with some mandatory OpenStack services. + +2.1. All-in-one mode + +The **local.conf** file of all-in-one mode from [#f2]_ is shown as below: + +.. code-block:: ini + + [[local|localrc]] + ############################################################ + # Customize the following HOST_IP based on your installation + ############################################################ + HOST_IP=127.0.0.1 + + ADMIN_PASSWORD=devstack + MYSQL_PASSWORD=devstack + RABBIT_PASSWORD=devstack + SERVICE_PASSWORD=$ADMIN_PASSWORD + SERVICE_TOKEN=devstack + + ############################################################ + # Customize the following section based on your installation + ############################################################ + + # Pip + PIP_USE_MIRRORS=False + USE_GET_PIP=1 + + #OFFLINE=False + #RECLONE=True + + # Logging + LOGFILE=$DEST/logs/stack.sh.log + VERBOSE=True + ENABLE_DEBUG_LOG_LEVEL=True + ENABLE_VERBOSE_LOG_LEVEL=True + + # Neutron ML2 with OpenVSwitch + Q_PLUGIN=ml2 + Q_AGENT=openvswitch + + # Disable security groups + Q_USE_SECGROUP=False + LIBVIRT_FIREWALL_DRIVER=nova.virt.firewall.NoopFirewallDriver + + # Enable heat, networking-sfc, barbican and mistral + enable_plugin heat https://git.openstack.org/openstack/heat stable/queens + enable_plugin networking-sfc git://git.openstack.org/openstack/networking-sfc stable/queens + enable_plugin barbican https://git.openstack.org/openstack/barbican stable/queens + enable_plugin mistral https://git.openstack.org/openstack/mistral stable/queens + + # Ceilometer + #CEILOMETER_PIPELINE_INTERVAL=300 + enable_plugin ceilometer https://git.openstack.org/openstack/ceilometer stable/queens + enable_plugin aodh https://git.openstack.org/openstack/aodh stable/queens + + # Tacker + enable_plugin tacker https://git.openstack.org/openstack/tacker stable/queens + + enable_service n-novnc + enable_service n-cauth + + disable_service tempest + + # Enable Kubernetes and kuryr-kubernetes + #KUBERNETES_VIM=True + #NEUTRON_CREATE_INITIAL_NETWORKS=False + #enable_plugin kuryr-kubernetes https://git.openstack.org/openstack/kuryr-kubernetes stable/queens + #enable_plugin neutron-lbaas git://git.openstack.org/openstack/neutron-lbaas stable/queens + #enable_plugin devstack-plugin-container https://git.openstack.org/openstack/devstack-plugin-container stable/queens + + [[post-config|/etc/neutron/dhcp_agent.ini]] + [DEFAULT] + enable_isolated_metadata = True + +.. + + +2.2. Standalone mode + +The **local.conf** file of standalone mode from [#f3]_ is shown as below: + +.. code-block:: ini [[local|localrc]] ############################################################ @@ -54,12 +147,28 @@ is the target branch, the is stable/pike. TACKER_MODE=standalone USE_BARBICAN=True - TACKER_BRANCH= + TACKER_BRANCH=stable/queens enable_plugin networking-sfc ${GIT_BASE}/openstack/networking-sfc $TACKER_BRANCH enable_plugin barbican ${GIT_BASE}/openstack/barbican $TACKER_BRANCH enable_plugin mistral ${GIT_BASE}/openstack/mistral $TACKER_BRANCH enable_plugin tacker ${GIT_BASE}/openstack/tacker $TACKER_BRANCH -3. Run ``stack.sh``:: +.. + +3. Installation + +After saving the **local.conf**, we can run **stack.sh** in the terminal +to start setting up: + +.. code-block:: console $ ./stack.sh + +.. + +.. rubric:: Footnotes + +.. [#f1] https://github.com/openstack/tacker/tree/stable/queens/devstack +.. [#f2] https://github.com/openstack/tacker/blob/stable/queens/devstack/local.conf.example +.. [#f3] https://github.com/openstack/tacker/blob/stable/queens/devstack/local.conf.standalone +