public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-05-28 07:35:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #749 from MBishop17/cluster-id

Browse Source 
adding content to RKE about tagging amazon resources with a cluster id
This commit is contained in:
Denise
2018-09-06 14:31:35 -07:00
committed by GitHub
parent b1b0b5a796 cb8af40eac
commit baf46214e5
1 changed files with 29 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rke/v0.1.x/en/config-options/cloud-providers/aws/_index.md
+29 -1
View File
@@ -3,7 +3,7 @@ title: AWS Cloud Provider
weight: 251
---
To enable the AWS cloud provider, there are no configuration options. You only need to set the name as `aws`. In order to use the AWS cloud provider, all cluster nodes must have already been configured with an appropriate IAM role.
To enable the AWS cloud provider, there are no configuration options. You only need to set the name as `aws`. In order to use the AWS cloud provider, all cluster nodes must have already been configured with an [appropriate IAM role](#iam-requirements) and your AWS resources must be [tagged with a cluster ID](#tagging-amazon-resources).
```yaml
cloud_provider:
@@ -53,3 +53,31 @@ In order to use Elastic Load Balancers (ELBs) and EBS with Kubernetes, the node(
]
}
```
## Tagging Amazon Resources
Any resources used in a Kubernetes cluster with the Amazon cloud provider must be tagged with a cluster ID.
[Amazon Documentation: Tagging Your Amazon EC2 Resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)
The following resources need to tagged with a `ClusterID`:
- **Nodes**: All hosts added in Rancher.
- **Subnet**: The subnet used for your cluster
- **Security Group**: The security group used for your cluster.
>**Note:** Do not tag multiple security groups. Tagging multiple groups generates an error when creating Elastic Load Balancer.
The tag that should be used is:
```
Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned
```
`<CLUSTERID>` can be any string you choose. However, the same string must be used on every resource you tag. Setting the tag value to `owned` informs the cluster that all resources tagged with the `<CLUSTERID>` are owned and managed by this cluster.
If you share resources between clusters, you can change the tag to:
```
Key=kubernetes.io/cluster/CLUSTERID, Value=shared
```