your first patch to open stack
TRANSCRIPT
![Page 1: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/1.jpg)
Your First Patch to OpenStackBy Akanksha Agrawal and Sana Khan
![Page 2: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/2.jpg)
About Us
● Outreachy (https://outreachy.gnome.org) interns @OpenStack
● https://akankshaha.wordpress.com
● https://sanakhan2011.wordpress.com
![Page 3: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/3.jpg)
Agenda
● Why contribute to OpenStack?
● Ways in which you can contribute
● Steps to contribute
● Questions?
![Page 4: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/4.jpg)
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
![Page 5: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/5.jpg)
Who can contribute to OpenStack?
● Anyone
![Page 6: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/6.jpg)
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
![Page 7: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/7.jpg)
Steps to follow
![Page 8: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/8.jpg)
Step 1: Get Your Accounts Created
1. Register your Launchpad account at https://login.launchpad.net
![Page 9: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/9.jpg)
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
![Page 10: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/10.jpg)
![Page 11: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/11.jpg)
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
![Page 12: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/12.jpg)
![Page 13: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/13.jpg)
Step 2: Setting up DevStack1. 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
![Page 14: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/14.jpg)
Step 3: Selecting a bug to work upon
![Page 15: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/15.jpg)
Selecting your Project
![Page 16: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/16.jpg)
Go the Bugs Page
![Page 17: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/17.jpg)
Advanced Search Options
![Page 18: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/18.jpg)
Customise Visible Bug Information
![Page 19: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/19.jpg)
Sort by Age, Last Updated Date, Assignee
![Page 20: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/20.jpg)
Selecting a low-hanging fruit
![Page 21: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/21.jpg)
Assigning the Bug to Yourself
![Page 22: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/22.jpg)
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
![Page 23: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/23.jpg)
Step 4.1: Fixing the bug - Workflow
1. Configure git and git-reviewa. $ git config --global user.name "Firstname Lastname"
b. $ git config --global user.email "[email protected]"
c. $ git config --global gitreview.username yourgerritusername
d. $ git review -s
2. Clone the projecta. $ git clone https://git.openstack.org/openstack/<projectname>.git
3. Make sure you have the latest upstream changesa. $ git remote update
b. $ git checkout master
c. $ git pull --ff-only origin master
![Page 24: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/24.jpg)
Step 4.1: Fixing the bug - Workflow
4. Create a topic brancha. $ git checkout -b TOPIC-BRANCH
b. Name the branch as : bug/BUG-NUMBER
5. Make code/doc changes
6. Test your changes
![Page 25: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/25.jpg)
Step 5: Committing the Change
1. $ git commit -a
![Page 26: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/26.jpg)
Step 6: Sending the patch upstream for review
1. $ git reviewYou 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.
![Page 27: Your first patch to open stack](https://reader034.vdocuments.site/reader034/viewer/2022051523/58e681011a28ab6a5b8b4dfb/html5/thumbnails/27.jpg)
Thank You!Find us @:
● Akanksha Agrawal○ IRC Handle: Akanksha08@freenode○ Twitter Handle: @AkankshaHA○ https://www.linkedin.com/in/Akanksha08
● Sana Khan○ IRC Handle: buttercup@freenode○ Twitter Handle: @sanakhan_libre