Bugs
Launchpad bugs are used to track known issues and defects in OpenStack software.
Contents
Bugs reference
Here are the different fields available in Launchpad bugs, and how we use them within the OpenStack project.
Status
New | The bug was just created |
Incomplete | The bug is waiting on input from the reporter |
Confirmed | The bug was reproduced or confirmed as a genuine bug |
Triaged | The bug comments contain a full analysis on how to properly fix the issue |
In Progress | Work on the fix is in progress, bug has an assignee |
Fix Committed | The branch containing the fix was merged into master |
Fix Released | The fix is included in the milestone-proposed branch, a past milestone or a past release |
Invalid | This is not a bug |
Opinion | This is a valid issue, but it is the way it should be |
Won't Fix | This is a valid issue, but we don't intend to fix that |
Importance
This should be set when the status reaches Confirmed stage. It is a combination of short-term impact (unavailability of a feature), long-term impact (data corruption, security breach), number of people affected, and presence of a documented workaround. Use these as guidelines:
Critical | Data corruption / complete failure affecting most users, no workaround |
High | Data corruption / complete failure affecting most users, with workaround |
Failure of a significant feature, no workaround | |
Medium | Failure of a significant feature, with workaround |
Failure of a fringe feature, no workaround | |
Low | Small issue with an easy workaround |
Any other insignificant bug | |
Wishlist | Not really a bug, but a suggested improvement |
Undefined | Impact was not assessed yet |
Note that presence of Critical bugs will delay the release.
Assigned To
The person currently working to fix this bug. Must be set by In progress stage.
Milestone
The milestone we need to fix the bug for, or the milestone/version it was fixed in.
Tags
Free-form tags you can use to search bugs with. Here is the list of official tags.
Bugs lifecycle
Bugs go through multiple stages before final resolution.
Reporting
When you find a bug, you should file it against the proper OpenStack project using the corresponding link:
- Report a bug in Nova
- Report a bug in Glance
- Report a bug in Swift
- Report a bug in Horizon
- Report a bug in Keystone
- Report a bug in Neutron
- Report a bug in the manuals
- Report a bug in the api documentation
- Report a bug in the community tools
Make sure there is no bug already filed for the same issue, then enter the details of your report. It should at least include:
- The release, or milestone, or commitid) corresponding to the software that you are running
When this is done, the bug is created with:
- Status: New
Confirming & prioritizing
This stage is about checking that a bug is real and assessing its impact. If you are lacking information to properly reproduce or assess the importance of the bug, you should ask the original reporter for more information and set the bug to:
- Status: Incomplete
Once you have reproduced the issue (or are 100% confident that this is indeed a valid bug), you should set:
- Status: Confirmed
If you're a core developer or a member of the project bug supervision team, you should also prioritize the bug:
- Importance: <Bug impact> (see above)
Debugging (optional)
This optional stage is about determining how to fix the bug and posting the solution in the comments. Sometimes the implementation of the fix will be straightforward and you would jump directly to bugfixing, but in some other cases, you would just post your complete debugging analysis and give someone else the opportunity of fixing the bug. Then you should ask a core developer or bug supervisor to set:
- Status: Triaged
Bugfixing
At this stage, a developer will work on a fix. During that time, in order to avoid duplicating the work, he should set:
- Status: In progress
- Assignee: <yourself>
When the fix is ready, he will propose the change and get it reviewed.
Note that Gerrit will automatically set the status and assignee when a change is proposed that mentions the bug number.
After the change is accepted
Once the change is reviewed, accepted, and has landed in master, it will automatically move to:
- Status: Fix Committed
When the fix makes it into a milestone or release branch, it will automatically move to:
- Milestone: Milestone the bug was fixed in
- Status: Fix Released