User docs for minor updates in Rocky+
Change-Id: Ie95f94ef01cc78ac9b06c749c9058b7b51d70fa1
This commit is contained in:
parent
d9e0892ab2
commit
795593c622
|
@ -66,6 +66,7 @@
|
||||||
.ocata {background: #edd;}
|
.ocata {background: #edd;}
|
||||||
.pike {background: #dfb;}
|
.pike {background: #dfb;}
|
||||||
.queens {background: #afd;}
|
.queens {background: #afd;}
|
||||||
|
.rocky {background: #aee;}
|
||||||
.centos {background: #fef;}
|
.centos {background: #fef;}
|
||||||
.baremetal {background: #eef;}
|
.baremetal {background: #eef;}
|
||||||
.virtual {background: #efe;}
|
.virtual {background: #efe;}
|
||||||
|
@ -74,7 +75,7 @@
|
||||||
.ntoo {background: #edd;}
|
.ntoo {background: #edd;}
|
||||||
.otop {background: #dfb;}
|
.otop {background: #dfb;}
|
||||||
.ptoq {background: #afd;}
|
.ptoq {background: #afd;}
|
||||||
.qtor {background: #dee;}
|
.qtor {background: #aee;}
|
||||||
.validations {background: #fdd;}
|
.validations {background: #fdd;}
|
||||||
.optional {background: #ffe;}
|
.optional {background: #ffe;}
|
||||||
|
|
||||||
|
|
|
@ -28,10 +28,22 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
RPMs. If you use stable RDO repositories, you don't need to change
|
RPMs. If you use stable RDO repositories, you don't need to change
|
||||||
anything.
|
anything.
|
||||||
|
|
||||||
Fetch latest container images to your undercloud registry and
|
Update container image parameter files:
|
||||||
generate a Heat environment file pointing to new container
|
|
||||||
images. This is done via workflow described in
|
.. admonition:: Queens
|
||||||
:doc:`containerized deployment documentation<../containers_deployment/overcloud>`.
|
:class: queens
|
||||||
|
|
||||||
|
Fetch latest container images to your undercloud registry and
|
||||||
|
generate a Heat environment file pointing to new container
|
||||||
|
images. This is done via workflow described in
|
||||||
|
:doc:`containerized deployment documentation<../containers_deployment/overcloud>`.
|
||||||
|
|
||||||
|
.. admonition:: Rocky
|
||||||
|
:class: rocky
|
||||||
|
|
||||||
|
Prepare an environment file with new ``ContainerImagePrepare``
|
||||||
|
parameter. This is done via a command described in
|
||||||
|
:doc:`container image preparation documentation<../advanced_deployment/container_image_prepare>`.
|
||||||
|
|
||||||
#. **Update preparation**
|
#. **Update preparation**
|
||||||
|
|
||||||
|
@ -41,12 +53,18 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
|
|
||||||
openstack overcloud update prepare \
|
openstack overcloud update prepare \
|
||||||
<OPTIONS> \
|
<OPTIONS> \
|
||||||
-e container-params.yaml
|
-e containers-prepare-parameter.yaml
|
||||||
|
|
||||||
In place of the `<OPTIONS>` token should go all parameters that you
|
In place of the `<OPTIONS>` token should go all parameters that you
|
||||||
used with previous `openstack overcloud deploy` command. The last
|
used with previous `openstack overcloud deploy` command.
|
||||||
argument `container-params.yaml` is a Heat environment file
|
|
||||||
pointing to new container images, obtained in previous step.
|
The last argument `containers-prepare-parameter.yaml` differs in
|
||||||
|
content depending on release. In Queens and before, it has a list
|
||||||
|
of individual container image parameters, pointing to images you've
|
||||||
|
already uploaded to local registry in previous step. In Rocky and
|
||||||
|
beyond, this file contains the ``ContainerImagePrepare`` parameter.
|
||||||
|
The upload of images to local registry is yet to happen, in a
|
||||||
|
separate step after `update prepare`.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
@ -58,15 +76,25 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
The `container-params.yaml` file is intended to replace any
|
The `containers-prepare-parameter.yaml` file is intended to
|
||||||
previous container parameters file. You should drop the previous
|
replace any previous container parameters file. You should drop
|
||||||
container parameters file and pass the new one for any
|
the previous container parameter file and pass the new one for
|
||||||
subsequent stack update operations.
|
any subsequent stack update operations.
|
||||||
|
|
||||||
The `update prepare` command temporarily disables config management
|
The `update prepare` command updates the Heat stack outputs with
|
||||||
operations that would be normally performed on a Heat stack update,
|
Ansible snippets used in the next steps of the update.
|
||||||
and it updates the stack outputs with Ansible snippets used in the
|
|
||||||
next step of the update.
|
#. **Container image upload**
|
||||||
|
|
||||||
|
.. admonition:: Rocky
|
||||||
|
:class: rocky
|
||||||
|
|
||||||
|
In Rocky and beyond, we'll need to upload the container images
|
||||||
|
to the local registry at this point. Run:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
openstack overcloud external-update run --tags container_image_prepare
|
||||||
|
|
||||||
#. **Update run**
|
#. **Update run**
|
||||||
|
|
||||||
|
@ -95,7 +123,7 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
releases:
|
releases:
|
||||||
|
|
||||||
.. admonition:: Queens
|
.. admonition:: Queens
|
||||||
:class: ptoq
|
:class: queens
|
||||||
|
|
||||||
Run:
|
Run:
|
||||||
|
|
||||||
|
@ -120,7 +148,7 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
the rolling update playbook of the Ceph installer (`ceph-ansible`).
|
the rolling update playbook of the Ceph installer (`ceph-ansible`).
|
||||||
|
|
||||||
.. admonition:: Rocky
|
.. admonition:: Rocky
|
||||||
:class: qtor
|
:class: rocky
|
||||||
|
|
||||||
Run:
|
Run:
|
||||||
|
|
||||||
|
@ -151,10 +179,10 @@ the OpenStack release that you currently operate, perform these steps:
|
||||||
data, and network data). This is crucial in order to keep
|
data, and network data). This is crucial in order to keep
|
||||||
correct state of the stack.
|
correct state of the stack.
|
||||||
|
|
||||||
The `update converge` command re-enables config management
|
The `update converge` command updates Heat stack outputs with
|
||||||
operations previously disabled by `update prepare`, and it runs the
|
Ansible snippets the same way as `overcloud deploy` would, and it
|
||||||
config management operations to assert that the overcloud state
|
runs the config management operations to assert that the overcloud
|
||||||
matches the used overcloud templates.
|
state matches the used overcloud templates.
|
||||||
|
|
||||||
Updating your Overcloud - Pike
|
Updating your Overcloud - Pike
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
Loading…
Reference in New Issue