How to Contribute to OpenStack

Guides on how to contribute to OpenStack Projects

1. How to Contribute to OpenStack Gene Kuo 1
2. Outline • About Me • OpenStack Gerrit • Gerrit • Contribute • Commit Message • Code Review • OpenStack Translate • Ask OpenStack 2
3. About Me • Gene Kuo • gene@openstack.org • Electronics Engineering, NCTU • OpenStack Community Intern 3
4. OpenStack Gerrit https://review.openstack.org 4
5. Accounts • LaunchPad 
 (https://launchpad.net/openstack) • OpenStack Foundation Member 
 (https://www.openstack.org/profile) 5
6. Gerrit • Username • Agreement (ICLA) • Contact Information • SSH keys 6
7. Install git-review • Ubuntu • apt-get install git-review • Fedora, RHEL(EPEL enable) • yum install git-review • openSUSE • zypper in python-git-review • Unix-like • pip install git-review 7
8. Gerrit Setup 8 1 git config --global gitreview.username yourgerritusername 2 git config user.name "xxxxxx" 3 git config user.email "xxxxxx" To test 1 git clone https://git.openstack.org/openstack/<projectname>.git 2 cd <projectname> 3 git review -s
9. Gerrit Over HTTPS • Gernerate HTTPS password in Gerrit 9 1 git remote add gerrit https://<username>@review.openstack.org/ <umbrella repository name>/<repository name>.git
10. Contributing • clone the project • create a branch • start coding !!! • commit • git-review • https://review.openstack.org/XXXXXX 10
11. Contributing 11 1 git clone https://git.openstack.org/openstack/<projectname>.git 2 cd <projectname> 3 git checkout -b bug/123456789 4 git add "filename" 5 git commit 6 git review
13. Commit Message • First Line: Title • Third Line and Further: commit content, purpose, or features • Second Line from bottom: newline (optional) • Last Line (optional) • Closes-Bug: #XXXXXXXX • Partial-Bug: #XXXXXXX • Related-Bug: #XXXXXXX • https://wiki.openstack.org/wiki/GitCommitMessages 13
14. Commit Message 14
15. Code Review • 2 Core reviewers giving +2 • Passed Zuul/Jenkins CI tests • Workflow +1 15
16. 16 http://docs.openstack.org/infra/manual/developers.html
17. OpenStack Translate 17
18. OpenStack Translate • https://translate.openstack.org • All projects are translated through the system • Zanata based 18
19. Ask OpenStack 19
21. Reference • http://docs.openstack.org/infra/manual/ developers.html • https://wiki.openstack.org/wiki/GitCommitMessages 21
22. Demo 22
23. Q&A 23