Wallaby Series Release Notes

5.5.0

New Features

  • Add --progress option to image create command to enable a progress bar when creating and uploading an image.

  • Add --project and --project-domain``options to ``image list command to filter by owner.

  • It is now possible to list the keypairs for all users in a project using the --project parameter. This is an admin-only action by default and requires Compute API microversion 2.10 or later.

  • It is now possible to list the keypairs for a specific user using the --user parameter. This is an admin-only action by default and requires Compute API microversion 2.10 or later.

  • Add --limit and --marker options to hypervisor list command, to configure pagination of results.

  • Add --limit and --marker options to keypair list command, to configure pagination of results.

  • Add a number of additional options to the server create command:

    • --snapshot

    • --ephemeral

    • --swap

    • --block-device

  • Add --force option to server delete command, allowing users to force delete a server. This is admin-only by default.

  • Add --limit and --offset options to server group list command, to configure pagination of results.

  • Add --limit, --marker, --change-since and --changes-before options to server group list command, to configure pagination of results and filter results by last modification, respectively.

  • Add --property option to server image create command, allowing users to record arbitrary key/value metadata to meta_data.json on the metadata server.

  • Add a number of additional options to the server list command:

    • --availability-zone

    • --key-name

    • --config-drive, --no-config-drive

    • --progress

    • --vm-state

    • --task-state

    • --power-state

  • Add a number of additional options to the server rebuild command:

    • --name

    • --preserve-ephemeral, --no-preserve-ephemeral

    • --user-data, --no-user-data

    • --trusted-image-cert, --no-trusted-image-certs

  • Add --no-password option to server set command, allowing users to clear the admin password from the metadata service. Note that this does not actually change the server password.

  • Add support for project cleanup based on the OpenStackSDK with create/update time filters. In the long run this will replace openstack project purge command.

  • Add server evacuate command. This command will recreate an instance from scratch on a new host and is intended to be used when the original host fails.

  • Add server migration show commands. This can be used to show detailed information about an ongoing server migration.

  • The --nic option of the server create command now supports an optional tag=<tag> key-value pair. This can be used to set a tag for the interface in server metadata, which can be useful to maintain persistent references to interfaces during various operations.

  • Add server volume list command, to list the volumes attached to an instance.

  • Add server volume update command, to update the volumes attached to an instance.

  • Add support for --offload and --wait options for server shelve. --offload allows users to explicitly request offloading of a shelved server in environments where automatic offloading is not configured, while --wait allows users to wait for the shelve and/or shelve offload operations to complete.

  • Add support --wait option for server shelve.

  • Add --tag option to server add fixed ip command when adding a fixed IP to server. Only available starting with --os-compute-api-version 2.49.

  • Add --tag option to server add network command when add network to server. Only available starting with --os-compute-api-version 2.49.

  • Add --tag option to server add port command when add a port to server. Only available starting with --os-compute-api-version 2.49.

  • Add --tag option to server add volume command when add a volume to server. Only available starting with --os-compute-api-version 2.49.

  • Add --id and --enabled option to identity provider list command.

  • Add --name and --domain option to domain list command.

  • By default listing security group rules now shows the direction. The --long argument is now redundant and is now ignored as it was only used to display the direction.

  • The server migrate command will now automatically determine whether to use block or shared migration during a live migration operation. This requires Compute API microversion 2.25 or greater.

  • Add server migration list command. This command allows users to list the status of ongoing server migrations.

  • Add --remote-address-group option to security group rule create command for using an address group as the source/destination in security group rules. Also add field remote_address_group_id to the output of security group rule show and add column Remote Address Group to the output of security group rule list. [Blueprint address-groups-in-sg-rules]

  • Add address group create, address group delete, address group list, address group set, address group show and address group unset commands to support Neutron address group CRUD operations. [Blueprint address-groups-in-sg-rules]

  • Add --password option to server create command, allowing users to set the admin password when creating a new instance.

  • Add server migration abort command to abort ongoing live migrations.

  • Add server migration force complete command to force complete ongoing live migrations.

  • The openstack flavor list command now accepts two additional options, --min-disk and --min-ram, to filter flavor by minimum disk and minimum RAM, respectively.

  • Add --key-type option to keypair create command to set keypair type. Can be ssh or x509. Note that --os-compute-api-version 2.2 or later is required.

  • Add --user option to the keypair create, keypair delete, and keypair show commands. Only available starting with --os-compute-api-version 2.10.

  • Add device profile to port create command.

  • Add address_group as a valid --type value for the network rbac create and network rbac list commands.

  • Add --tag option to server create command to add tags when creating a server. Only available starting with --os-compute-api-version 2.52.

  • Add --tag option to server set command to add a tag to an existing server. Only available starting with --os-compute-api-version 2.26.

  • Add --tag options to server unset command to remove a tag from an existing server. Only available starting with --os-compute-api-version 2.26.

  • Add --tags and --not-tags options to server list command to list instances with and without the specified tag(s), respectively. Only available starting with --os-compute-api-version 2.26.

  • Add support for --rule option for server group create.

  • Add --c project_id | user_id | created_at to openstack server list command to get these columns as an output.

  • The server delete, server start and server stop commands now support the --all-projects option. This allows you to perform the specified action on a server in another project using the server name. This is an admin-only action by default.

  • Add support for openstack server show --topology flag, which will include NUMA topology information in the output.

  • Switch aggregate operations to use SDK

  • Adds ‘aggregate cache image’ operation

  • Switch console logs operation to use SDK

  • Switch compute.flavor operations from direct API calls (novaclient) to OpenStackSDK.

Upgrade Notes

  • The openstack server list --status parameter will now validate the requested status.

  • The --key-unset option of the server rebuild command has been replaced by --no-key-name. An alias is provided.

  • The server set --root-password option has been deprecated in favour of a non-interactive --password option.

  • The server create command will now error out if the --file option is specified alongside --os-compute-api-version of 2.57 or greater. This reflects the removal of this feature from the compute service in this microversion.

  • The deprecated --live option of the server migrate command has been removed. This was problematic as it required a host argument and would result in a forced live migration to a host, bypassing the scheduler. It has been replaced by a --live-migration option and optional --host option.

  • The server migrate confirm and server migrate revert commands, introduced in OSC 5.0, have been deprecated in favour of server migration confirm and server migration revert respectively. The deprecated commands will be removed in a future major version.

  • A warning will now be emitted when using the --disk-overcommit or --no-disk-overcommit flags of the server migrate command on Compute API microversion 2.25 or greater. This feature is only supported before this microversion and previously the flag was silently ignored on newer microversions. This warning will become an error in a future release.

Deprecation Notes

  • The --block-device-mapping option of the server create command has been deprecated in favour of --block-device. The format of the --block-device-mapping option is based on the limited “BDM v1” format for block device maps introduced way back in the v1 nova API. The --block-device option instead exposes the richer key-value based “BDM v2” format.

  • Deprecate the --long option for the security group list command. This is no longer needed to display all columns.

  • The --config-drive option on the openstack server create command has been deprecated in favour of the --use-config-drive and --no-config-drive arguments. The --config-drive option expected either a string or bool-like argument, but the nova API has only supported boolean values since API v2.1 was introduced.

Bug Fixes

  • Fix ‘-f json’ output of the flavor properties to return valid json object instead of stringying it.

  • The addresses and flavor fields of the server show command will now be correctly rendered as a list of objects and an object, respectively.

  • The networks and properties fields of the server list command will now be rendered as objects. In addition, the power_state field will now be humanized and rendered as a string value when using the table formatter.

  • The usage list and usage show commands will now display the name of the project being queried rather than the ID when using the table formatter. In addition, the server_usages, total_memory_mb_usage, total_vcpus_usage and total_local_gb_usage values will only be humanized when using the table formatter.

  • The policies (or policy, on newer microversions) and members fields of the server group list and server group show commands will now be rendered correctly as lists.

  • The cpu_info field of the hypervisor show output is now correctly decoded and output as an object.

  • Fixes default behaviour of openstack image create in allowing images with the same name. In version 5.2.0 this changed to not allow duplicates by default.

  • Associating a floating IP with a server using the server add floating ip command requires the server have at least one port associated with it. Previously, this was not validated, meaning the operation would silently fail. This has been resolved.

  • The openstack server group create command will now validate the policy value requested with --policy, restricting it to the valid values allowed by given microversions.

  • Add missing openstack subnet unset --gateway <subnet-id>.

Other Notes

  • Remove deprecated neutron-lbaas results from quota show command.