Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Your first patch to open stack

711 views

Published on

This presentation gives you an overview of how to contribute to OpenStack. It is intended for beginners wanting to contribute to OpenStack

Published in: Technology
  • Be the first to comment

Your first patch to open stack

  1. 1. Your First Patch to OpenStack By Akanksha Agrawal and Sana Khan
  2. 2. About Us ● Outreachy (https://outreachy.gnome.org) interns @OpenStack ● https://akankshaha.wordpress.com ● https://sanakhan2011.wordpress.com
  3. 3. Agenda ● Why contribute to OpenStack? ● Ways in which you can contribute ● Steps to contribute ● Questions?
  4. 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
  5. 5. Who can contribute to OpenStack? ● Anyone
  6. 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
  7. 7. Steps to follow
  8. 8. Step 1: Get Your Accounts Created 1. Register your Launchpad account at https://login.launchpad.net
  9. 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. 10. 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
  11. 11. 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
  12. 12. Step 3: Selecting a bug to work upon
  13. 13. Selecting your Project
  14. 14. Go the Bugs Page
  15. 15. Advanced Search Options
  16. 16. Customise Visible Bug Information
  17. 17. Sort by Age, Last Updated Date, Assignee
  18. 18. Selecting a low-hanging fruit
  19. 19. Assigning the Bug to Yourself
  20. 20. 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
  21. 21. 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
  22. 22. 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
  23. 23. Step 5: Committing the Change 1. $ git commit -a
  24. 24. 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.
  25. 25. 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

×