Commit Graph

37 Commits

Author SHA1 Message Date
Matt Crees 6552df2b51 docs: Add note on SLURP upgrades
Change-Id: I48126b77254a74a030aabf5db0c68c04ecf41847
2024-03-14 14:46:31 +00:00
Pierre Riteau 6e78aa8914 Replace references to Docker Hub by Quay.io
Kolla Ansible uses Quay.io as its default registry.

Change-Id: Ie1a56ebd6fe3283a2b5b077f658ff1cf3e006784
2023-01-06 11:11:46 +01:00
Pierre Riteau ee25470b01 docs: add missing word
Change-Id: I0289a0868b916a14c69fbab414335e7de6b17380
2023-01-05 06:48:34 +01:00
Pierre Riteau 5c1cdf889b Add note about Zed upgrade using Rocky Linux 9
This replaces the note about upgrading to CentOS Stream 8.

Change-Id: If550a604403fa67e3b6062428cd82032217e545c
2022-12-24 16:11:19 +01:00
Pierre Riteau 0eac03235c Update documentation about CentOS support
Change-Id: I0747cc8fa6fdbfa980b1263da3b3edddb725d2db
2022-01-11 11:51:37 +01:00
Pierre Riteau 0f2b104213 Bump up Ansible supported versions
This change bumps up the maximum supported Ansible version to 4.x
(ansible-core 2.11.x) and minimum to 2.10. This synchronises Kayobe with
Kolla Ansible (see change I8b9212934dfab3831986e8db55671baee32f4bbd).

Uses of docker_image are updated. We must now provide the source
parameter. When source is build (for molecule), we replace force by
force_source and force_tag and move path and dockerfile under the build
parameter.

Use docker_image_info instead of docker_image_facts.

Handle update of ansible inside kolla-ansible virtualenv and document
how to do it for the kayobe virtualenv.

Change-Id: I7a4530f4f63ddb37aa30a617db5944b97bc3e17f
2021-09-29 22:31:33 +02:00
Mark Goddard c2b9dd81de docs: fix heading styles in upgrading page
The CentOS Stream 8 section used the wrong heading style, which broke
the rest of the document, making the other headings the wrong sizes.

Change-Id: I8015c905074016c53c803ce40a299ad5c911ada6
2021-08-31 14:20:15 +01:00
Pierre Riteau bca2369894 Remove outdated upgrade step
Migrating to Ironic hardware types was required in Rocky. This can now
be removed from upgrading instructions.

Change-Id: I0510db9fd1b8dd72540c83173267491b32728330
2021-06-17 16:10:57 +02:00
Mark Goddard 0ce6ea2ee2 docs: add reno and upgrade info for CentOS Stream
Story: 2008795
Task: 42459

Change-Id: I1f55a2f47ac614fea983e19802e469efd810e849
2021-05-12 10:41:58 +01:00
Pierre Riteau f3c0526c09 Adapt to changes from the Bifrost Victoria release
The critical part of this commit is adapting code that was still
sourcing env-vars. This file was removed from Bifrost in the Victoria
release, breaking the `kayobe seed deployment image build` command.

The other changes are not yet breaking Kayobe:

1) Release notes claim that OpenStackClient is no longer installed when
   keystone is not enabled, but it appears to still be available. Use
   the ironic native baremetal command instead except in playbooks
   related to baremetal compute nodes (i.e. overcloud ironic).

2) The use of OS_CLOUD=bifrost-inspector is deprecated and should be
   replaced by OS_CLOUD=bifrost.

Change-Id: I25078e69acdf41a4ef9957f99fe5047de54b778d
Story: 2008558
Task: 41696
2021-01-27 11:00:36 +01:00
Pierre Riteau 61114cda4a Document that kolla_tag may need to be changed when upgrading
Change-Id: Iafc90c50e0596970322c4dfa775594dadab6e260
2020-09-04 15:22:40 +02:00
Zuul 3bd981508a Merge "Use versioned links to OpenStack documentation" 2019-12-09 11:14:02 +00:00
Zuul e1d4774fdc Merge "Improve docs on updating the Ansible control host" 2019-11-25 14:17:01 +00:00
Mark Goddard 410466bb5c Improve docs on updating the Ansible control host
Also reorder upgrade documentation to make it clear that configuration
migration is something that should be done as a preparatory task.

Change-Id: I97ada3c6fd94a9ab7b5add97e90717f2a56bc8f3
Story: 2006677
Task: 36953
2019-11-25 13:57:23 +00:00
Mark Goddard 8c1f3af579 Use versioned links to OpenStack documentation
The :project-doc: format is part of the openstackdocstheme, and allows
us to link to the same release of the documentation for other projects,
without having to keep our links in sync.

Change-Id: Ifff2fd2d4e3680a9a757d77928acf84b7e5a3dd7
2019-11-11 14:26:58 +00:00
Mark Goddard ee98efa8f0 Remove some references to Github
Change-Id: I358585260cc85fb1d364d2e246656557a2398ef9
2019-10-31 17:17:35 +00:00
Mark Goddard 7321205c06 Update docs after repo rename x/ to openstack/
Depends-On: https://review.opendev.org/669298
Change-Id: Ia4138179132d3a284b0c4bcc882b87bde22c9cc4
2019-09-16 17:39:29 +01:00
Pierre Riteau 4b42743604 Fix typo in upgrade documentation
Change-Id: I6164d9f1d89a3d8124922f3bac9c4bea1b505e45
2019-08-02 14:43:06 +02:00
Pierre Riteau 460c6751f4 Change examples to apply all security-related package updates
This is more representative of the typical use case of applying all
security-related package updates rather than just specific ones.

Also escape `*`, since most people will need to do so in their shell.

Change-Id: Ibd602b7fe30d7c6eb7c81b5f028ab6b5852da988
2019-07-12 19:05:47 +02:00
Pierre Riteau 8e69fb0ae8 Add command to update packages on the seed hypervisor host
Change-Id: I6edda0527a892c55261cc6fc48a0feb899b348d6
2019-06-07 16:36:28 +01:00
Pierre Riteau 17d63c8b99 Correct statement about default kolla images
Kayobe has been using upstream kolla images by default since the Queens
release, as configured by the `kolla_docker_namespace` variable.

Change-Id: Ib56256abbadf0b5f22ef7780af2b9de63a8f157a
2019-05-31 12:45:02 +01:00
Radosław Piliszek d8c6fa307f Fix two links in the docs pointing to repo on github (moved to opendev)
Change-Id: I793251519a5da0e3d1225673c9b3394e738f4336
Signed-off-by: Radosław Piliszek <radoslaw.piliszek@gmail.com>
2019-05-24 16:56:04 +02:00
Will Szumski 84172bfbe0 Support complete installation of Kayobe as a python package
This adds the ansible playbooks required by kayobe to the manifest by
using the data_files option in setuptools. When using pip to install
kayobe into a virtualenv, these files will be placed in
<venv>/kayobe/share/.

In an editable install, e.g using `pip install -e .`, data_files are not
installed into the virtualenv. Instead, we must follow the egg-link file
to find out the actual location.

Story: 2004252
Task: 27787
Change-Id: Ibef040eceb547476007f83c0d5dcdb2bc6986d1e
2019-02-01 12:55:27 +00:00
Mark Goddard 6496af1f67 Add kayobe seed service upgrade command
Adds a new command to upgrade containerised services on the seed:

kayobe seed service upgrade

This is largely the same as the deploy command, since there is no
kolla-ansible bifrost-upgrade command yet.

A limitation in Bifrost requires us to remove IPA images before
upgrading the bifrost container.

Change-Id: Ibbe01e972487e69dbb753a67efcf13e3ae0800de
Story: 2004308
Task: 27872
2018-12-21 15:21:30 +00:00
Zuul 4f829bf6ae Merge "Add host package update to upgrade procedures" 2018-10-08 15:37:31 +00:00
Mark Goddard ef84890798 Fix IPA image download
The IPA ramdisk and kernel images may be built or downloaded via a URL.
If the latter option is used, any images previously downloaded to
$KOLLA_CONFIG_PATH/config/ironic/ironic-agent.* would previously not be
updated if the image contents change.

This change introduces variables for setting a URL to a file containing
checksums for the images. The algorithm used to compute the checksum is
also configurable (default sha256). This allows us to ensure we are
using the correct version of the image, while avoiding an expensive few
hundred megabyte image download just to check.

If a checksum is not specified, the image will be downloaded every time
to ensure that it is up to date.

Change-Id: I8120518ed98d61f3652f5205ce7ec9f798ab2aa1
Story: 2001660
Task: 6693
2018-10-02 13:30:11 +01:00
Mark Goddard 601b94dc33 Add host package update to upgrade procedures
This is an optional step that may be desirable to perform prior to
upgrading Kolla containers.

Change-Id: Ibe30c5a252508a4aa1b24d9484456f90532b8af7
Story: 2003305
Task: 24257
2018-09-05 13:36:37 +01:00
Mark Goddard 1b5d05dc2e Update ironic IPA deployment images
This will update the the deploy_ramdisk and
deploy kernel properties of  'Driver info'
field on Ironic nodes if the locally built
or externally referenced images are updated.

Change-Id: Id3997db452dde6e6e242a9b1091cb219c53ebda1
2018-09-03 15:29:58 +01:00
Will Miller 2d5fd703a0 Reconcile all 'Ansible control host' references
Ensure all references to the Ansible control host are worded as such, to
ensure consistency and avoid potential confusion with the OpenStack
controllers.

Change-Id: Id92e537ccbfdd55287b8eae296f649640c70ce17
2018-07-11 17:19:18 +01:00
Mark Goddard 97905f98b6 Update kayobe-config repo URL to openstack/kayobe-config
The kayobe-config repo is now under the openstack git namespace.

Change-Id: I3e29d33accc947473d0d2c6a01f2c1d5c823a197
Story: 2001637
Task: 19738
2018-05-21 09:20:21 +01:00
Mark Goddard 7f04e9ccc6 Create and install virtualenvs on seed/seed-hv/overcloud host upgrade
Adds two new commands:

kayobe seed hypervisor host upgrade
kayobe seed host upgrade

These commands can be used prior to performing an upgrade, in addition
to the existing command 'kayobe overcloud host upgrade'. These commands
will ensure that if kayobe and kolla-ansible remote virtualenvs are in
use, they exist and have all dependencies installed.
2017-12-19 16:32:48 +00:00
Mark Goddard 454de62d6d Update documentation for new control host directory layout 2017-09-20 17:57:19 +01:00
Mark Goddard 7bc0274aa3 Add documentation on generating and saving overcloud service configuration 2017-09-20 17:11:37 +01:00
Mark Goddard 0840319d20 Add deployment image build to upgrade guide 2017-09-19 11:04:41 +01:00
Mark Goddard 0c03d18626 Add kayobe overcloud host upgrade
This command performs necessary changes on the host to prepare the control
plane for an upgrade.

Currently this performs a workaround for issue #14, RabbitMQ upgrade failure.

We clear stale entries from /etc/hosts on the overcloud hosts and from the
rabbitmq containers, which allows the upgrade to complete successfully. The
source of the stale entries is currently unknown.
2017-09-18 13:04:27 +01:00
Mark Goddard 4507077bc4 Add a note on upgrading ironic deployment images 2017-07-11 17:49:41 +01:00
Mark Goddard 64466522e8 Add an upgrade guide 2017-07-11 17:49:41 +01:00