{"action":"created","comment":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/69205369","id":69205369,"diff_hunk":"@@ -1272,3 +1285,147 @@ common issues:\n [Note] Completed with no errors or warnings seen.\n ----\n ====\n+\n+[[manual-upgrades-advanced-topics]]\n+== Advanced topics\n+\n+Blue-green deployments are a proven approach to reducing downtime caused while\n+updating an environment.  This is done by creating a parallel environment on\n+which the new deployment can be installed.  After the new deployment is\n+verified traffic can be switched over with the option to rollback should a\n+problem be detected.\n+\n+While blue-green is a valid strategy for deploying just about any software\n+there are always trade offs to be made.  Not all environments have the same\n+uptime requirements or the resources to properly perform blue-green\n+deployments.  In an OpenShift environment the most suitable candidate for\n+blue-green deployments are the Nodes.  Uptime is most important for these\n+workloads and the additional complexity of blue-green deployments is can be\n+justified.  Often the main hurdle to overcome is having the excess capacity to\n+facilitate such an approach.\n+\n+ifdef::openshift-enterprise[]\n+Another lesser challenge is that the administrator will have to temporarily\n+share the entitlements between the blue-green deployments or provide access to\n+the installation content by means of a system such as Red Hat Satellite.  This\n+can be accomplished by shareing the consumer ID from the previous host.\n+\n+On the old host:\n+----\n+subscription-manager identity | grep system\n+system identity: 6699375b-06db-48c4-941e-689efd6ce3aa\n+----\n+\n+On the new host:\n+----\n+subscription-manager register --consumerid=6699375b-06db-48c4-941e-689efd6ce3aa\n+----\n+\n+[IMPORTANT]\n+====\n+When the deployment has been declared successful it's important that the old\n+host be unregistered with `subscription-manager clean` to avoid creating a\n+situation where the environment is out of compliance.\n+====\n+\n+endif::openshift-enterprise[]\n+\n+=== Preparing for an upgrade\n+\n+link:#upgrading-masters[After the Master and etcd servers have been upgraded]\n+you will need to ensure that your current production Nodes as either blue or\n+green.  In this example the currently installation environment will be blue and\n+the new environment will be green.\n+\n+----\n+oc label --all nodes color=blue\n+----\n+\n+There's quite a bit of flexibility here.  Perhaps there was only some subset of\n+Nodes that required the uptime guarantees of a blue-green deployment.  In that\n+case the `-l` flag can be used to match a subset of the environment using a\n+selector.\n+\n+Next link:../install/advanced_install.html#adding-nodes-advanced[the green","path":"install_config/upgrading/manual_upgrades.adoc","position":85,"original_position":85,"commit_id":"a0fc53f8ed9377ecc42e526f2d7304754d0852b6","original_commit_id":"a0fc53f8ed9377ecc42e526f2d7304754d0852b6","user":{"login":"ahardin-rh","id":16197393,"avatar_url":"https://avatars.githubusercontent.com/u/16197393?v=3","gravatar_id":"","url":"https://api.github.com/users/ahardin-rh","html_url":"https://github.com/ahardin-rh","followers_url":"https://api.github.com/users/ahardin-rh/followers","following_url":"https://api.github.com/users/ahardin-rh/following{/other_user}","gists_url":"https://api.github.com/users/ahardin-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/ahardin-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ahardin-rh/subscriptions","organizations_url":"https://api.github.com/users/ahardin-rh/orgs","repos_url":"https://api.github.com/users/ahardin-rh/repos","events_url":"https://api.github.com/users/ahardin-rh/events{/privacy}","received_events_url":"https://api.github.com/users/ahardin-rh/received_events","type":"User","site_admin":false},"body":"comma after Next","created_at":"2016-06-30T20:34:51Z","updated_at":"2016-06-30T20:34:51Z","html_url":"https://github.com/openshift/openshift-docs/pull/2287#discussion_r69205369","pull_request_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287","_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/69205369"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/2287#discussion_r69205369"},"pull_request":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287"}}},"pull_request":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287","id":73928515,"html_url":"https://github.com/openshift/openshift-docs/pull/2287","diff_url":"https://github.com/openshift/openshift-docs/pull/2287.diff","patch_url":"https://github.com/openshift/openshift-docs/pull/2287.patch","issue_url":"https://api.github.com/repos/openshift/openshift-docs/issues/2287","number":2287,"state":"open","locked":false,"title":"Documenting blue-green deployments","user":{"login":"brenton","id":832,"avatar_url":"https://avatars.githubusercontent.com/u/832?v=3","gravatar_id":"","url":"https://api.github.com/users/brenton","html_url":"https://github.com/brenton","followers_url":"https://api.github.com/users/brenton/followers","following_url":"https://api.github.com/users/brenton/following{/other_user}","gists_url":"https://api.github.com/users/brenton/gists{/gist_id}","starred_url":"https://api.github.com/users/brenton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brenton/subscriptions","organizations_url":"https://api.github.com/users/brenton/orgs","repos_url":"https://api.github.com/users/brenton/repos","events_url":"https://api.github.com/users/brenton/events{/privacy}","received_events_url":"https://api.github.com/users/brenton/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-06-15T15:05:17Z","updated_at":"2016-06-30T20:34:51Z","closed_at":null,"merged_at":null,"merge_commit_sha":"18625e5e8ef0955bd7fa75a409d0c11e157171b2","assignee":{"login":"ahardin-rh","id":16197393,"avatar_url":"https://avatars.githubusercontent.com/u/16197393?v=3","gravatar_id":"","url":"https://api.github.com/users/ahardin-rh","html_url":"https://github.com/ahardin-rh","followers_url":"https://api.github.com/users/ahardin-rh/followers","following_url":"https://api.github.com/users/ahardin-rh/following{/other_user}","gists_url":"https://api.github.com/users/ahardin-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/ahardin-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ahardin-rh/subscriptions","organizations_url":"https://api.github.com/users/ahardin-rh/orgs","repos_url":"https://api.github.com/users/ahardin-rh/repos","events_url":"https://api.github.com/users/ahardin-rh/events{/privacy}","received_events_url":"https://api.github.com/users/ahardin-rh/received_events","type":"User","site_admin":false},"assignees":[{"login":"ahardin-rh","id":16197393,"avatar_url":"https://avatars.githubusercontent.com/u/16197393?v=3","gravatar_id":"","url":"https://api.github.com/users/ahardin-rh","html_url":"https://github.com/ahardin-rh","followers_url":"https://api.github.com/users/ahardin-rh/followers","following_url":"https://api.github.com/users/ahardin-rh/following{/other_user}","gists_url":"https://api.github.com/users/ahardin-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/ahardin-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ahardin-rh/subscriptions","organizations_url":"https://api.github.com/users/ahardin-rh/orgs","repos_url":"https://api.github.com/users/ahardin-rh/repos","events_url":"https://api.github.com/users/ahardin-rh/events{/privacy}","received_events_url":"https://api.github.com/users/ahardin-rh/received_events","type":"User","site_admin":false}],"milestone":null,"commits_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287/commits","review_comments_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287/comments","review_comment_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/issues/2287/comments","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/a0fc53f8ed9377ecc42e526f2d7304754d0852b6","head":{"label":"brenton:master","ref":"master","sha":"a0fc53f8ed9377ecc42e526f2d7304754d0852b6","user":{"login":"brenton","id":832,"avatar_url":"https://avatars.githubusercontent.com/u/832?v=3","gravatar_id":"","url":"https://api.github.com/users/brenton","html_url":"https://github.com/brenton","followers_url":"https://api.github.com/users/brenton/followers","following_url":"https://api.github.com/users/brenton/following{/other_user}","gists_url":"https://api.github.com/users/brenton/gists{/gist_id}","starred_url":"https://api.github.com/users/brenton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brenton/subscriptions","organizations_url":"https://api.github.com/users/brenton/orgs","repos_url":"https://api.github.com/users/brenton/repos","events_url":"https://api.github.com/users/brenton/events{/privacy}","received_events_url":"https://api.github.com/users/brenton/received_events","type":"User","site_admin":false},"repo":{"id":33250621,"name":"openshift-docs","full_name":"brenton/openshift-docs","owner":{"login":"brenton","id":832,"avatar_url":"https://avatars.githubusercontent.com/u/832?v=3","gravatar_id":"","url":"https://api.github.com/users/brenton","html_url":"https://github.com/brenton","followers_url":"https://api.github.com/users/brenton/followers","following_url":"https://api.github.com/users/brenton/following{/other_user}","gists_url":"https://api.github.com/users/brenton/gists{/gist_id}","starred_url":"https://api.github.com/users/brenton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brenton/subscriptions","organizations_url":"https://api.github.com/users/brenton/orgs","repos_url":"https://api.github.com/users/brenton/repos","events_url":"https://api.github.com/users/brenton/events{/privacy}","received_events_url":"https://api.github.com/users/brenton/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/brenton/openshift-docs","description":"OpenShift Documentation","fork":true,"url":"https://api.github.com/repos/brenton/openshift-docs","forks_url":"https://api.github.com/repos/brenton/openshift-docs/forks","keys_url":"https://api.github.com/repos/brenton/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/brenton/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/brenton/openshift-docs/teams","hooks_url":"https://api.github.com/repos/brenton/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/brenton/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/brenton/openshift-docs/events","assignees_url":"https://api.github.com/repos/brenton/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/brenton/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/brenton/openshift-docs/tags","blobs_url":"https://api.github.com/repos/brenton/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/brenton/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/brenton/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/brenton/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/brenton/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/brenton/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/brenton/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/brenton/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/brenton/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/brenton/openshift-docs/subscription","commits_url":"https://api.github.com/repos/brenton/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/brenton/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/brenton/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/brenton/openshift-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/brenton/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/brenton/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/brenton/openshift-docs/merges","archive_url":"https://api.github.com/repos/brenton/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/brenton/openshift-docs/downloads","issues_url":"https://api.github.com/repos/brenton/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/brenton/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/brenton/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/brenton/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/brenton/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/brenton/openshift-docs/releases{/id}","deployments_url":"https://api.github.com/repos/brenton/openshift-docs/deployments","created_at":"2015-04-01T13:58:45Z","updated_at":"2016-06-15T15:04:54Z","pushed_at":"2016-06-20T05:17:15Z","git_url":"git://github.com/brenton/openshift-docs.git","ssh_url":"git@github.com:brenton/openshift-docs.git","clone_url":"https://github.com/brenton/openshift-docs.git","svn_url":"https://github.com/brenton/openshift-docs","homepage":null,"size":11843,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"openshift:master","ref":"master","sha":"74b37def7d5f8a4bda5f2489c8984eda0d7d3db0","user":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"repo":{"id":21740844,"name":"openshift-docs","full_name":"openshift/openshift-docs","owner":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openshift/openshift-docs","description":"OpenShift Documentation","fork":false,"url":"https://api.github.com/repos/openshift/openshift-docs","forks_url":"https://api.github.com/repos/openshift/openshift-docs/forks","keys_url":"https://api.github.com/repos/openshift/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openshift/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openshift/openshift-docs/teams","hooks_url":"https://api.github.com/repos/openshift/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/openshift/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/openshift/openshift-docs/events","assignees_url":"https://api.github.com/repos/openshift/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/openshift/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/openshift/openshift-docs/tags","blobs_url":"https://api.github.com/repos/openshift/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openshift/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openshift/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/openshift/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/openshift/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/openshift/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/openshift/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/openshift/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/openshift/openshift-docs/subscription","commits_url":"https://api.github.com/repos/openshift/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/openshift/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/openshift/openshift-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/openshift/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/openshift/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openshift/openshift-docs/merges","archive_url":"https://api.github.com/repos/openshift/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openshift/openshift-docs/downloads","issues_url":"https://api.github.com/repos/openshift/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/openshift/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/openshift/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/openshift/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openshift/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/openshift/openshift-docs/releases{/id}","deployments_url":"https://api.github.com/repos/openshift/openshift-docs/deployments","created_at":"2014-07-11T15:14:42Z","updated_at":"2016-06-20T19:39:32Z","pushed_at":"2016-06-30T20:12:48Z","git_url":"git://github.com/openshift/openshift-docs.git","ssh_url":"git@github.com:openshift/openshift-docs.git","clone_url":"https://github.com/openshift/openshift-docs.git","svn_url":"https://github.com/openshift/openshift-docs","homepage":"https://docs.openshift.org/latest/welcome/index.html","size":19795,"stargazers_count":48,"watchers_count":48,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":224,"mirror_url":null,"open_issues_count":185,"forks":224,"open_issues":185,"watchers":48,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/2287"},"issue":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/2287"},"comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/2287/comments"},"review_comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287/comments"},"review_comment":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/2287/commits"},"statuses":{"href":"https://api.github.com/repos/openshift/openshift-docs/statuses/a0fc53f8ed9377ecc42e526f2d7304754d0852b6"}}}}
{"actor":{"display_login":"ahardin-rh"}}