OpenStack Conference, 2014 Speakers: Angela Streeter Egle Sigle Iccha Sethi

1. Iccha Sethi @IcchaSethi
Egle Sigler @eglute
Angela Streeter @angelastreeter
So You Want To Be an OpenStack
Contributor?

2. #rackstackatl
• Intro
• Who can contribute
• What it takes to be a contributor
• Finding something to contribute
• Life cycle of a patch
Outline
2

3. #rackstackatlRACKSPACE® HOSTING | WWW.RACKSPACE.COM
What is OpenStack?
Why Contribute to OpenStack?

4. #rackstackatl
What is OpenStack?
4

5. #rackstackatl
• Be part of growing community
• Build your expertise
• Work with some really great people
• Find a job: everyone is hiring!
• Learn new skills
• Come to the OpenStack Summit (Paris!)
• Join the rebel alliance to help build Planet Scale Cloud!
RACKSPACE® HOSTING | WWW.RACKSPACE.COM 5
Why Contribute?

6. #rackstackatlRACKSPACE® HOSTING | WWW.RACKSPACE.COM
So You Want To Contribute?
Great!

7. #rackstackatl
Total Contributions
7
76K Commits
2000 Developers
38K Tickets
55K Mail Messages
… and counting!
http://activity.openstack.org/dash/releases/index.html?data_dir=data/whole_project

8. #rackstackatl
Who Can Contribute?
8
• Programmers: code
• Testers: test and break
• Writers: documentation
• Operators: cloud builders and maintainers
• Security People
• Designers
• Translators
• Gardeners: increasing comments in code, reducing pylint violations, increasing code coverage, etc.
• Reviewers!!!

9. #rackstackatlRACKSPACE® HOSTING | WWW.RACKSPACE.COM
What It Takes To Contribute

10. #rackstackatl
• Testing:
– Report issues
– Triage issues: prioritize, confirm, review incomplete or stale bugs
• Security:
– Join mailing lists, review code reviews, look for security issues, fix code
• Documentation:
– Fix documentation bugs
– Write documentation
• Designers/UIX:
– Review current features as a user,
– Design new features
• Developers:
– Keep testing, security, documentation, designers, operators, and everyone else busy
Find Something To Contribute

11. #rackstackatl
• Launchpad Account: https://login.launchpad.net/+new_account
– Add SSH keys to Launchpad account
– Launchpad and Gerritt accounts are the same
• Join OpenStack Foundation: https://www.openstack.org/join/
• Sign Contributor’s License Agreement: https://review.openstack.org/#/settings/agreements
– https://review.openstack.org/static/cla.html
• GitHub Account: https://github.com/
– Install and configure git locally
– Install and configure git-review locally
• Use the same email address for all your accounts!
• https://wiki.openstack.org/wiki/HowToContribute
Do This Once
11

12. #rackstackatl
• DevStack is awesome, try it.
Test Environment
12

13. #rackstackatl
1. Find some work to do.
2. Create a local git branch based on master.
3. Work work work.
4. Create a single commit based on your local branch.
5. Make a patch using git review that’s pushed to gerrit (review.openstack.org).
6. Wait for reviews (work on other patches).
7. Address reviews (work work work).
8. Encourage two core members give it a +2 vote and click Approved (work on other patches).
Basic Workflow
13

14. #rackstackatl
• Keep line length at 80
• No period at the end of the first line
• Insert special text:
– Closes-Bug: nnnnnnn
– Partial-Bug: nnnnnnn
– Bp:<text-from-Launchpad-URL>
– DocImpact
– Co-Authored-By: <name@example.org>
Commit Messages Guidelines
14

15. #rackstackatl
• Log in to http://review.openstack.org.
• Enter comments inline.
• Click Review button to publish comments.
Review Issues
15

16. #rackstackatl
1. Get the six-digit patch number from review.openstack.org, copy it.
2. At the command line, change to the directory where the repo is stored.
3. Enter:
$ git review -d nnnnn
Reviewing Locally
16

17. #rackstackatl
• Mailing lists:
– 12 major lists (General, Announcements, Operators, QA, Foundation, Security, Community, Translation, etc.
– Sign up to as many as you want to
– Lurk or participate, up to you
– Tip: setup filters
• IRC
– Freenode
– 42 different channels
• Ask OpenStack: ask.openstack.org
• Design Summit
• Meetups
RACKSPACE® HOSTING | WWW.RACKSPACE.COM 17
Communications

18. #rackstackatl
RACKSPACE® HOSTING | 5000 WALZEM ROAD | SAN ANTONIO, TX 78218
US SALES: 1-800-961-2888 | US SUPPORT: 1-800-961-4454 | WWW.RACKSPACE.COM
RACKSPACE® HOSTING | © RACKSPACE US, INC. | RACKSPACE® AND FANATICAL SUPPORT® ARE SERVICE MARKS OF RACKSPACE US, INC. REGISTERED IN TH E UNITED STATES AND OTHER COUNTRIES. | WWW.RACKSPACE.COMRACKSPACE® HOSTING | © RACKSPACE US, INC. | RACKSPACE® AND FANATICAL SUPPORT® ARE SERVICE MARKS OF RACKSPACE US, INC. REGISTERED IN TH E UNITED STATES AND OTHER COUNTRIES. | WWW.RACKSPACE.COM

19. #rackstackatl
• Low-hanging-fruit tag
• Triaged
• No one else is already assigned
Work on a Bug
19

20. #rackstackatl
• Get a copy locally
git checkout master; git remote update; git pull origin master
git review –d nnnnnn
• Work work work edit edit
• Push back up to gerrit (review.openstack.org)
git commit -a --amend
git review -v
Demo Patching a Patch
20

21. #rackstackatl
• In the Devstack-env Cloud Server:
git checkout master; git remote update; git pull origin master
git checkout -b bug-1188073
• (You’ll need to add a public key and install git review again.)
• Work work work work edit
git commit -a
git commit -a --amend
git review -v
Demo Working on a Bug
21