Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management. Atlassian provides Jira services to Apache projects, and to the Infrastructure team. The tool's name is a short form of the name of the Japanese movie monster, Godzilla, which was an early developer nickname for the application.
The ASF and many of its projects use Jira to keep track of work to be done.
Anyone can review existing Jira tickets, or issues. You must register and log in if you want to create, comment or vote on, or watch issues. Only developers can edit, prioritize, schedule or resolve issues.
Any person with an ASF Jira account can open a ticket for any ASF project.
In November, 2022, due to an influx of false Jira accounts creating a flood of spam tickets, Infra ended public signups to ASF Jira accounts. This blog post discusses the decision.
If you need to open a Jira ticket for a particular project and do not have an ASF Jira account, ask the project to create a Jira account you can use by emailing the project's private mailing list. This information can often be found on the web at [project].apache.org under a "Contact" or "Communication" link, and is typically private@[project].apache.org. For example, to report a bug or issue for the example Apache Foo project, contact firstname.lastname@example.org to have a Jira account created. Some projects may have alternate communication methods, be sure to check their web pages first.
IMPORTANT:Please give projects time to respond and create your account. If you have not received an update or notification of account creation after seven days, reach out to the project's private list again asking for an update.
To provide an ASF Jira account for someone who is not a part of the ASF community but wants to create Jira tickets related to a project's product, someone on the project's PMC can follow these steps:
The user receives an email with a link to where they can have their password sent to them. They then can create Jira tickets for ASF projects, for Infra, or for the ASF in general.
The form is pretty clear, so the focus here is on a couple of key fields.
This is the group you want to take a look at the ticket. Select "Infra" for an infrastructure issue or request. Select a specific project if the issue is something like a problem in the project's documentation or website.
There's a good list of issue types to choose from. Make sure you select the most appropriate one.
For an Infra ticket, if you want Infra to look at a problem with the Apache Widget project, in this field select
Widget. Most of the time, for an Infra ticket, select
This is your quick statement of your problem or request. "Things are broken!" would not be a useful statement. Something like "Self-serve site hangs, then crashes" is more likely to get the right person's attention and a prompt resolution to the problem.
Make your best guess at how urgent this thing is. Infra, and many projects, triage Jira tickets by their priorities, and may adjust the priority of a ticket if its current setting seems too high or too low.
The options are
Select one or more components that this issue or request relates to. If you cannot figure out what to pick, select
This an optional field, useful if your issue concerns a specific Infra tool or service and you know the version you are using.
If you specify someone here, that person receives an alert about the issue. You can accept the default (Automatic) to put the issue in the queue for the Infra or project team's attention.
This is an optional field where you can describe your operating system, software platform and/or hardware specifications if they are relevant to the bug, task, or feature request.
Provide the juicy details here. For example, for an infrastructure bug report, Infra needs to know how to reproduce the thing you ran into. Describe what you were doing ("I was logged in to bla.html using Firefox"), what you wanted to do ("I wanted to do xxx"), what you expected to happen, and what you actually experienced.
For a feature request, it helps if you can not only describe the feature, but explain why the ASF or the specific project needs it.
There are many optional fields that you can probably skip.
When you have completed entering the useful information, click Create to create the ticket.
The largest group of tickets assigned to Infra are requests for Infra to perform a task of one sort or another. The next largest category is reports of possible bugs in the Infrastructure system.
Infra may respond in a number of ways, including:
Note: A ticket in the status of Waiting for User, will not generally be worked on until the ticket status is set to Waiting for Infra. Be sure to set the ticket to Waiting for Infra if the ticket needs follow-up!
Here are details about Infra's typical response times to Jira tickets and other requests, which largely depend on the severity of the issue.