Merge "Add Ops:Packaged Tag"

This commit is contained in:
Jenkins 2015-10-13 05:19:24 +00:00 committed by Gerrit Code Review
commit b1dae3e48e
2 changed files with 175 additions and 0 deletions

View File

@ -0,0 +1,92 @@
========================================================================
ops:packaged
========================================================================
Provides information to operators regarding the existence and quality of
packages for the project in distributions like Red Hat/Fedora, Ubuntu
and openSUSE/SLES.
Rationale
=========
The vast majority of ops use packages for deployment, so the existence of high
quality, bug free packages is an important factor considered when adopting a
project.
By making a general assessment for the software project's state of packaging
based on distributions officially supporting OpenStack, this tag provides
information that was previously difficult to determine, substantially improving
the decision making process.
Requirements
============
- good = Packages without major bugs exist for at least three distribution families
- beginning = Packages without major bugs exist for at least one distribution family
- warning = Packages exist, but have major bugs for more than one distribution family
- no = no packages exist in official distribution repositories for this project
Tag application process
=======================
- applied per major release by the ops tags team
- information is gathered from operator experiences using the packages, in
addition to anything discovered by the documentation team when writing the
new release's install guide
- in the case of 'new' projects, a simple check for the package in each
distribution's package management should suffice to select the level between
'no' and 'beginning'
- where the status is not 'good', links to bugs must be provided.
- the default assumption is that packages are bug-free unless a major bug link
can be provided.
- the application of this tag follows the three-package-management-system
classification used by the documentation team (apt, yum, zypper): the
aim is a general guide to the existence of packages - not an exhaustive
distro-by-distro breakdown. Where there are differences between
distributions or versions significant enough they would normally warrant
a change in tag level, this should be noted in a caveat.
Tag updates and timing
======================
Ops Tags are typically made on a per-release basis. At around the end of a
release cycle, a new directory to contain the JSON files for the release is
created, and tags are re-assessed, copying or not using information from
the previous release as appropriate.
In the case of this tag, though it can be updated at any time, there are
four potential update times that would be more common, mostly surrounding
the release process and how packages have traditionally been produced
and tested slightly lagging the release.
<-- potential for tag update here, based on RC efforts by packagers
1) OpenStack is released
<-- potential for tag update here, based on what's there on release day
2) Packages are formally announced
<-- potential for tag update here, based on the package cut
3) Mass bug reports come in and packages are fixed.
<-- potential for tag update here
This will quite likely result in some period of time post-release where
packages that will later be available are not yet ready, or bug-ridden.
This is deemed useful information to operators.
Attributes
==========
- status - the tag application status
- bug_link - URL(s) to major bugs afflicting a project's packages
- description - optional details regarding the tag application
- caveats - Any exceptions to the general 'status'. Follows the same
attributes as the general status: 'status', 'bug_link',
'description'. In addition a 'label' attribute could be defined
to be used as a title during display.

83
kilo/ops-packaged.json Normal file
View File

@ -0,0 +1,83 @@
{
"Compute service (Nova)":
{
"status": "good"
},
"Object Storage service (Swift)":
{
"status": "good"
},
"Image service (Glance)":
{
"status": "good"
},
"Identity service (Keystone)":
{
"status": "good"
},
"Dashboard (Horizon)":
{
"status": "good"
},
"Networking service (Neutron)":
{
"status": "good",
"caveats":
[{
"status": "no",
"label": "Vendor drivers not packaged",
"description": "From this release, most network drivers (particularly non-open-source) are no longer packaged. Instead, they must be found from their repository on https://github.com/stackforge or https://github.com/openstack ."
}]
},
"Block Storage service (Cinder)":
{
"status": "good"
},
"Telemetry service (Ceilometer)":
{
"status": "warning",
"description": "Red Hat's packages for Ceilometer are not usable with swift",
"bug_link": "https://bugzilla.redhat.com/show_bug.cgi?id=1214928"
},
"Orchestration service (Heat)":
{
"status": "good",
},
"Database service (Trove)":
{
"status": "warning",
"description": "On Ubuntu, /var/cache/trove is not created.",
"bug_link": "https://bugs.launchpad.net/ubuntu/+source/trove/+bug/1459961"
},
"Data Processing service (Sahara)":
{
"status": "warning",
"description": "Ubuntu packages run db-manage on install even when no database is configured.",
"bug_link": "https://bugs.launchpad.net/ubuntu/+source/sahara/+bug/1452698"
},
"Bare Metal service (Ironic)":
{
"status": "good"
},
"Message service (Zaqar)":
{
"status": "no"
},
"Key Management service (Barbican)":
{
"status": "no"
},
"DNS services (Designate)":
{
"status": "good"
},
"Deployment service (TripleO)":
{
"status": "no"
},
"Shared File Systems service (Manila)":
{
"status": "beginning"
}
}