Bug 1367617

Summary:	[DOCS] Need documentation to avoid provisioning volumes in wrong AZ - AWS
Product:	OpenShift Container Platform	Reporter:	Jianwei Hou <jhou>
Component:	Documentation	Assignee:	Gaurav Nelson <gnelson>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Chao Yang <chaoyang>
Severity:	medium	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	medium
Version:	3.3.0	CC:	aos-bugs, bchilds, jokerman, mmccomas
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	3.7-release-plan
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1372730 (view as bug list)		Environment:
Last Closed:	2017-09-20 05:42:06 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1372730

Description Jianwei Hou 2016-08-17 02:27:36 UTC

We don't have documentation to instruct user that they have the possibility to run into the same problem as https://bugzilla.redhat.com/show_bug.cgi?id=1365398 if they are using a shared aws account(as us) and didn't properly tag their instances.
Given an aws account has different instances in different zones, it is vital that the user tag their instances with "Key=KubernetesCluster,Value=<clusterid>". Otherwise they may see their volumes provisioned in unepxected AZ.

Comment 1 Bradley Childs 2016-09-02 15:14:56 UTC

Updated docs here: https://github.com/openshift/openshift-docs/pull/2783

Comment 2 Gaurav Nelson 2017-09-20 05:42:06 UTC

The updates are already published at https://access.redhat.com/documentation/en-us/openshift_container_platform/3.6/html-single/installation_and_configuration/#available-dynamically-provisioned-plug-ins

which contains following:
For dynamic provisioning when using multiple clusters in different zones, tag each node with Key=kubernetes.io/cluster/xxxx,Value=clusterid where xxxx and clusterid are unique per cluster. In versions prior to 3.6, this was Key=KubernetesCluster,Value=clusterid.