| Title: 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. |
| |
| <h2 id="web-sites">Websites<a class="headerlink" href="#web-sites" title="Permanent link">¶</a></h2> |
| |
| - <a href="https://apache.org/dev/#web" targety="_blank">ASF websites</a>. |
| - An index of <a href="https://projects.apache.org/projects.html?name" target="_blank">all ASF projects</a>. |
| - `www.apache.org` is the main ASF website. Build instructions are <a href="https://apache.org/dev/infra-site" target="_blank">here</a>. |
| - Details about individual <a href="https://home.apache.org/" target="_blank">ASF Committers</a>. |
| - Notes about committers' <a href="https://apache.org/dev/new-committers-guide.html#public_html" target="_blank">personal web spaces</a>. |
| |
| <h2 id="email">Email<a class="headerlink" href="#email" title="Permanent link">¶</a></h2> |
| |
| - Mail server - QMail/QSMTPD |
| - <a href="https://www.apache.org/foundation/mailinglists.html" target="_blank">mailing lists</a> - EZMLM |
| - Searchable <a href="https://lists.apache.org/" target="_blank">private mailing list archives (mod_mbox)</a>. ASF Members have full access; PMC members have access to their PMC's archives only. |
| - Spam control - Spamfilter + SpamAssassin |
| - Mail forwarding: See <a href="https://id.apache.org" target="_blank">id.apache.org</a> |
| - <a href="https://lists.apache.org/" target="_blank">PonyMail</a> lets you browse Apache email archives by certain categories, by user, or by project. You must log in if you want to respond to an email, or write a new one, through this interface. |
| - Infra maintains and uses a series of <a href="https://infra.apache.org/infra-mail.html" target="_blank">mailing lists</a>, 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 <a href="https://selfserve.apache.org" target="_blank">Self-Service Platform</a>, 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: |
| |
| * Create a new Jira or Confluence project, Git repository, or mailing 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 passwords for the OTP or S/Key one-time-password systems (generally, PMC members). |
| |
| ### Locked out of the system? ### |
| |
| If you have forgotten your password and cannot retrieve it, contact Infrastructure via root@apache.org for assistance. |
| |
| Before asking for a manual password reset or email change, please consider: |
| |
| - If you have access to an ASF machine via SSH (with a private key), you can use this to confirm your identity. |
| - If you don't have access to anything to establish your identity, you may be asked to file a new ICLA. |
| |
| ## 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](pypubsub.html). |
| |
| ## LDAP-enabled services ## |
| Infra supports many ASF <a href="https://cwiki.apache.org/confluence/display/INFRA/LDAP+enabled+services+at+the+ASF" target="_blank">LDAP-enabled services</a>. You can log in to them with your LDAP credentials. |
| |
| ## Tools for ASF projects |
| |
| ### PMC tools |
| |
| - <a href="https://reporter.apache.org/" target="_blank">Reporter</a> 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](project-blogs.html). |
| - Teams can conduct and record meetings through Internet Relay Chat (IRC) using [ASFBot](asfbot.html). |
| - [Localization tools](localization.html). |
| - The Apache <a href="https://creadur.apache.org/rat/" target="_blank">Release Audit Tool (RAT)</a> can help you confirm that your proposed product release complies with all ASF requirements. |
| |
| <h4 id="source-repository">Version control<a class="headerlink" href="#source-repository" title="Permanent link">¶</a></h2> |
| |
| Apache provides, and Infra maintains, [code repositories](version-control.html) that Apache projects can use to keep their project code safe, accessible to team members, and under version control. |
| |
| - <a href="https://svn.apache.org/repos/asf/" target="_blank">Subversion (SVN) repositories</a> |
| - <a href="https://svn.apache.org/viewvc/" target="_blank">ViewVC (Browser interface to the main repository)</a> |
| - [Read-only Git mirrors of SVN codebases](git.html) |
| - [Writable Git repositories](writable-git.html) |
| - [Aoache and GitHub](apache-github.html) |
| |
| |
| <h4 id="issue-tracking">Issue tracking and feature requests<a class="headerlink" href="#issue-tracking" title="Permanent link">¶</a></h4> |
| |
| Projects can use either of these bug-tracking and feature request tools: |
| |
| * <a href="https://issues.apache.org/jira" target="_blank">Jira</a> |
| * <a href="https://bz.apache.org/bugzilla/" target="_blank">Bugzilla</a> |
| |
| Here is how to [request a bug and issue tracker for your project](request-bug-tracker.html). |
| |
| For historical reasons, some projects have their own instances of Jira or Bugzilla. See <a href="https://issues.apache.org/" target="_blank">issues.apache.org</a> for a list. |
| |
| Review Apache's <a href="https://issues.apache.org/bugwritinghelp.html" target="_blank">bug reporting guidelines</a>. |
| |
| <h3 id="repository-to-issue-tracker-integrations">Integrating youir repository with Jira tickets<a class="headerlink" href="#repository-to-issue-tracker-integrations" title="Permanent link">¶</a></h3> |
| |
| Infra can activate a [Subversion and Git integration with Jira tickets](svngit2jira.html) for your project. |
| |
| <h3 id="source-repository-publishersubscriber-services">Source repository publisher/subscriber services<a class="headerlink" href="#source-repository-publishersubscriber-services" title="Permanent link">¶</a></h3> |
| |
| - SvnPubSub |
| - [PyPubSub](pypubsub.html) |
| |
| ### Build services |
| |
| Apache supports and models continuous integration and continuous deployment, or *CI/CD*. The <a href="https://ci.apache.org" target="_blank">Apache Build services site</a> provides more information, and links to these build tools: |
| |
| * BuildBot |
| * Gump |
| * Jenkins |
| |
| Other tools to consider: |
| |
| * <a href="https://travis-ci.org/" target="_blank">Travis CI</a> |
| * <a href="https://www.appveyor.com" target="_blank">Appveyor</a> |
| |
| ### Code signing ### |
| |
| - Digicert |
| - Requesting access to the [Digicert code signing service](digicert-access.html) |
| - [Using Digicert](digicert-use.html) |
| - <a href="https://cwiki.apache.org/confluence/display/INFRA/Digicert+code+sign+service+usage+statistics" target="_blank">Digicert use statistics by Apache projects</a> |
| - For <a href="https://cwiki.apache.org/confluence/display/INFRA/Distribution+via+the+Apple+App+Store" target="_blank">distribution via the Apple App Store</a> |
| - For the <a href="https://cwiki.apache.org/confluence/display/INFRA/Requesting+access+to+the+Google+code+signing+service" target="_blank">Google code signing service</a> for Android apps |
| |
| - More information on <a href="https://cwiki.apache.org/confluence/display/INFRA/Code+Signing+and+Publishing" target="_blank">code signing and publishing</a> |
| |
| ### Code Distribution |
| |
| Use the ASF <a href="https://repository.apache.org/" target="_blank">Nexus Repository Manager</a> to browse for and review code distributions by ASF projects. |
| |
| <h3 id="virtual-servers">Virtual servers<a class="headerlink" href="#virtual-servers" title="Permanent link">¶</a></h3> |
| |
| Infra can provide Ubuntu virtual machines for projects. See: |
| |
| - [Virtual machine policy](vm-policy.html) |
| - [Process for requesting a vm](vm-for-project.html) |
| |
| <h3 id="distributions">Distributions<a class="headerlink" href="#distributions" title="Permanent link">¶</a></h3> |
| |
| - <a href="https://www.apache.org/dyn/closer.cgi" target="_blank">Current distributions</a> |
| - <a href="https://archive.apache.org" target="_blank">Historical distribution archives</a> |
| - [Rsync for distribution mirrors](how-to-mirror.html) |
| - <a href="https://repository.apache.org" target="_blank">Nexus</a> |
| |
| <h3 id="build">Build services / CI<a class="headerlink" href="#build" title="Permanent link">¶</a></h2> |
| |
| Information about our build and continuous integration tools is on <a href="https://ci.apache.org/" target="_blank">this page</a>. |
| |
| ### Code quality |
| |
| **SonarQube** is an open-source platform developed by SonarSource for continuous inspection of code quality to perform automatic reviews with static analysis of code to detect bugs, code smells, and security vulnerabilities on 20+ programming languages. You can check the status of many Apache project repositories <a href="https://sonarcloud.io/organizations/apache/projects" target="_blank>here</a>. |
| |
| <a href="https://cwiki.apache.org/confluence/display/INFRA/SonarQube+Analysis" target="_blank">Read more</a>. |
| |
| ### Online voting |
| |
| Projects can use the <a href="https://steve.apache.org" target="_blank">Apache Steve</a> voting system instance (offline when not in use). |
| |
| <h2 id="other">Other<a class="headerlink" href="#other" title="Permanent link">¶</a></h2> |
| |
| <h3 id="dns">DNS<a class="headerlink" href="#dns" title="Permanent link">¶</a></h3> |
| |
| Infra manages the ASF DNS, which is registered with Namecheap. |
| |
| <h3 id="irc-services">IRC Services<a class="headerlink" href="#irc-services" title="Permanent link">¶</a></h3> |
| |
| For IRC Services on the Freenode IRC Network, see <a href="https://wilderness.apache.org" target="_blank">wilderness.apache.org</a>. |
| |
| ### URL shortener |
| |
| <a href="https://s.apache.org" target="_blank">URL shortener</a> |
| |
| ### Sharing Snippets |
| |
| <a href="https://paste.apache.org/" target="_blank">Paste</a> is a service that lets ASF members post code snippets or similar file extracts they want to share to illustrate a code issue or make available for reuse, usually with other project members. You can post content as plain text, or formatted for a number of coding and scripting languages. |
| |
| ### Logging |
| |
| <a href="https://uls.apache.org/app/kibana#/discover?_g=()" target="_blank">Kibana</a> |
| |
| ### Machine List |
| |
| <a href="https://www.apache.org/dev/machines.html" target="_blank">Host Keys and Fingerprints</a> |
| |
| ### Whimsy |
| |
| <a href="https://whimsy.apache.org/roster/committer/" target="_blank">Committer search</a> |
