Infra and the Incubator

What Infra is

The Infrastructure team (Infra) manages the systems and hardware that run the services that the ASF and its projects depend on. Infra also reviews requests to install new systems or software on ASF machines, and provides virtual machines (VMs) for projectrs. It's a small team, distributed across many time zones. Someone is on duty at all hours to respond to emergency issues.

Infra and incubating projects

Your mentor is your first stop in figuring out technical issues for your incubating project. They can explain, based on long experience, how to get the best out of the ASF systems, machines, and services. However, if the mentor is not available, members of the new project can move forward the process of setting up project resources.

Phase 1: Establishing a podling

Podling bootstrap file

The very first task is for a mentor or champion to bootstrap the project via the podlings.xml file that tracks all current and previous podlings.

This file is here. You may use existing entries as a primer.

DNS

The Domain Name System (DNS) is a hierarchical and decentralized naming system for computers, services, or other resources connected to the Internet or a private network. It associates information with domain names assigned to each of the participating entities.

DNS entry ($projectname.apache.org) is required for the podling website and mailing lists to work. Request this once podlings.xml has been updated, by filing a Jira ticket with Infra. See the next point before completing the ticket.

LDAP

The Lightweight Directory Access Protocol (LDAP) is an open, vendor-neutral, industry-standard application protocol for accessing and maintaining distributed directory information services over an Internet Protocol (IP) network.

Activate LDAP for the project by filing a JIRA ticket with Infra. Typically you can request both LDAP and DNS in the same ticket.

Phase 2: Mailing lists

Mailing lists are an integral part of the decision-making process for projects and for the whole ASF. Projects must have them set up before requesting other development resources.

Typically, a project will need three lists

  • private@ for podling PMC communications, including recording formal decisions and discussion of security issues
  • dev@ for development discussions
  • commits@ for code commit notifications

Projects may also request separate lists for issues, pull requests, and users (this is very important once you do your first software release and begin to develop a user community) at any time.

The project's mentors can can request mailing lists once DNS and LDAP are set up, through SelfServe.

It takes about twelve hours after the mentor makes the request before the mailing lists become active. This gives Infra time to catch and deal with any errors in the requests.

Phase 3: Requesting new project resources or moving existing ones

Code repositories

Moving existing repositories into ASF version control generally requires a github.com transition to the github.com/apache/ organization. To make the transition,, file a Jira ticket with Infra.

If you wish to copy existing code without transferring github stars, etc., your mentor can request new repositories for the project via SelfServe.

Bug tracking

You can enable GitHub issues (and wikis) via our (.asf.yaml service, a configuration file that controls features such as notification schemes, website staging, GitHub settings, and Pelican builds. This is a per-repo feature.

The project can request a Jira instance for issue tracking via SelfServe.

Confluence Wiki

Every project can have a dedicated space on the Apache Confluence wiki. Project participants can use the space to develop documentation, share planning and process documents, and work collaboratively. They can opt to make some pages in their space available to the public. Request a Confluence wiki space for the project via SelfServe.

Website

Standard practice is to create a web site repository via SelfServe, and then use .asf.yaml for publishing on $project.apache.org.

Contacting Infra

If there is a problem, or you need Infra to do something, the best option is to start a Jira ticket assigned to Infra. That helps us and you track progress on whatever the thing is.

For more informal contact, you can use the asfinfra Slack channel in the Apache Slack workspace, or send an email. Further details are here.

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.