Ceilometer Python Client Keystone V3 Upgrade¶
Keystone declared V2 deprecated in K cycle with the intent of maintaining V2 for another two cycles after that. All the services clients are going to add support to V3 in order to smooth this transition.
Problem description¶
Keystone V3 API has introduced the following major changes:
Authentication: Custom auth method can be developed as plug-ins, this enables support for: OAuth 1.0 and SAML based federation
Authorization: in V2 API there are only two levels “admin” or none. V3 API enables control of who can call each method if the policy file is correctly specified.
Richer set of APIs. Vendor specific extensions are not supported directly anymore and there is a set of optional extensions supported by Keystone.
Proposed change¶
Since Ceilometer Client imports keystoneclient, the main changes to client.py are to selectively import the correct keystoneclient library version and pass a number of new options. In shell.py the new options are added to the parser.
Alternatives¶
None.
Data model impact¶
None.
REST API impact¶
None.
Security impact¶
None.
Pipeline impact¶
None.
Other end user impact¶
There will be new commands to be used with the ceilometer client to scope the request to Domain/Project and support different auth methods. Alarms are using the ceilometer client and there could be a potential impact.
Performance/Scalability Impacts¶
None.
Other deployer impact¶
None.
Developer impact¶
None.
Implementation¶
Assignee(s)¶
Who is leading the writing of the code? Or is this a blueprint where you’re throwing it out there to see who picks it up?
If more than one person is working on the implementation, please designate the primary author and contact.
- Primary assignee:
fabgia
- Other contributors:
robsparker
- Ongoing maintainer:
fabgia
Work Items¶
Add new parameters to the client and cli.
Call the V3 Keystone client.
Validate the authorization and authentication via python-keystoneclient.
Future lifecycle¶
None.
Dependencies¶
Keystone client: python-keystoneclient.
Testing¶
Unit tests will be added to the Ceilometer client to support the new parameter submission as well as validation of the authorization and authentication with Keystone client.
Documentation Impact¶
Documentation changes specific to new parameters added to the client.
References¶
Related blueprints: Ceilometer Client https://blueprints.launchpad.net/python-ceilometerclient/+spec/support-keystone-v3-api Keystone https://blueprints.launchpad.net/keystone/+spec/document-v2-to-v3-transition