Operations Guide: Reference project upgrade notes¶

Problem description¶

Service upgrade notes located in project repositories require greater visibility for operators.

Proposed change¶

Several project teams have produced upgrade notes in the developer documentation that are beneficial to operators:

• keystone
• nova ,
• cinder <https://review.openstack.org/#/c/393395/>, and
• neutron

Due to a short development cycle for Ocata, the interim solution is to provide links to this information in the Operations Guide to improve visibility for operators. Links to other service upgrade notes will be added as they become available.

There is a growing need to provide a project-based upgrade guide. During Ocata development cycle, this can be discussed further, and give the opportunity for other core project teams to discuss and document upgrade strategies. Then potentially scope and plan a guide at the OpenStack Project Technical Group meeting for the Pike release.

Implementation¶

Dependencies¶

• Swift and glance project teams providing upgrade notes during the Ocata development cycle.

Testing¶

Testing will follow the standard documentation review process.

References¶

• Discussion can occur using any official medium including IRC in #openstack-doc, the openstack-docs mailing list with [ops-guide] in the subject, monthly Ops Guide specialty team meeting, biweekly documentation team meeting.