Open Stack

We enthusiastically announce the release of:

python-tripleoclient 16.5.0: TripleO client

This release is part of the wallaby stable release series.

The source is available from:

    https://opendev.org/openstack/python-tripleoclient

Download the package from:

    https://tarballs.openstack.org/python-tripleoclient/

Please report issues through:

    https://bugs.launchpad.net/tripleo/+bugs

For more details, please see below.

16.5.0
^^^^^^


Prelude
*******

During a minor update of the overcloud. It was previously necessary to
execute 3 steps. - Update Prepare - Update Run - Update Converge
Starting in W, it is no longer necessary to perform a Stack update
during the converge. This change removes the stack update from the
converge step. Now, we will just run the deploy_steps_playbook
instead.


New Features
************

* Added options for "overcloud delete" command to unprovision
  networks provisioned with "overcloud deploy" or with "overcloud
  network provision".

* Added options for "overcloud delete" command to unprovision nodes
  and network ports provisioned with "overcloud deploy".

* The Admin Authorize command can now be targeted at specific nodes
  using '--limit'. It can also take a custom static-inventory using '
  --static-inventory'.

* The commands *openstack overcloud node import* and *openstack
  overcloud node configure* now have a --boot-mode arguement which
  allows the boot mode for all affected nodes to be set to UEFI boot
  (uefi) or legacy BIOS boot (bios). This allows some nodes to have a
  different boot mode to the default (uefi).

* Two new commands, "openstack overcloud ceph user enable" and
  "openstack overcloud ceph user disable" are added. The "enable"
  option will create the cephadm SSH user and distribute their SSH
  keys to Ceph nodes in the overcloud. The "disable" option may be run
  after "openstack overcloud ceph deploy" has been run to disable
  cephadm so that it may not be used to administer the Ceph cluster
  and no "ceph orch ..." CLI commands will function. This will also
  prevent Ceph node overcloud scale operations though the Ceph cluster
  will still be able to read/write data. The "ceph user disable"
  option will also remove the public and private SSH keys of the
  cephadm SSH user on overclouds which host Ceph. The "ceph user
  enable" option may also be used to re-distribute the public and
  private SSH keys of the cephadm SSH user and re-enable the cephadm
  mgr module.

* A new command "openstack overcloud ceph deploy" is added. The
  command is used to deploy Ceph after the hardware has been
  provisioned with networking and before the overcloud is deployed.
  The command takes the output of "openstack overcloud node provision"
  as input and returns a Heat enviornment file, e.g.
  deployed_ceph.yaml, as output. The deployed_ceph.yaml file may then
  be passed to the "openstack overcloud deploy" command as input.
  During overcloud deployment the Ceph cluster is then configured to
  host OpenStack. E.g. cephx keys and pools are still created on the
  Ceph cluster by "openstack overcloud deploy".

* The cli arguments that control what parts of the deployment to
  execute have been refactored to better align with the user expected
  intention, --stack-only: create the stack, download the config. no
  overcloud node changes --setup-only: ssh admin authorization setup.
  --config-download-only: run config-download playbook(s) to configure
  the overcloud.


Deprecation Notes
*****************

* The "--local" argument to the "openstack overcloud image upload"
  command has been deprecated and a "--no-local" argument has been
  added. Earlier we used to fallback to upload locally when glance was
  not available. As glance is not installed in the undercloud by
  default, we would upload images locally unless "--no-local" is used.

* The "openstack tripleo validator" CLI has been deprecated in favor
  the "validation" CLI.

     +--------------------------------------------+---------------------------+
     | Old CLI sub commands                       | New CLI sub commands      |
     +--------------------------------------------+---------------------------+
     | openstack tripleo validator list           | validation list           |
     | openstack tripleo validator show           | validation show           |
     | openstack tripleo validator group info     | validation show group     |
     | openstack tripleo validator show parameter | validation show parameter |
     | openstack tripleo validator show history   | validation history list   |
     | openstack tripleo validator show run       | validation history get    |
     +--------------------------------------------+---------------------------+


Bug Fixes
*********

* Fixes Admin Authorize to work with Ephemeral Heat.


Other Notes
***********

* Stack outputs that are needed by other functionality of the
  overcloud deployment are now saved in the stack working directory in
  an outputs subdirectory (default ~/overcloud-
  deploy/<stack>/outputs).

Changes in python-tripleoclient 16.4.0..16.5.0
----------------------------------------------

6c76392b Changing MD5 hash to SHA512
015e0226 Adding --repo-dir argument
fe6ed229 Fix overcloud node provide
96fae228 Check old passwords file path during uc validation
0aefaf3f Write clouds.yaml/heatrc for tripleo launch heat
c8701473 Fix deploy templates arg validation
60ce1c06 Use 127.0.0.1 for ephemeral Heat server instead of ctlplane ip
c41459a6 Handle missing ipv6 boolean in network_data.yaml for Ceph
c2e4b487 overcloud node extract provisioned - fixed_ips
4e2ba687 node extract provisioned - use network_config_update
86483150 Don't assume json network config in validations
a1912be8 Don't set 'subnet' for ctlplane in node extract
8aeed5ec Don't run playbooks if role count == 0
003c96b9 Add the ability to enable/disable cephadm SSH user
06a82e0e make net_config_override of undercloud.conf work with yaml
eadbcec0 Use netaddr when comparing local_ip for changes
8223cb7c Fix ports cleanup on node unprovision
8baae032 Skip Heat pod container image pull for default ephemeral heat images
fa9dcd54 Pass crush hierarchy data as extra_var
96d37480 Donot install policycoreutils-python for cs9
e84c2e11 Fix the validations_log_basedir overriding
1de4a4e3 Set Ceph ms_bind options for IPv6
ac828a2c Support custom network names with deployed ceph
7dc140b7 bnr CLI enable the conf. of ReaR with ironic on nodes
7ba9e8b3 [WALLABY-ONLY] Deprecation of the "openstack tripleo validator" CLI
293b8434 UC/Standalone - Set ip_version in DeployedServerPortMap
914709dd Ensure we're using the stackname for the inventory
d71f64ed Integrating restoration process to client
03221f21 Remove --skip-nodes-and-networks
fd18a8ea Replace deprecated params in prepare
d4223329 Remove update converge
bdfcb56d Refactor --stack-only, --setup-only, --config-download-only
e2f3acd1 Add additional saved stack outputs
6da69f44 Save needed stack outputs in working_dir
e5b308ee Fix --stack-only to download ansible playbooks
bcbe3c1f Update playbooks to use consistent working dir
b4cb0064 Fix overcloud admin authorize
71633a13 Fix node scaling for Ephemeral Heat
f43317cb Baremetal deploy - user playbook interface
c22f23a0 Drop minion
3e9c1926 Deprecate and ignore --skip-nodes-and-networks
cfcc4a16 Always run growvols playbook after provision
ce676979 Add --boot-mode to import and configure
d62bdace Only use undercloud.conf ipxe_enabled for inspection
ba988230 Don't write <stack_name>-passwords.conf
8328e7b1 Check for passwords at old path during tripleo deploy
ea2877f1 Image upload: handle whole-disk image as default
6ed5f201 Deprecate overcloud image upload to glance
1e1394a6 Drop python2 logic for upgrades
18a30e62 Use real tmpdir for ansible runner tests
4a0be73b bnr enabled ramdisk as deploy interfaces on the ironic/undercloud
64732f93 Remove ipxe_enabled ppc64le validation
86584175 Remove zaqar
ff41e5dd Remove mistral
42f9f7a4 Deprecate network data v1 definition
3d615ea4 Dynamic defaults for roles, networks, vips and bm
cf63f0da Update deployment status after upgrade converge
e97d9e7b Fix update run for Ephemeral Heat
7b9bf2fe Return "overcloud status" output without debug
b0537457 Update overcloud deploy help for default heat type
592c793f Add `--heat-type` in overcloud delete
ef151db5 Eliminating a race condition in the export_stack function
351bc64f Allow to pass arbitrary parameters to TCIB image config
06c7d4d3 Add network unprovision to overcloud delete
3351ef1c Update default images for "tripleo launch heat"
d35ec2fb New test case and documentation for the export_stack function.
e1c2fc73 Setting upper constraints to wallaby branch of requirements
1450b166 Moving the 'export_data' dict into constants
ea451c4d Add node, port unprovision to overcloud delete
a5d144ff Introduce "openstack overcloud ceph deploy"
e81ced6f Restore kernel and ramdisk arguments to node configure
13f7f2fc Fetch stack after updating it
bf7392db Make the "success" message more "success"-like
b437a87e Workaround py36 encoding pip bug
7e490d4f Use 'all' for ANSIBLE_VARS_PLUGIN_STAGE
a88ba376 Remove deprecation warnings for the role command
06184adb Fix get_deployment_status() for ephemeral heat
035f9b6a Remove name parameter from cell export
2c5b1cc5 Deprecate --network-ports, enable it by default
40e6f60c Implement protected resource types
7f6ac642 Fix 'cell export' no attribute exception


Diffstat (except docs and test files)
-------------------------------------

bindep.txt                                         |   2 +-
...rovision-overcloud-delete-5c36ff706ab809ea.yaml |   5 +
...rovision-overcloud-delete-c7dd063912d4ebca.yaml |   5 +
..._args_for_admin_authorize-2fe6945515dd34a7.yaml |   9 +
releasenotes/notes/boot_mode-ef25d1a032dcae56.yaml |   7 +
...ser_disable_and_re_enable-18f3102031a802d0.yaml |  17 +
...ecate-glance-image-upload-ef23d3078f430ccf.yaml |   9 +
...ack-tripleo-validator-cli-2612ab3234f506b0.yaml |  18 +
...hemeral-heat-minor-update-db24c2f190c1c8a7.yaml |  10 +
.../overcloud_ceph_deploy-485f59b64eb93c70.yaml    |  11 +
.../refactor-only-cli-args-cb70ed8ba8b166a9.yaml   |  10 +
.../notes/save-stack-outputs-61c2ad9528ae2529.yaml |   5 +
releasenotes/source/index.rst                      |   1 +
releasenotes/source/wallaby.rst                    |   6 +
requirements.txt                                   |   2 +-
setup.cfg                                          |  22 +-
tox.ini                                            |  35 +-
tripleoclient/config/minion.py                     | 158 -----
tripleoclient/config/standalone.py                 |  12 +-
tripleoclient/config/undercloud.py                 |   7 +-
tripleoclient/constants.py                         |  47 +-
tripleoclient/exceptions.py                        |   4 +
tripleoclient/export.py                            |  73 +-
tripleoclient/heat_launcher.py                     |  17 +-
tripleoclient/plugin.py                            |  73 --
.../v1/overcloud_deploy/test_overcloud_deploy.py   | 117 +++-
.../v1/overcloud_image/test_overcloud_image.py     | 101 ++-
.../minion => overcloud_restore}/__init__.py       |   0
.../v1/overcloud_update/test_overcloud_update.py   |  35 -
.../v1/overcloud_upgrade/test_overcloud_upgrade.py |   4 +-
.../test_tripleo_container_image.py                |  30 +-
.../v2/overcloud_delete/test_overcloud_delete.py   |  81 ++-
.../v2/overcloud_network/test_overcloud_network.py |   6 +
tripleoclient/utils.py                             | 534 +++++++++++++--
tripleoclient/v1/minion_config.py                  | 421 ------------
tripleoclient/v1/overcloud_admin.py                |  62 +-
tripleoclient/v1/overcloud_backup.py               |  26 +-
tripleoclient/v1/overcloud_cell.py                 |  15 +-
tripleoclient/v1/overcloud_deploy.py               | 515 +++++++++------
tripleoclient/v1/overcloud_external_update.py      |   5 +-
tripleoclient/v1/overcloud_external_upgrade.py     |   5 +-
tripleoclient/v1/overcloud_image.py                |  60 +-
tripleoclient/v1/overcloud_node.py                 |  97 +--
tripleoclient/v1/overcloud_restore.py              | 147 +++++
tripleoclient/v1/overcloud_roles.py                |  13 +-
tripleoclient/v1/overcloud_update.py               | 118 ++--
tripleoclient/v1/overcloud_upgrade.py              |  32 +-
tripleoclient/v1/tripleo_deploy.py                 |  46 +-
tripleoclient/v1/tripleo_launch_heat.py            |  24 +-
tripleoclient/v1/tripleo_validator.py              | 133 ++++
tripleoclient/v1/undercloud.py                     |  16 +-
tripleoclient/v1/undercloud_config.py              |  21 +-
tripleoclient/v1/undercloud_minion.py              | 162 -----
tripleoclient/v1/undercloud_preflight.py           |  36 +-
tripleoclient/v2/overcloud_ceph.py                 | 634 ++++++++++++++++++
tripleoclient/v2/overcloud_delete.py               |  74 ++-
tripleoclient/v2/overcloud_network.py              |  39 ++
tripleoclient/v2/overcloud_node.py                 |  43 +-
tripleoclient/v2/tripleo_container_image.py        |  38 +-
tripleoclient/workflows/baremetal.py               |  52 +-
tripleoclient/workflows/deployment.py              | 146 ++--
tripleoclient/workflows/parameters.py              |  42 +-
tripleoclient/workflows/roles.py                   |  12 +-
tripleoclient/workflows/scale.py                   | 230 -------
zuul.d/layout.yaml                                 |  13 -
86 files changed, 4327 insertions(+), 2603 deletions(-)


Requirements updates
--------------------

diff --git a/requirements.txt b/requirements.txt
index 9c80b5a5..3616e4e8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19 +19 @@ ansible-runner>=1.4.5 # Apache 2.0
-validations-libs>=1.1.0 # Apache-2.0
+validations-libs>=1.2.0 # Apache-2.0