Services and Tools
Infra maintains a wide range of tools for PMCs, project committers, and the Apache Board to use. Parts of our toolkit are only available to people who have specific duties or roles. Others, like the monitoring tools that show the status of various parts of the Apache infrastructure, are available to everyone.
- Services for Top-Level Projects (TLPs)
- Services for incubating projects (podlings)
- Tools for ASF projects
- Other tools
Services for Top-Level Projects (TLPs)¶
Websites¶
www.apache.org
is the main ASF website.- ASF project websites.
- ASF project website sources
- An index of all ASF projects (if they have set up a DOAP).
- Any ASF project can use the ASF-Pelican template as the basis for their project website.
- Details about individual ASF Committers.
- Notes about committers' personal web spaces.
- The Apache Project Website Checker periodically reviews all TLP websites and reports whether they comply with Apache's policies for TLP websites.
Email¶
- Emailing tips
- All requests for new email lists should go through the self-serve system. Remember not to mark a list as private if you want it publicly archived.
- Email server - QMail/QSMTPD
- email lists - EZMLM
- Searchable email list archives. ASF Members have full access to private emails; PMC members have access to their PMC's archives only.
- Review details about searching and creating emails in
lists.apache.org
.
- Review details about searching and creating emails in
- Spam control - Spamfilter + SpamAssassin
- Email forwarding: See id.apache.org
- Infra maintains and uses a series of email lists, some of which are open to committers.
ASF self-service platform¶
One of Infra's goals is to empower ASF members, PMCs, and committers to do much of what they need to do without having to request help from Infra. The Self-Service Platform, for example, provides a number of handy tools that people who have an Apache email address (basically, project committers, PMC members, and ASF Members) can use to:
- Create a Jira or Confluence project, Git repository, or email list (PMC Chairs and Infra members).
- Edit your ASF identity or update your ASF password. If you are updating your password, you need access to the email account associated with your Apache account. A reset key is only valid for 15 minutes, so be sure to use it as soon as it arrives.
- Synchronize Git repositories.
- Use the OTP Calculator to generate one-time passwords for the OTP or S/Key one-time-password systems (generally, PMC members).
- Archive a Confluence Wiki space and make it read-only.
People who are not part of the ASF community but wish to file a Jira ticket about an ASF project's product can use the platform to request a Jira account.
ASF account management¶
ASF account management provides guidance if you want to update your account details, or have lost access to your account.
Getting notices of infrastructure events¶
You can subscribe to notices of infrastructure events that you want to know about, ranging from Subversion commits to emails to specific lists. Learn more here.
LDAP-enabled services¶
Infra supports many ASF LDAP-enabled services. You can log in to them with your LDAP credentials.
Services for incubating projects (podlings)¶
Infra supports incubating projects, or podlings.
- An introduction to Infra and the Incubator, showing the steps for setting up a new podling.
- Guidance for selecting a project or product name
Tools for ASF projects¶
Infra supports an array of tools and services to help projects develop and support both their applications and their community, including:
- Every project can use a dedicated space on the Confluence wiki.
- How to manage user permissions in your project's wiki space.
- How to give a user edit access to the wiki space.
- Reporter provides actvitity statistics and other information about your project, and editing tools to help you write and submit your project's quarterly Board reports.
- You can create and run a project blog.
- You can establish a Slack channel for real-time team discussions. Once you have your Slack channel, Infra can set up a Slack-Jira bridge so that you get notices in your channel of new or updated Jira tickets. open a Jira ticket for INFRA to get this feature for your TLP's Slack channel.
- Teams can conduct and record meetings through Internet Relay Chat (IRC) using ASFBot. However, you must conduct formal votes on decisions in the appropriate project email list, following the Apache voting process.
- Localization tools.
- The Apache Release Audit Tool (RAT) can help you confirm that your proposed product release complies with all ASF requirements.
- The ASF OAuth system provides a focal point for services wishing to make use of authentication without security implications around storing sensitive user data. Many Apache services use it to validate that the user requesting access is a committer within the project and has lawful access to the systems in question. Read more about Apache OAuth.
Version control¶
Apache provides, and Infra maintains, code repositories that Apache projects can use to keep their project code safe, accessible to team members, and under version control.
-
Information about using Git
-
Information about using Subversion
Issue tracking and feature requests¶
The ASF supports these options for tracking issues and feature requests:
- Jira (Note: qbot is a tool that can integrate Jira notifications with a project's channel in the
the-asf
Slack workspace.) - The GitHub issue tracking feature
For historical reasons, some projects use Bugzilla. We continue to support Bugzilla, but will not set it up for projects that do not already use it.
Apache Allura is another issue-tracking option. If you feel it may meet your project's needs, consult directly with the Allura project through their users@allura.apache.org
email list.
See issues.apache.org for a list of what each project uses.
Here is how to request a bug and issue tracker for your project.
Here are some guidelines for writing a good bug report.
Integrating your repository with Jira tickets¶
Infra can activate a Subversion and Git integration with Jira tickets for your project.
Source repository publisher/subscriber services¶
- SvnPubSub
- PyPubSub
Build services¶
Apache supports and models continuous integration and continuous deployment, or CI/CD. The ASF build and supported services page provides information about, and links to, the CI services the ASF provides and/or supports.
Other tools to consider:
Product naming¶
See guidance for choosing a product name
Code signing¶
- Digicert
- Requesting access to the Digicert code signing service
- Using Digicert
- Cryptography with OpenPGP
- For distribution via the Apple App Store
- More information on code signing and publishing
Code quality¶
SonarCloud is a code quality and security tool that is free to open-source projects. It permits continuous inspection of code quality so your project can perform automatic reviews with static analysis of code to detect bugs, code smells, and security vulnerabilities in 20+ programming languages.
You can check the status of many Apache project repositories.
Guidance for using SonarCloud with an ASF project is here.
Code distribution¶
Use the ASF Nexus Repository Manager to browse for and review code distributions by ASF projects.
Distributions¶
Virtual servers¶
Infra can provide Ubuntu virtual machines for projects. See:
Use of nightlies.a.o
nightlies, as implied by its name, is designed as a 'short term' storage solution. See the nightlies use policy.
Online voting¶
Projects can use the Apache STeVe voting system instance (offline when not in use). The tool name refers to the single transferable vote system that is one of its voting options. Open a Jira ticket for Infra to provide assistance in preparing STeVe for your project's use.
Other tools¶
DNS¶
Infra manages the ASF DNS, which is registered with Namecheap.
URL shortener¶
Infra Reporting Dashboard¶
The ASF Infrastructure Reporting Dashboard contains a collection of reports on the overall health and activity of the infrastructure at the ASF. Some reports are available only for ASF Members and Infra team members.
Machine list¶
Whimsy¶
Apache Whimsy describes itself as "providing organizational information about the ASF and our projects in easy to consume ways, and to help automate corporate processes at the ASF to make the paperwork behind the scenes easier for our many volunteers."
There are many Whimsy tools useful for PMCs and individual committers, such as Committer search.
Copyright 2024, The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache® and the Apache feather logo are trademarks of The Apache Software Foundation.