...
- All committer changes require ToC approval. This can be obtained either by requesting a ToC meeting agenda item to bring a motion to ToC approval, or by emailing the request to the toc@lists.o-ran-sc.org list for a ToC member email vote.
- For any approved project, committer change request is to be made the PTL of the project. For repositories intended for seed code contribution that are not covered by any approved project, the request is to be made by the PTL of the Integration and Testing project.
- The request to ToC should include the following information:
- A list of committers impacted by the change, each with the committer's name, the committer's Linux Foundation registered email, the list of repositories affected and for each repository the action (add/remove), and a brief description of the reason.
The next step is to work with Linux Foundation to make the committer change into the Gerrit system. Because the LF is transitioning from a ticket driven process to a self-service process, we will need to do both for now.
Ticket driven process Self-service process - After the ToC approval is received, it is time to open a service ticket on Linux Foundation’s web based ticketing portal: ( https://jira.linuxfoundation.org/servicedesk/customer/portals ). The access to the ticketing system requires Linux Foundation ID login.
- For adding committer right to repositories, one request is needed per committer, filed at Linux Foundation Helpdesk under the following link: https://jira.linuxfoundation.org/servicedesk/customer/portal/2/create/129. At the ticket page, fill with the following:
- Under Project, select “ORAN”;
- Under “Repository”, enter the list of repository names.
- Under “Approval links”, enter a link to the ToC approval obtained from step 1. ToC vote conducted during ToC meeting can be referenced using a link to the meeting minute; email vote can be presented using a link to the email thread on the groups.io mailing list site.
- Clicking on "Create" button to create the ticket.
- For removing committer right from repositories, since there is no specific form, we can use this generic "change to existing service" form at: https://jira.linuxfoundation.org/servicedesk/customer/portal/2/create/38.
- Once the ticket is created, the requester will receive status updates from Linux Foundation ticketing system as the ticket is being processed. Requests for customer input are also notified via emails.
- After the ticket is completed, the committer will receive activation an email from Linux Foundation, notifying that the committer has been granted committer right. Such emails may have the following subject line: “LF Release Engineering Automation has sent you a Linux Foundation ID invite”. It is important for the committer to follow the link embedded in the email to complete the activation. Since each of such activation email is specifically for one repository, it is important to activate the committer right for all of such emails, if multiple repositories (tickets) are requested at the same time.
a. PTL to edit the committer section of the INFO.yaml file at the repo root and merge the change.
- To verify that the committer right is set correctly, the committer needs to access the Gerrit site at http://gerrit.oran-osc.org and login. After login to the Gerrit site, clicking on the committer name at the top right corner, select Settings then Groups, and check the list of group names. This lists shows the repositories that the said committer has been granted committer rights for, each in the format of ldap/<repo-name>.