User Tools
agl-distro:contributing
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
agl-distro:contributing [2016/10/27 17:42] jsmoeller |
agl-distro:contributing [2024/09/06 11:28] (current) jsmoeller old revision restored (2020/07/10 21:02) |
||
|---|---|---|---|
| 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 -v |
| - | 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
Page Tools
