How to Contribute to OpenStack

Slide 1

Slide 1 text

How to Contribute to OpenStack Gene Kuo 1

Slide 2

Slide 2 text

Outline • About Me • OpenStack Gerrit • Gerrit • Contribute • Commit Message • Code Review • OpenStack Translate • Ask OpenStack 2

Slide 3

Slide 3 text

About Me • Gene Kuo • [email protected] • Electronics Engineering, NCTU • OpenStack Community Intern 3

Slide 4

Slide 4 text

OpenStack Gerrit https://review.openstack.org 4

Slide 5

Slide 5 text

Accounts • LaunchPad   (https://launchpad.net/openstack) • OpenStack Foundation Member   (https://www.openstack.org/proﬁle) 5

Slide 6

Slide 6 text

Gerrit • Username • Agreement (ICLA) • Contact Information • SSH keys 6

Slide 7

Slide 7 text

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

Slide 8

Slide 8 text

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/.git 2 cd 3 git review -s

Slide 9

Slide 9 text

Gerrit Over HTTPS • Gernerate HTTPS password in Gerrit 9 1 git remote add gerrit https://@review.openstack.org/ /.git

Slide 10

Slide 10 text

Contributing • clone the project • create a branch • start coding !!! • commit • git-review • https://review.openstack.org/XXXXXX 10

Slide 11

Slide 11 text

Contributing 11 1 git clone https://git.openstack.org/openstack/.git 2 cd 3 git checkout -b bug/123456789 4 git add "filename" 5 git commit 6 git review

Slide 12

Slide 12 text

Slide 13

Slide 13 text

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

Slide 14

Slide 14 text

Commit Message 14

Slide 15

Slide 15 text

Code Review • 2 Core reviewers giving +2 • Passed Zuul/Jenkins CI tests • Workﬂow +1 15

Slide 16

Slide 16 text

16 http://docs.openstack.org/infra/manual/developers.html

Slide 17

Slide 17 text

OpenStack Translate 17

Slide 18

Slide 18 text

OpenStack Translate • https://translate.openstack.org • All projects are translated through the system • Zanata based 18

Slide 19

Slide 19 text

Ask OpenStack 19

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Reference • http://docs.openstack.org/infra/manual/ developers.html • https://wiki.openstack.org/wiki/GitCommitMessages 21