[openstack-dev] Upcoming OpenStackClient 3.0 Release (Monday)

Dean Troyer dtroyer at gmail.com
Mon Aug 22 01:08:21 UTC 2016


We're excited to pre-announce the release of OSC 3.0.0. The release is
expected to be approved by the release team during their working hours on
Monday 22 Aug 2016.

This is a **huge** release, and we shuffled things around so we've bumped
our major version. We tried our darndest to not break anything, and where
applicable we deprecated things instead. We have a small number of known,
documented breaking changes, which is why we did a major version bump,
please keep this in mind when upgrading.

We've added a lot of support:
  - We now use keystoneauth for all authentication and client sessions: from
that we will get support for various federated identity protocols as they
are added (saml, openid connect), kerberos, time-base one-time password,
any auth plugin in keystoneauth).
  - Support for various languages: we fixed some basic unicode issues with
OSC, resulting in a much cleaner experience when using non-English languages.
Additional important unicode fixes are being made in cliff and will get
picked up automatically by all releases of OSC when those are released.
  - Lots of new networking commands and additional options for existing
ones.  Too many to list them all here: support for networks, ports,
subnets, ip addresses, routers, network RBAC, security group, etc.
  - Bulk deletion support for nearly all delete commands: when deleting
resources supply as many as you want and we'll try to delete them all, and
report on any that failed.
  - Under the hood we moved a chuck of the common and low-level bits of OSC
into a new `osc-lib` repository to expose them as a documented and stable
library API.  This is now all available to OSC plugins without having to
depend on OpenStackClient itself.  The osc-lib dependency list is very
short, and most of those will already be used by plugins. This also led to
a restructuring of the CLI parsing and shell configuration code to remove
some duplication and overlap with os-client-config and isolate the
remainder in osc-lib.  osc-lib 1.0 has already been released and is now
available for use by plugins.

The known breaking changes are:
  - The `ip floating` commands have been renamed to `floating ip` -- check
the help output for details.  The old commands are still present but
deprecated and no longer appear in help output.
  - Finding role assignments for a user or project using the `roles list`
command has been deprecated, folks should use `role assignment list` for
this operation.

The usual patch will be automatically created to bump the upper-constaints
of OSC. Where possible, we encourage projects that depend on OSC (puppet,
osc-plugins, tripleo, etc) to propose a patch that uses the Depends-On
mechanism (depends on the upper-constaints change), to ensure your gate
won't break.

Thank you to the entire OSC team, we have had a lot of new contributors
this year, many of them working hard on the Networking commands.

dt

-- 

Dean Troyer
dtroyer at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160821/4f9806f0/attachment.html>


More information about the OpenStack-dev mailing list