kolla-ansible/doc/liberty-deployment-warning.rst
Steven Dake f6e1786563 Update liberty deployment warning
Tell folks about the state of liberty 1.0.0 and to use
1.1.0 for production deployments.

Change-Id: Iea824e8fc6489d8222e089199161ca3fb30a8310
2016-05-11 09:01:11 -07:00

37 lines
1.4 KiB
ReStructuredText

Liberty 1.0.0 Deployment Warning
================================
Warning Overview
----------------
Please use Liberty 1.1.0 tag or later when using Kolla. No data loss
occurs with this version. stable/liberty is also fully functional and
suffers no data loss.
Data loss with 1.0.0
--------------------
The Kolla community discovered in the of middle Mitaka development that it
was possible for data loss to occur if the data container is rebuilt. In
this scenario, Docker pulls a new container, and the new container doesn't
contain the data from the old container. Kolla stable/liberty and Kolla
1.0.0 are not to be used at this time, as they result in *critical data loss
problems*.
Resolution
----------
To rectify this problem, the OpenStack release and infrastructure teams
in coordination with the Kolla team executed the following actions:
* Deleted the stable/liberty branch (where 1.0.0 was tagged from)
* Created a tag liberty-early-demise at the end of the broken stable/liberty
branch development.
* Created a new stable/liberty branch based upon stable/mitaka.
* Corrected stable/liberty to deploy Liberty.
* Released Kolla 1.1.0 from the newly created stable/liberty branch.
End Result
----------
A fully functional Liberty OpenStack deployment based upon the two years of
testing that went into the development that went into stable/mitaka.
The docker-engine 1.10.0 or later is required.