[Gerrit - GitHub] Add a new repository

Owned by Milin Jaiswal (Unlicensed)
Last updated: May 20, 2021 by Jessica Gonzalez
2 min read

JSD requests for a new repository creation need to be clear on which GitHub organization should be created under. 

The process should be as follow:

  • The following are needed on the JSD Ticket:

    Project: Required
    Summary: Required
    Description: Required – Links to governing body authorization for new repositories

  • Identify which Github organization should the repository be created under. (Project Name)
  • Make sure there is information on who the contributors will be for these new repository.
  • Branch permissions and General Settings should be also set same way as other existing projects within the organization, unless otherwise mentioned in the request. 

Step-by-step guide GITHUB


  1. In the upper-right corner of requested organization's page, click + , and then click New repository.

    Drop-down with option to create a new repository

  2. Please enter the name of the repository as requested in the request. For example, "hello-world". 

    Field for entering a repository name

  3. Optionally, add a description of your repository. For example, "My first repository on GitHub."

    Field for entering a repository description

  4.  Choose to make the repository either public or private. Public repositories are visible to the public, while private repositories are only accessible to you, and people you share them with.

    Radio buttons to select private or public status
  5.  Select Initialize this repository with a README.

    Checkbox to create a README when the repository is created
  6.  Click Create repository.


Step-by-step guide GERRIT


  1. Does the project uses Self Committer Promotion?
    1. Look into the code: https://gerrit.linuxfoundation.org/infra/gitweb?p=releng/info-master.git;a=tree;h=refs/heads/master;hb=refs/heads/mast
    2. If the project uses Self Repo Creation, ask them to use it: https://docs.releng.linuxfoundation.org/en/latest/project-creation.html
  2. If the project still creates repos manually:
    1. Verify there is TSC approval (mail, not wiki since wikies can be edited by anyone)
    2. Create a committers group in identity.linuxfoundation.org (<org>-gerrit-<projects-name>-committers, for example onap-gerrit-aaf-committers)
    3. Add the committers into this group, if the group is empty, you will not be able to link it in Gerrit.
    4. In Gerrit, create a new project and add the committer group as Owner of Reference: refs/*
    5. Make sure the repo inherits from "All-Projects" unless specified differently.