2. About Us
● Outreachy (https://outreachy.gnome.org) interns @OpenStack
● https://akankshaha.wordpress.com
● https://sanakhan2011.wordpress.com
3. Agenda
● Why contribute to OpenStack?
● Ways in which you can contribute
● Steps to contribute
● Questions?
4. Why should You contribute to Openstack?
● Beginner friendly and active contributor community
● Work on the project being used by millions
● Get to learn from experienced developers around the world
● Rich set of guidelines and documentation
● Huge bunch of interesting things to learn
6. Ways in which you can contribute?
You can work on a wide range of things:
● Documentation
● A New Feature
● Help Fix Bugs
● Report Bugs
● Bug Triaging
● Translation
https://wiki.openstack.org/wiki/How_To_Contribute
8. Step 1: Get Your Accounts Created
1. Register your Launchpad account at https://login.launchpad.net
9. 2. Sign Up for Foundation Membership at the OpenStack Foundation
● Complete The Individual Member Application
● Read and Sign the terms of becoming an OpenStack Foundation Individual Member.
https://www.openstack.org/join
10.
11. 3. Gerrit Review System
● Log into with your Launchpad account.
● Use the same username for Gerrit as the Launchpad username.
● Sign the appropriate Individual Contributor License Agreement
● Upload your Public SSH Key to review.openstack.org
12.
13. Step 2: Setting up DevStack
1. Install Virtual Machine
2. Clone devstack repository
a. $ git clone https://git.openstack.org/openstack-dev/devstack.git
3. Go to the devstack directory
a. $ cd devstack
4. Copy local configuration file from devstack/samples to devstack
a. cp samples/local.conf local.conf
5. Run the stack.sh script
a. $ ./stack.sh
22. Step 4: Fixing the bug
● Try to reproduce the bug using Devstack.
● In case of doubts, add a comment to the bug report.
● If you need more assistance, you can seek help on IRC or Mailing List
● IRC Channel List : https://wiki.openstack.org/wiki/IRC
● Mailing Lists : https://wiki.openstack.org/wiki/Mailing_Lists
23. Step 4.1: Fixing the bug - Workflow
1. Configure git and git-review
a. $ git config --global user.name "Firstname Lastname"
b. $ git config --global user.email "your_email@youremail.com"
c. $ git config --global gitreview.username yourgerritusername
d. $ git review -s
2. Clone the project
a. $ git clone https://git.openstack.org/openstack/<projectname>.git
3. Make sure you have the latest upstream changes
a. $ git remote update
b. $ git checkout master
c. $ git pull --ff-only origin master
24. Step 4.1: Fixing the bug - Workflow
4. Create a topic branch
a. $ git checkout -b TOPIC-BRANCH
b. Name the branch as : bug/BUG-NUMBER
5. Make code/doc changes
6. Test your changes
26. Step 6: Sending the patch upstream for review
1. $ git review
You will get the link where your patch is uploaded for review on review.openstack.org
2. Address the review comments and resend the patch if required.