From 4e85607cbc87d5a2d64d0633eb942ea0c1d768e2 Mon Sep 17 00:00:00 2001 From: Sean Roberts Date: Wed, 18 Jun 2014 12:01:29 -0700 Subject: [PATCH] spec for developer quizzes content to support the CI pipeline classroom work specificly around teaching the ci pipeline tools both local and remote Implements blueprint https://blueprints.launchpad.net/openstack-training-guides/+spec/developer-training-guide-how-to-participate-quizzes Change-Id: I426bc18843e4db57f396b7461ac0b32d32131b63 --- ...ining-guide-how-to-participate-quizzes.rst | 155 ++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 specs/juno/developer-training-guide-how-to-participate-quizzes.rst diff --git a/specs/juno/developer-training-guide-how-to-participate-quizzes.rst b/specs/juno/developer-training-guide-how-to-participate-quizzes.rst new file mode 100644 index 00000000..43d8da51 --- /dev/null +++ b/specs/juno/developer-training-guide-how-to-participate-quizzes.rst @@ -0,0 +1,155 @@ +.. + This work is licensed under a Creative Commons Attribution 3.0 Unported + License. + + http://creativecommons.org/licenses/by/3.0/legalcode + +========================================== +Title of your blueprint +========================================== +Developer training guide how to participate quizzes +https://blueprints.launchpad.net/openstack-training-guides/+spec/developer-training-guide-how-to-participate-quizzes + +Problem description +=================== +Developer training is broken up into two major parts, in depth on openstack APIs + and in depth on the CI pipeline tools. This part of the training is focused on + the quiz work to teach the CI pipeline local and remote tools. + +Proposed change +=============== +Develop quiz questions around + +Understanding the local tools in-depth: +pycharm editor +http://www.jetbrains.com/pycharm/quickstart/ +Gerrit plugin???: +http://plugins.jetbrains.com/plugin/7272 +git +Generic github information: +http://git-scm.com/book +Download: +http://git-scm.com +Some Git commands most relevant for openstack: +http://docs.openstack.org/training-guides/content/operator-getting-started-lab.html#operator-fix-doc-bug +Pycharm Git integration: +https://www.jetbrains.com/pycharm/webhelp/registering-github-account-in-pycharm.html +http://www.jetbrains.com/pycharm/webhelp/using-git-integration.html +source tree +http://www.sourcetreeapp.com +maven +General info: +http://maven.apache.org +Install Maven: +http://docs.openstack.org/training-guides/content/operator-getting-started-lab.html#operator-fix-doc-bug +git-review +http://www.mediawiki.org/wiki/Gerrit/git-review +https://pypi.python.org/pypi/git-review +https://wiki.openstack.org/wiki/GerritWorkflow#Git_Review_Installation + +Understanding the submission process in-depth: +Review submission syntax +Gerrit etiquette +https://wiki.openstack.org/wiki/GitCommitMessages +Resubmission +further reading - Documentation > Python Developer +http://docs.openstack.org/developer/openstack-projects.html +Links to source locations: +https://wiki.openstack.org/wiki/Documentation/Builds +CI Pipeline Workflow Overview +Gerrit Workflow +https://wiki.openstack.org/wiki/GerritWorkflow + +Understanding the remote tools in-depth: +sources +OpenStack CI pipeline documentation http://ci.openstack.org/ +Use Jay Pipes blog (and Pipes himself) as source http://www.joinfu.com/ +github (same links as above) +gerrit +https://gerrit-documentation.storage.googleapis.com/Documentation/2.8.1/index.html +http://www.mediawiki.org/wiki/Gerrit/Tutorial +https://wiki.openstack.org/wiki/Gerrit_Workflow +jenkins +http://jenkins-ci.org +https://wiki.jenkins-ci.org/display/JENKINS/Meet+Jenkins +Jenkin Dashboard: +https://jenkins.openstack.org +gearman +https://wiki.jenkins-ci.org/display/JENKINS/Gearman+Plugin +jeepy +Nodepool +Logstash +zuul +http://ci.openstack.org/zuul +Understanding the CI Pipeline in-depth +Common jenkins tests +Reviewing and understanding zuul +Understanding jenkins output +Understanding jenkins system manual (devstack) and automated (tempest) +integration tests + + +Alternatives +------------ +None + +Data model impact +----------------- +None + +REST API impact +--------------- +None + +Security impact +--------------- +None + +Notifications impact +-------------------- +None + +Other end user impact +--------------------- +None + +Performance Impact +------------------ +None + +Other deployer impact +--------------------- +None + +Developer impact +---------------- +None + +Implementation +============== + +Assignee(s) +----------- +sarob + +Work Items +---------- +Write up the prerequisites chapter with the information presented above. + +Dependencies +============ +None + +Testing +======= +None + +Documentation Impact +==================== +None + +References +========== +None + +