User Tools

Site Tools


agl-distro:contributing

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
agl-distro:contributing [2016/10/27 17:42]
jsmoeller
agl-distro:contributing [2020/07/10 21:02] (current)
jsmoeller
Line 1: Line 1:
 ====== Contributing to the AGL Distro ====== ====== Contributing to the AGL Distro ======
  
-The AGL community appreciates feedback, ideas, suggestion, bugs and documentation just as much as code. Please join the irc conversation at the #automotive channel on irc.freenode.net and our [[http://lists.linuxfoundation.org/mailman/listinfo/​automotive-discussions|mailing list]].+The AGL community appreciates feedback, ideas, suggestion, bugs and documentation just as much as code. Please join the irc conversation at the #automotive channel on irc.freenode.net and our [[https://lists.automotivelinux.org/g/agl-dev-community|mailing list]].
  
 ===== Contributing Code ===== ===== Contributing Code =====
Line 22: Line 22:
   - [[https://​gerrit.automotivelinux.org/​gerrit/#/​admin/​projects/​src | src ]] - contains source code repositories where AGL is the upstream. This code is officially part of the AGL distribution.   - [[https://​gerrit.automotivelinux.org/​gerrit/#/​admin/​projects/​src | src ]] - contains source code repositories where AGL is the upstream. This code is officially part of the AGL distribution.
   - [[https://​gerrit.automotivelinux.org/​gerrit/#/​admin/​projects/​staging | staging]] - contains source code repositories where AGL developers can work on new features or components that can eventually be included in the AGL distribution. ​   - [[https://​gerrit.automotivelinux.org/​gerrit/#/​admin/​projects/​staging | staging]] - contains source code repositories where AGL developers can work on new features or components that can eventually be included in the AGL distribution. ​
 +
 +==== Git repository requests ====
  
 Developers may request a new project to be set up in the src or staging repository by submitting a [[https://​jira.automotivelinux.org | Jira ticket]]. Ticket type should be a "​Task"​ Developers may request a new project to be set up in the src or staging repository by submitting a [[https://​jira.automotivelinux.org | Jira ticket]]. Ticket type should be a "​Task"​
Line 33: Line 35:
 for the repo called "<​name>​-owners"​ . for the repo called "<​name>​-owners"​ .
  
-=== Access Control ===+==== Access Control ​====
  
 Access control to gerrit is defined in this [[https://​docs.google.com/​spreadsheets/​d/​1lA_B7LEwn_VyJy_JplRNe9AOKTRGAMtpJ66JHm-vJCM/​pubhtml?​gid=0&​single=true | google doc spreadsheet]]. ​ Access control to gerrit is defined in this [[https://​docs.google.com/​spreadsheets/​d/​1lA_B7LEwn_VyJy_JplRNe9AOKTRGAMtpJ66JHm-vJCM/​pubhtml?​gid=0&​single=true | google doc spreadsheet]]. ​
Line 91: Line 93:
   - **App Developer (AD)** - Someone who is developing applications to be used with AGL. The AD is assumed to need no knowledge of Yocto and relies on an SDK.    - **App Developer (AD)** - Someone who is developing applications to be used with AGL. The AD is assumed to need no knowledge of Yocto and relies on an SDK. 
   - **Registered Developer (RD)** - Someone who wants to contribute code to AGL but may not be affiliated with a subsystem   - **Registered Developer (RD)** - Someone who wants to contribute code to AGL but may not be affiliated with a subsystem
-  - <del> **Subsystem Developer (SD)** - Someone who actively develops code for a particular subsystem of AGL. The person can be a SD for one subsystem and Registered Developer for another Subsystem</​del>​ 
   - **Subsystem Maintainer (SM)** - A SM is the same as Subsystem Developer but with additional privileges that allow him to submit changes to the master branch, tracking branch, or a maintenance branch   - **Subsystem Maintainer (SM)** - A SM is the same as Subsystem Developer but with additional privileges that allow him to submit changes to the master branch, tracking branch, or a maintenance branch
   - **System Integrator (SI)**   - **System Integrator (SI)**
Line 108: Line 109:
  
 ===== Prepare to push changes in Gerrit ===== ===== Prepare to push changes in Gerrit =====
-By default the repo tool will have clone git repo with http. You need to change the git setting ​to use ssh+By default the repo tool will have cloned the git repos with http for fetch and ssh to push.  
-From meta-agl ​directory, use the command: +   #cd meta-agl 
-   git remote ​set-url agl ssh://YourGerritID@gerrit.automotivelinux.org:​29418/​AGL/​meta-agl +   #git remote -
-or +       ​agl https://​gerrit.automotivelinux.org/​gerrit/​AGL/​meta-agl (fetch) 
-if you want to use your ssh config like:+       agl ssh://​gerrit.automotivelinux.org:​29418/​AGL/​meta-agl ​(push) 
 + 
 + 
 +If you want to use your ssh config, add your gerrit user accout to your ssh config file like:
    #cat ~/​.ssh/​config    #cat ~/​.ssh/​config
      Host gerrit.automotivelinux.org      Host gerrit.automotivelinux.org
-     Port 29418 
      User XXXMyNameXXX      User XXXMyNameXXX
  
-   git remote set-url agl ssh://​gerrit.automotivelinux.org/​AGL/​meta-agl +Note: you still need to enter you ssh public key in Gerrit. You can find a HowTo [[ https://​www.mediawiki.org/​wiki/​Gerrit/​Tutorial#​Set_Up_SSH_Keys_in_Gerrit | here ]]
- +
-Then you still need to enter you ssh public key in Gerrit. You can find a HowTo [[ https://​www.mediawiki.org/​wiki/​Gerrit/​Tutorial#​Set_Up_SSH_Keys_in_Gerrit | here ]]+
  
 ===== Push changes for review to Gerrit ==== ===== Push changes for review to Gerrit ====
Line 133: Line 134:
   * **Or** for more convenience,​ install "​git-review"​ and instead of git push use:   * **Or** for more convenience,​ install "​git-review"​ and instead of git push use:
  
 +   # first time only
 +   git review -s  ​
 +
 +   # then to push use
    git review    git review
  
agl-distro/contributing.1477590127.txt.gz · Last modified: 2016/10/27 17:42 by jsmoeller