{"action":"created","comment":{"url":"https://api.github.com/repos/ceph/ceph/pulls/comments/56764308","id":56764308,"diff_hunk":"@@ -1119,6 +1119,70 @@ there::\n This will keep the teuthology machine, the logs and the packages-repository\n instance but nuke everything else.\n \n+Deploy a cluster for manual testing\n+-----------------------------------\n+\n+The `teuthology framework`_ and `ceph-workbench ceph-qa-suite`_ are \n+versatile tools that automatically provision Ceph clusters in the cloud and\n+run various tests on them in an automated fashion. This enables a single\n+engineer, in a matter of hours, to perform thousands of tests that would\n+keep dozens of human testers occupied for days or weeks if conducted\n+manually.\n+\n+However, there are times when the automated tests do not cover a particular\n+scenario and manual testing is desired. It turns out that it is simple to\n+adapt a test to stop and wait after the Ceph installation phase, and the\n+engineer can then easily ssh into the cluster and do whatever.\n+\n+This common use case is currently provided for by the following command::\n+\n+   ceph-workbench ceph-qa-suite --simultaneous-jobs 9 --verbose\n+   --teuthology-git-url http://github.com/dachary/teuthology\n+   --teuthology-branch openstack --ceph-qa-suite-git-url\n+   http://github.com/dachary/ceph-qa-suite --suite-branch wip-ceph-disk\n+   --ceph-git-url http://github.com/ceph/ceph --ceph jewel --suite\n+   ceph-disk --filter ubuntu_14\n+\n+This builds packages from the Ceph git repository and branch specified in\n+the ``--ceph-git-url`` and ``--ceph`` options, respectively, provisions VMs\n+in OpenStack, installs the packages, and deploys a Ceph cluster on them.\n+Then, instead of running automated tests, it stops and enters a wait loop.\n+\n+The VMs (or \"instances\" in OpenStack terminology) created by\n+`ceph-workbench ceph-qa-suite`_ are named as follows:\n+\n+``teuthology`` - the teuthology machine\n+\n+``packages-repository`` - VM where packages are stored\n+\n+``ceph-*`` - VM where packages are built","path":"doc/dev/index.rst","position":63,"original_position":63,"commit_id":"630bc864522093fd6eb76f834d1b884595e8c430","original_commit_id":"630bc864522093fd6eb76f834d1b884595e8c430","user":{"login":"smithfarm","id":3974844,"avatar_url":"https://avatars.githubusercontent.com/u/3974844?v=3","gravatar_id":"","url":"https://api.github.com/users/smithfarm","html_url":"https://github.com/smithfarm","followers_url":"https://api.github.com/users/smithfarm/followers","following_url":"https://api.github.com/users/smithfarm/following{/other_user}","gists_url":"https://api.github.com/users/smithfarm/gists{/gist_id}","starred_url":"https://api.github.com/users/smithfarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/smithfarm/subscriptions","organizations_url":"https://api.github.com/users/smithfarm/orgs","repos_url":"https://api.github.com/users/smithfarm/repos","events_url":"https://api.github.com/users/smithfarm/events{/privacy}","received_events_url":"https://api.github.com/users/smithfarm/received_events","type":"User","site_admin":false},"body":"EDIT: s/rpm-//","created_at":"2016-03-20T13:20:06Z","updated_at":"2016-03-20T13:20:06Z","html_url":"https://github.com/ceph/ceph/pull/8228#discussion_r56764308","pull_request_url":"https://api.github.com/repos/ceph/ceph/pulls/8228","_links":{"self":{"href":"https://api.github.com/repos/ceph/ceph/pulls/comments/56764308"},"html":{"href":"https://github.com/ceph/ceph/pull/8228#discussion_r56764308"},"pull_request":{"href":"https://api.github.com/repos/ceph/ceph/pulls/8228"}}},"pull_request":{"url":"https://api.github.com/repos/ceph/ceph/pulls/8228","id":63493096,"html_url":"https://github.com/ceph/ceph/pull/8228","diff_url":"https://github.com/ceph/ceph/pull/8228.diff","patch_url":"https://github.com/ceph/ceph/pull/8228.patch","issue_url":"https://api.github.com/repos/ceph/ceph/issues/8228","number":8228,"state":"open","locked":false,"title":"doc/dev: add \"Deploy a cluster for manual testing\" section","user":{"login":"smithfarm","id":3974844,"avatar_url":"https://avatars.githubusercontent.com/u/3974844?v=3","gravatar_id":"","url":"https://api.github.com/users/smithfarm","html_url":"https://github.com/smithfarm","followers_url":"https://api.github.com/users/smithfarm/followers","following_url":"https://api.github.com/users/smithfarm/following{/other_user}","gists_url":"https://api.github.com/users/smithfarm/gists{/gist_id}","starred_url":"https://api.github.com/users/smithfarm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/smithfarm/subscriptions","organizations_url":"https://api.github.com/users/smithfarm/orgs","repos_url":"https://api.github.com/users/smithfarm/repos","events_url":"https://api.github.com/users/smithfarm/events{/privacy}","received_events_url":"https://api.github.com/users/smithfarm/received_events","type":"User","site_admin":false},"body":"http://tracker.ceph.com/issues/15218 Fixes: #15218\r\n\r\nSigned-off-by: Nathan Cutler <ncutler@suse.com>","created_at":"2016-03-20T11:34:41Z","updated_at":"2016-03-20T13:20:06Z","closed_at":null,"merged_at":null,"merge_commit_sha":"4c9af54e91f83baba3eb198d985cec4c0c6bb14c","assignee":{"login":"dachary","id":433594,"avatar_url":"https://avatars.githubusercontent.com/u/433594?v=3","gravatar_id":"","url":"https://api.github.com/users/dachary","html_url":"https://github.com/dachary","followers_url":"https://api.github.com/users/dachary/followers","following_url":"https://api.github.com/users/dachary/following{/other_user}","gists_url":"https://api.github.com/users/dachary/gists{/gist_id}","starred_url":"https://api.github.com/users/dachary/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dachary/subscriptions","organizations_url":"https://api.github.com/users/dachary/orgs","repos_url":"https://api.github.com/users/dachary/repos","events_url":"https://api.github.com/users/dachary/events{/privacy}","received_events_url":"https://api.github.com/users/dachary/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/ceph/ceph/pulls/8228/commits","review_comments_url":"https://api.github.com/repos/ceph/ceph/pulls/8228/comments","review_comment_url":"https://api.github.com/repos/ceph/ceph/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ceph/ceph/issues/8228/comments","statuses_url":"https://api.github.com/repos/ceph/ceph/statuses/630bc864522093fd6eb76f834d1b884595e8c430","head":{"label":"SUSE:wip-15218","ref":"wip-15218","sha":"630bc864522093fd6eb76f834d1b884595e8c430","user":{"login":"SUSE","id":1067733,"avatar_url":"https://avatars.githubusercontent.com/u/1067733?v=3","gravatar_id":"","url":"https://api.github.com/users/SUSE","html_url":"https://github.com/SUSE","followers_url":"https://api.github.com/users/SUSE/followers","following_url":"https://api.github.com/users/SUSE/following{/other_user}","gists_url":"https://api.github.com/users/SUSE/gists{/gist_id}","starred_url":"https://api.github.com/users/SUSE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SUSE/subscriptions","organizations_url":"https://api.github.com/users/SUSE/orgs","repos_url":"https://api.github.com/users/SUSE/repos","events_url":"https://api.github.com/users/SUSE/events{/privacy}","received_events_url":"https://api.github.com/users/SUSE/received_events","type":"Organization","site_admin":false},"repo":{"id":20325897,"name":"ceph","full_name":"SUSE/ceph","owner":{"login":"SUSE","id":1067733,"avatar_url":"https://avatars.githubusercontent.com/u/1067733?v=3","gravatar_id":"","url":"https://api.github.com/users/SUSE","html_url":"https://github.com/SUSE","followers_url":"https://api.github.com/users/SUSE/followers","following_url":"https://api.github.com/users/SUSE/following{/other_user}","gists_url":"https://api.github.com/users/SUSE/gists{/gist_id}","starred_url":"https://api.github.com/users/SUSE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SUSE/subscriptions","organizations_url":"https://api.github.com/users/SUSE/orgs","repos_url":"https://api.github.com/users/SUSE/repos","events_url":"https://api.github.com/users/SUSE/events{/privacy}","received_events_url":"https://api.github.com/users/SUSE/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/SUSE/ceph","description":"Ceph is a distributed object, block, and file storage platform ","fork":true,"url":"https://api.github.com/repos/SUSE/ceph","forks_url":"https://api.github.com/repos/SUSE/ceph/forks","keys_url":"https://api.github.com/repos/SUSE/ceph/keys{/key_id}","collaborators_url":"https://api.github.com/repos/SUSE/ceph/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/SUSE/ceph/teams","hooks_url":"https://api.github.com/repos/SUSE/ceph/hooks","issue_events_url":"https://api.github.com/repos/SUSE/ceph/issues/events{/number}","events_url":"https://api.github.com/repos/SUSE/ceph/events","assignees_url":"https://api.github.com/repos/SUSE/ceph/assignees{/user}","branches_url":"https://api.github.com/repos/SUSE/ceph/branches{/branch}","tags_url":"https://api.github.com/repos/SUSE/ceph/tags","blobs_url":"https://api.github.com/repos/SUSE/ceph/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/SUSE/ceph/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/SUSE/ceph/git/refs{/sha}","trees_url":"https://api.github.com/repos/SUSE/ceph/git/trees{/sha}","statuses_url":"https://api.github.com/repos/SUSE/ceph/statuses/{sha}","languages_url":"https://api.github.com/repos/SUSE/ceph/languages","stargazers_url":"https://api.github.com/repos/SUSE/ceph/stargazers","contributors_url":"https://api.github.com/repos/SUSE/ceph/contributors","subscribers_url":"https://api.github.com/repos/SUSE/ceph/subscribers","subscription_url":"https://api.github.com/repos/SUSE/ceph/subscription","commits_url":"https://api.github.com/repos/SUSE/ceph/commits{/sha}","git_commits_url":"https://api.github.com/repos/SUSE/ceph/git/commits{/sha}","comments_url":"https://api.github.com/repos/SUSE/ceph/comments{/number}","issue_comment_url":"https://api.github.com/repos/SUSE/ceph/issues/comments{/number}","contents_url":"https://api.github.com/repos/SUSE/ceph/contents/{+path}","compare_url":"https://api.github.com/repos/SUSE/ceph/compare/{base}...{head}","merges_url":"https://api.github.com/repos/SUSE/ceph/merges","archive_url":"https://api.github.com/repos/SUSE/ceph/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/SUSE/ceph/downloads","issues_url":"https://api.github.com/repos/SUSE/ceph/issues{/number}","pulls_url":"https://api.github.com/repos/SUSE/ceph/pulls{/number}","milestones_url":"https://api.github.com/repos/SUSE/ceph/milestones{/number}","notifications_url":"https://api.github.com/repos/SUSE/ceph/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/SUSE/ceph/labels{/name}","releases_url":"https://api.github.com/repos/SUSE/ceph/releases{/id}","deployments_url":"https://api.github.com/repos/SUSE/ceph/deployments","created_at":"2014-05-30T10:29:18Z","updated_at":"2016-02-11T13:57:48Z","pushed_at":"2016-03-20T13:19:31Z","git_url":"git://github.com/SUSE/ceph.git","ssh_url":"git@github.com:SUSE/ceph.git","clone_url":"https://github.com/SUSE/ceph.git","svn_url":"https://github.com/SUSE/ceph","homepage":"http://ceph.com","size":266359,"stargazers_count":1,"watchers_count":1,"language":"C++","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":5,"mirror_url":null,"open_issues_count":1,"forks":5,"open_issues":1,"watchers":1,"default_branch":"master"}},"base":{"label":"ceph:master","ref":"master","sha":"22cac93ec7f75cbcba80f1507de436646c9b8c45","user":{"login":"ceph","id":1015767,"avatar_url":"https://avatars.githubusercontent.com/u/1015767?v=3","gravatar_id":"","url":"https://api.github.com/users/ceph","html_url":"https://github.com/ceph","followers_url":"https://api.github.com/users/ceph/followers","following_url":"https://api.github.com/users/ceph/following{/other_user}","gists_url":"https://api.github.com/users/ceph/gists{/gist_id}","starred_url":"https://api.github.com/users/ceph/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ceph/subscriptions","organizations_url":"https://api.github.com/users/ceph/orgs","repos_url":"https://api.github.com/users/ceph/repos","events_url":"https://api.github.com/users/ceph/events{/privacy}","received_events_url":"https://api.github.com/users/ceph/received_events","type":"Organization","site_admin":false},"repo":{"id":2310495,"name":"ceph","full_name":"ceph/ceph","owner":{"login":"ceph","id":1015767,"avatar_url":"https://avatars.githubusercontent.com/u/1015767?v=3","gravatar_id":"","url":"https://api.github.com/users/ceph","html_url":"https://github.com/ceph","followers_url":"https://api.github.com/users/ceph/followers","following_url":"https://api.github.com/users/ceph/following{/other_user}","gists_url":"https://api.github.com/users/ceph/gists{/gist_id}","starred_url":"https://api.github.com/users/ceph/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ceph/subscriptions","organizations_url":"https://api.github.com/users/ceph/orgs","repos_url":"https://api.github.com/users/ceph/repos","events_url":"https://api.github.com/users/ceph/events{/privacy}","received_events_url":"https://api.github.com/users/ceph/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ceph/ceph","description":"Ceph is a distributed object, block, and file storage platform ","fork":false,"url":"https://api.github.com/repos/ceph/ceph","forks_url":"https://api.github.com/repos/ceph/ceph/forks","keys_url":"https://api.github.com/repos/ceph/ceph/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ceph/ceph/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ceph/ceph/teams","hooks_url":"https://api.github.com/repos/ceph/ceph/hooks","issue_events_url":"https://api.github.com/repos/ceph/ceph/issues/events{/number}","events_url":"https://api.github.com/repos/ceph/ceph/events","assignees_url":"https://api.github.com/repos/ceph/ceph/assignees{/user}","branches_url":"https://api.github.com/repos/ceph/ceph/branches{/branch}","tags_url":"https://api.github.com/repos/ceph/ceph/tags","blobs_url":"https://api.github.com/repos/ceph/ceph/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ceph/ceph/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ceph/ceph/git/refs{/sha}","trees_url":"https://api.github.com/repos/ceph/ceph/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ceph/ceph/statuses/{sha}","languages_url":"https://api.github.com/repos/ceph/ceph/languages","stargazers_url":"https://api.github.com/repos/ceph/ceph/stargazers","contributors_url":"https://api.github.com/repos/ceph/ceph/contributors","subscribers_url":"https://api.github.com/repos/ceph/ceph/subscribers","subscription_url":"https://api.github.com/repos/ceph/ceph/subscription","commits_url":"https://api.github.com/repos/ceph/ceph/commits{/sha}","git_commits_url":"https://api.github.com/repos/ceph/ceph/git/commits{/sha}","comments_url":"https://api.github.com/repos/ceph/ceph/comments{/number}","issue_comment_url":"https://api.github.com/repos/ceph/ceph/issues/comments{/number}","contents_url":"https://api.github.com/repos/ceph/ceph/contents/{+path}","compare_url":"https://api.github.com/repos/ceph/ceph/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ceph/ceph/merges","archive_url":"https://api.github.com/repos/ceph/ceph/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ceph/ceph/downloads","issues_url":"https://api.github.com/repos/ceph/ceph/issues{/number}","pulls_url":"https://api.github.com/repos/ceph/ceph/pulls{/number}","milestones_url":"https://api.github.com/repos/ceph/ceph/milestones{/number}","notifications_url":"https://api.github.com/repos/ceph/ceph/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ceph/ceph/labels{/name}","releases_url":"https://api.github.com/repos/ceph/ceph/releases{/id}","deployments_url":"https://api.github.com/repos/ceph/ceph/deployments","created_at":"2011-09-01T21:41:26Z","updated_at":"2016-03-20T08:59:44Z","pushed_at":"2016-03-20T13:19:32Z","git_url":"git://github.com/ceph/ceph.git","ssh_url":"git@github.com:ceph/ceph.git","clone_url":"https://github.com/ceph/ceph.git","svn_url":"https://github.com/ceph/ceph","homepage":"http://ceph.com","size":207740,"stargazers_count":1968,"watchers_count":1968,"language":"C++","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1200,"mirror_url":null,"open_issues_count":273,"forks":1200,"open_issues":273,"watchers":1968,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ceph/ceph/pulls/8228"},"html":{"href":"https://github.com/ceph/ceph/pull/8228"},"issue":{"href":"https://api.github.com/repos/ceph/ceph/issues/8228"},"comments":{"href":"https://api.github.com/repos/ceph/ceph/issues/8228/comments"},"review_comments":{"href":"https://api.github.com/repos/ceph/ceph/pulls/8228/comments"},"review_comment":{"href":"https://api.github.com/repos/ceph/ceph/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ceph/ceph/pulls/8228/commits"},"statuses":{"href":"https://api.github.com/repos/ceph/ceph/statuses/630bc864522093fd6eb76f834d1b884595e8c430"}}}}