From 28490a221e0d0ab66c254f646cf910b2d72953a5 Mon Sep 17 00:00:00 2001 From: Bogdan Dobrelya Date: Wed, 18 Oct 2017 13:14:03 +0200 Subject: [PATCH] Update containerized undercloud deployment guide * Add a ref to undecloud installing steps for containerized underclouds as well. * Add hints for reqiured repos configuration and official docker documentation as well. * Add a warning for the repo config docs to not add last known master repos when deploying from stable releases. * Add notes for required env vars to be exported/substituted. * Add a step for the required host services to be started. * Add a step for preparing containers images. Related-bug: #1723003 Change-Id: Id358cbdf93c157a5be28e712ad80be5f46623678 Signed-off-by: Bogdan Dobrelya --- .../containers_deployment/overcloud.rst | 2 ++ .../containers_deployment/undercloud.rst | 35 +++++++++++++++---- doc/source/install/repositories.txt | 3 ++ 3 files changed, 33 insertions(+), 7 deletions(-) diff --git a/doc/source/install/containers_deployment/overcloud.rst b/doc/source/install/containers_deployment/overcloud.rst index 96360277..85dc0a2c 100644 --- a/doc/source/install/containers_deployment/overcloud.rst +++ b/doc/source/install/containers_deployment/overcloud.rst @@ -29,6 +29,8 @@ This section explains how to deploy a containerized overcloud manually. For an automated overcloud deployment, please follow the steps in the `Using TripleO Quickstart`_ section below. +.. _prepare-environment-containers: + Preparing the environment ~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/doc/source/install/containers_deployment/undercloud.rst b/doc/source/install/containers_deployment/undercloud.rst index 8e8fdd9e..352204a3 100644 --- a/doc/source/install/containers_deployment/undercloud.rst +++ b/doc/source/install/containers_deployment/undercloud.rst @@ -37,9 +37,10 @@ Preparing the environment ~~~~~~~~~~~~~~~~~~~~~~~~~ Prepare a host (either baremetal or VM) following the normal undercloud -provisioning steps and stop right before the undercloud install command. This -should leave you with an updated base operating system with no openstack -packages installed. +provisioning steps (see :doc:`../installation/installing`) and stop right before +the undercloud install command. This should leave you with an updated base +operating system with no openstack packages installed but required repositories +configured. Make sure these packages are installed before proceeding with the undercloud installation: @@ -50,10 +51,17 @@ installation: * docker >= 1.12.5 * openvswitch (minimum version supported by neutron) +See also +`Docker installation documentation `_. + +Start the required host services:: + + $ sudo systemctl start openvswitch + $ sudo systemctl start docker + Verify that your docker environment is up and that your user can use sudo:: - $ sudo docker ps -a - + $ sudo docker info .. note:: Check the :ref:`debug-containers` section for more tips and tricks for debugging containers. @@ -87,12 +95,24 @@ right path):: UndercloudNameserver: 8.8.8.8 NeutronServicePlugins: "" +Preparing container images +-------------------------- + +Images for undercloud services should be prepared with the +``openstack overcloud container image prepare`` command. The process is very +similar to the containerized overcloud case, see +:ref:`prepare-environment-containers`. The simplified command looks like:: + + $ openstack overcloud container image prepare \ + --env-file $HOME/docker_registry.yaml Deploying the undercloud ~~~~~~~~~~~~~~~~~~~~~~~~ The following command will install an undercloud with ironic, mistral and zaqar -(substitute $THT_ROOT with the right path):: +(substitute $THT_ROOT with the right path, which is normally +`/usr/share/openstack-tripleo-heat-templates`, and $YOUR_SERVER_IP with your +server's private IP):: $ sudo openstack undercloud deploy \ --templates=$THT_ROOT \ @@ -103,7 +123,8 @@ The following command will install an undercloud with ironic, mistral and zaqar -e $THT_ROOT/environments/services-docker/zaqar.yaml \ -e $THT_ROOT/environments/docker.yaml \ -e $THT_ROOT/environments/mongodb-nojournal.yaml \ - -e $HOME/custom.yaml + -e $HOME/custom.yaml \ + -e $HOME/docker_registry.yaml The `keep-running` flag will keep the `openstack undercloud deploy` process diff --git a/doc/source/install/repositories.txt b/doc/source/install/repositories.txt index a739e110..3891f192 100644 --- a/doc/source/install/repositories.txt +++ b/doc/source/install/repositories.txt @@ -79,6 +79,9 @@ sudo yum -y install --enablerepo=extras centos-release-ceph-jewel sudo sed -i -e 's%gpgcheck=.*%gpgcheck=0%' /etc/yum.repos.d/CentOS-Ceph-Jewel.repo +.. warning:: + The remaining repositories configuration steps below should not be done for stable + releases! Enable last known good RDO Trunk Delorean repository for core openstack packages