Graduate a podling to a TLP


TL;DR:

Follow the instructions given.

Process:

Things to check before graduating a podling:

  1. If the project uses Git, update the git repositories

    # From gitbox.a.o as www-data
    /x1/gitbox/bin/graduate-podling.py $PROJECTNAME
    
    # Sample output
    
    Graduating rya...
    - Applying changes to incubator-rya-site.git ...
      - Renaming gitbox repo from /x1/repos/asf/incubator-rya-site.git to /x1/repos/asf/rya-site.git...
      - Setting remote...
      - Changing notification options..
        - Changing commit ML to commits@rya.apache.org
        - Changing PR notification ML to dev@rya.apache.org
      - Done!
      - Changing repository from incubator-rya-site to rya-site on GitHub...
      - Repository name changed!
    - Applying changes to incubator-rya.git ...
      - Renaming gitbox repo from /x1/repos/asf/incubator-rya.git to /x1/repos/asf/rya.git...
      - Setting remote...
      - Changing notification options..
        - Changing commit ML to commits@rya.apache.org
        - Changing PR notification ML to notifications@rya.apache.org
      - Done!
      - Changing repository from incubator-rya to rya on GitHub...
      - Repository name changed!
    All done, processed 2 repositories!
  2. If the project uses svn, move its repository:

    svn mv https://svn.apache.org/repos/asf/incubator/$project https://svn.apache.org/repos/asf/$project -m "$project has graduated"

  3. Move the dist svn trees

    svn mv https://dist.apache.org/repos/dist/release/incubator/$project https://dist.apache.org/repos/dist/release/$project -m "$project has graduated"
    svn mv https://dist.apache.org/repos/dist/dev/incubator/$project https://dist.apache.org/repos/dist/dev/$project -m "$project has graduated"
  4. Update any svn size limit exceptions in the Subversion server .yaml to reflect the graduated svn path
  5. Check svnwcsub configurations if the project uses svn for its website

    1. Make sure websites are subbed to the right repository in modules/svnwcsub/files/config/svnwcsub.conf


  1. Jira Category

    • Move the project out of the incubator category and into its own

      • Jira-administration -> projects -> project categories

        • create new category for TLP

      • Jira-administration -> projects -> new TLP

        • select the Incubator drop down menu next to Category, then select the newly created category

  2. Jira Project (Add project to INFRA Jira 'Project' drop down field)
    1. Go to the Administration Cog and select ‘Issues’
    2. Select ‘Custom Fields’ from the left navigation
    3. Search for the ‘Project’ field and click ‘Configure’
    4. Click 'Edit Options’ (bottom of the page)
    5. Type the project name into the Add Value field
    6. Click ‘Add’
    7. Move the project to its correct place in the alphabetical list using the arrow keys or the position number
    8. Click ‘Done’ (at the bottom of the page)

     

  3. Remove the victims file from /trunk/tlpreq/input/victims.

  4. Resolve the Jira graduation ticket as complete.


Transfer an existing Git repository to an ASF project

  1. An Officer of the ASF, who could be the chair of a project PMC, requests the transfer via a Jira ticket. Infra can double-check that the Officer has performed due diligence to make sure the repository contents are available for transfer: for instance, that none of its files are subject to licenses that conflict with the ASF license. However, it is not Infra's job to perform that investigation.
  2. Infra performs the transfer in the normal way, recording details in the Jira ticket, and markets the ticket as complete once the Officer confirms they can access the repo in its new location.