View source for OpenStack Upstream Training/Info/ko


== 소개 == 

OpenStack은 가장 거대한 협업 소프트웨어 개발 프로젝트 중 하나입니다. 전세계 80여 개국에서 2000 명이 넘는 개발자들이 참여하고 있습니다. 그 규모에 의해 초래되는 사회적 규범이나 기술적 인 습관의 다양성이 특징입니다. 이러한 것들로 인해 새로 온 사람들이 OpenStack 프로젝트에 통합됨에 따른 변화의 속도가 확연히 줄어들 수 있습니다.

전문 개발자가이 어려움에 대해 극복할 수 있도록 지원하기 위해 교육 프로그램을 마련했습니다. 버그 수정과 기능 추가가 가능한 한 빨리 OpenStack 프로젝트에 정확히 받아 들여지는 방법을 설명합니다. 이 교육 프로그램은 수강자가 2 일 집합 교육과 온라인 멘토링을 통해 OpenStack 받아 들여지기까지 실제로 버그 수정 및 새로운 기능 추가에 대처할 필요가 있습니다. 프로젝트의 기술적 인 도구와 지역 사회와의 관계의 복잡성에 대해 2 일간의 집합 교육에서 설명합니다. 후속 세션에서는 수강자가 의문으로 느낀 점을 해결하기 위해 개별 온라인 세션을받을 수 있습니다.

== 목표 == 

* 상용 제품 로드맵 및 OpenStack 릴리즈 주기를 신속하게 통합
* 실제로 OpenStack 구성 요소에 패치를 하나 컨트리뷰션
* 기술 도구를 마스터하기
* OpenStack 컨트리뷰션의 흐름과 사회 규범을 이해

== 대상 청중 == 

* Developers
* System administrators

== Prerequisites == 

* Being able to read and write English at a technical level.
* If contributing code, being technically proficient enough to carry out simple bug fixes in the project.
* If contributing documentation, being able to produce documents in the project's chosen infrastructure.
* Having at least 8 hours a week to dedicate to the project, be it through programming or through interacting with the community.

== Duration == 

* Face-to-face section: 2 days
* Online section: 10 one-hour individual mentoring sessions over a period of 4 to 10 weeks

== Infrastructure == 

[[OpenStack_Upstream_Training/Setup_DevStack|ready to use devstack VM]] for participants with network connectivity but troubles with their laptop

= Course Outline = 

== First day == 

=== Introduction === 

* A week before Day 1: choice of a contribution, via email, with each participant
* Day 1: How OpenStack is made
* Day 1: Learn and practice git, gerrit, IRC

* Day 2: The theory of contribution
* Day 2: Lego contribution simulation
* Day 2: Individual presentation of the contribution plan
* Day 2: Online mentoring

=== How OpenStack is made (3h including 1h30 exercises) === 

* [https://wiki.openstack.org/wiki/Release_Cycle Release cycle] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/01-release-cycle.rst slides] )
** [https://wiki.openstack.org/wiki/Release_Cycle#Planning_.28Design.2C_Discuss_and_Target.29 Planning (Design, Discuss and Target)]
** [https://wiki.openstack.org/wiki/Release_Cycle#Implementation_.28Milestone_iterations.29 Implementation (Milestone iterations)]
** [https://wiki.openstack.org/wiki/Release_Cycle#Pre-release_.28Release_Candidates_dance.29 Pre-release (Release Candidates dance)]
*** [https://wiki.openstack.org/wiki/Release_Cycle#Release_candidate_1 Release candidate 1]
*** [https://wiki.openstack.org/wiki/Release_Cycle#Other_release_candidates Other release candidates]
*** [https://wiki.openstack.org/wiki/Release_Cycle#Release_day Release day]
** Exercise: based on the [https://wiki.openstack.org/wiki/Juno_Release_Schedule Juno release schedule] find the URL of a document or a patch that belongs to each of the above steps.
* Relevant actors ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/02-relevant-actors.rst slides] )
** [http://www.stackalytics.com/?release=juno&metric=commits&project_type=integrated&module=&company=&user_id= commiters] companies
** [http://www.stackalytics.com/?release=juno&metric=commits&project_type=integrated&module=&company=&user_id= commiters] individuals (bottom of the page)
** Your management
* [https://wiki.openstack.org/wiki/Governance/Foundation/TechnicalCommittee Technical Committee] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/03-technical-committee.rst slides] )
** Decide what is an [https://wiki.openstack.org/wiki/Programs OpenStack Program]
** [https://wiki.openstack.org/wiki/Governance/TechnicalCommittee meetings] 
** Exercise: read [http://eavesdrop.openstack.org/meetings/tc/2014/tc.2014-04-01-20.03.log.html archived] and briefly comment on [https://etherpad.openstack.org/p/keystone-incubation-integration-requirements keystone document]
** [https://wiki.openstack.org/wiki/Governance/Foundation/TechnicalCommittee#Program_Leads PTLs]
** [https://wiki.openstack.org/wiki/Governance/Foundation/TechnicalCommittee#Voters_for_PTL_seats_.28.22APC.22.29 APC]
** [https://wiki.openstack.org/wiki/Governance/Foundation/TechnicalCommittee#Voters_for_TC_seats_.28.22ATC.22.29 ATC]
** Exercise: each APC / ATC in the class add a URL to the etherpad proving it
* [https://wiki.openstack.org/wiki/Governance/NewProjects Program ecosystem]  ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/04-program-ecosystem.rst slides] )
** [https://wiki.openstack.org/wiki/Governance/NewProjects#Incubation Incubated]
** [https://wiki.openstack.org/wiki/Governance/NewProjects#Integrated Integrated]
** [https://wiki.openstack.org/wiki/Governance/NewProjects#Core_.3F Core]
** [http://ci.openstack.org/stackforge.html Stackforge]
** Exercise: What kind of Program do you contribute to ?
* [https://wiki.openstack.org/wiki/Summit Design summits]  ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/05-design-summit.rst slides] )
** [https://wiki.openstack.org/wiki/Summit#Propose_sessions propose sessions]
** [https://wiki.openstack.org/wiki/Summit#At_the_Design_Summit attend or lead a session]
** [https://wiki.openstack.org/wiki/Summit/Kilo/Etherpads Kilo Summit Etherpads]
** Exercise: Add a session proposal regarding your contribution in an etherpad, review two proposals
* [https://wiki.openstack.org/wiki/Meetings IRC meetings]  ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/06-irc-meetings.rst slides] )
** [http://ci.openstack.org/meetbot.html modified] [http://wiki.debian.org/MeetBot meetbot]
** #info - Add an info item to the minutes. People should liberally use this for important things they say, so that they can be logged in the minutes. 
** #action - Document an action item in the minutes. Include any nicknames in the line, and the item will be assigned to them. (nicknames are case-sensitive) 
** #help - Add a "Call for Help" to the minutes. Use this command when you need to recruit someone to do a task. (Counter-intuitively, this doesn't provide help on the bot)
** Exercise: lunch menu online meeting

=== Workflow of an OpenStack contribution and tools (3h including 2h exercises) === 

* [http://devstack.org/ devstack] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/11-devstack.rst slides] )
** Ubuntu or Fedora
** git clone https://github.com/openstack-dev/devstack.git
** [http://devstack.org/configuration.html minimal configuration]
** cd devstack; ./stack.sh
** Exercise: get the code for the targeted contribution
* [[How_To_Contribute|HOW to contribute URL]] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/12-howtocontribute.rst slides] )
** [[Puppet-openstack#Contributing_to_the_modules|puppet stackforge]]
** [[Documentation/HowTo|documentation]]
** [http://docs.openstack.org/training-guides/content/under-construction.html training guides]
** Excercise: Apply for individual membership and sign the CLA
* [https://help.launchpad.net/ launchpad] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/13-launchpad.rst slides] )
** [[Blueprints|blueprints]]
** [[Bugs|bugs]]
*** [[Bugs#Bugs_reference|Status, Importance, Assigned To, Milestone, Tags]]
*** [[Bugs#Reporting|reporting a bug]]
*** [[Bugs#Confirming_.26_prioritizing|confirming and prioritizing]]
*** [[Bugs#Debugging_.28optional.29|debugging]]
*** [[Bugs#Bugfixing|bugfixing]]
** Exercise: review other launchpad bugs and improve yours
* [[GerritWorkflow|gerrit workflow]] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/14-gerrit.rst slides] )
** [[GerritWorkflow#Account_Setup|account setup]]
** [[GerritWorkflow#Git_Review_Installation|git review installation]]
** [[GerritWorkflow#SSH_Setup|ssh setup]]
** [[GerritWorkflow#Project_Setup|project setup]]
** [[GerritWorkflow#Normal_Workflow|gerrit workflow]]
** [[Testing#Unit_Tests|running unit tests]]
** [http://www.mediawiki.org/wiki/Gerrit/Advanced_usage review dependencies]
** Exercise: push a wip or draft and invite reviewers
* Branching model ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/15-branching-model.rst slides] )
** [[BranchModel|development]]
** [[StableBranch|stable]]
** Exercise: checkout the latest stable branch
* [[GerritJenkinsGit#Reviewing_a_Change|reviewing]]  ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/16-reviewing.rst slides] )
* [[GerritWorkflow#Committing_Changes|writing a commit message]] ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/17-commit-message.rst slides] )
** reference to a bug or a blueprint
** amending a commit message
** Exercise: review each other messages on the draft
* [[GerritJenkinsGit|jenkins]]  ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/18-jenkins.rst slides] )
** Exercise: add an error and match it to the jenkins message

== Second day == 

=== The Contribution Process (1 hour) === 

 ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/19-training-contribution-process.rst slides] )
* Take the pulse of the project.
* Figure out who's behind it.
* Determine the project's social groups.
* Assess your approach.
* Engage immediately.
* Play with your network.
* Perform the smaller tasks.
* Choose a question.
* Familiarize yourself with the code of conduct.
* Understand the conventions.
* Explain what you do.
* Prepare the backport.
* Learn what's local and what's upstream.
* Learn what distinguishes good work flow from bad work flow.
* Quantify the delta.
* Speed up the acceptance.
* Determine the time frame.
* Maximize karma.
* Work in parallel.
* Archive and collect.

=== Agile for Contributors (15 min) === 

 ( [https://github.com/openstack/training-guides/blob/master/doc/upstream-training/20-training-agile-for-contributors.rst slides] )
* Apply agile
* Who is the customer?
* Company & Upstream product owner
* Sprint review presentation to Upstream

=== Contribution Simulation (2 hour) === 

The students make a virtual contribution simulation using Lego bricks as props, with the goal of expanding a Lego town, built by upstream. They are divided into teams; the teacher is by turns the product owner in the company and the upstream.

=== Contribution Planning (2 hours) === 

 ( [http://dachary.org/loic/openstack-training/training-student-project-sample.odp odp slides] [http://dachary.org/loic/openstack-training/training-student-project-sample.pdf pdf slides] )


* The students use template slides to prepare a 5-minute presentation of their planned contribution.
* A sample presentation is given by the teacher, as an example.
* Each student group prepares a presentation describing:
** the contribution they plan to work on during the online sessions,
** how they will engage with the Upstream,
** how it contributes to the company's agenda
** and whom they will be working with.
* Each student group presents its slides to the class

=== Etherpad ===

https://etherpad.openstack.org/p/kilo-upstream-training