mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-08-22 09:52:19 +00:00
removed unnecessary steps in most "create cluster" tasks. Also edited Custom Cluster topic.
This commit is contained in:
Mark Bishop
Mark Bishop
+1
-29
@@ -5,35 +5,7 @@ weight: 3250
|
||||
|
||||
# Creating an Amazon EC2 Cluster
|
||||
|
||||
## Objectives
|
||||
|
||||
1. [Create an Instance](#create-an-instance)
|
||||
|
||||
Begin by logging into Amazon EC2 website and provisioning a new instance.
|
||||
|
||||
2. [Create the Cluster](#create-the-amazon-ec2-cluster)
|
||||
|
||||
Use your new instance as a template for your new Kubernetes cluster.
|
||||
|
||||
## Create an Instance
|
||||
|
||||
Create an _instance_, Amazon's version of a virtual machine in EC2, using the [Amazon EC2 Management Console](https://aws.amazon.com/ec2/).
|
||||
|
||||
[Amazon Instructions](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)
|
||||
|
||||
Provision the instance according to the requirements below.
|
||||
|
||||
### Requirements
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
|
||||
## Create the Amazon EC2 Cluster
|
||||
|
||||
Use {{< product >}} to clone your Linux host and configure them as Kubernetes nodes.
|
||||
Use {{< product >}} to create a Kubernetes cluster in Amazon EC2.
|
||||
|
||||
1. From the **Clusters** page, click **Add Cluster**.
|
||||
1. Choose **Amazon EC2**.
|
||||
|
||||
-8
@@ -27,14 +27,6 @@ You can use Rancher to create a cluster using Microsoft Azure Container Service.
|
||||
7. Use **Nodes** to provision each node in your cluster and choose a geographical region.
|
||||
|
||||
[Microsoft Documentation: How to create and use an SSH public and private key pair](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/mac-create-ssh-keys)
|
||||
|
||||
Provision the nodes according to the requirements below:
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
<br/>
|
||||
8. Click **Create**.
|
||||
<br/>
|
||||
|
||||
+1
-27
@@ -5,33 +5,7 @@ weight: 3300
|
||||
|
||||
# Creating an Azure Cluster
|
||||
|
||||
## Objectives
|
||||
|
||||
1. [Create a Linux Virtual Machine](#create-a-linux-virtual-machine)
|
||||
|
||||
Begin by logging into Azure and provisioning a Linux virtual machine (VM).
|
||||
|
||||
2. [Create the Cluster](#create-the-azure-cluster)
|
||||
|
||||
Use your Linux VM as a template for your new Kubernetes cluster.
|
||||
|
||||
## Create a Linux Virtual Machine
|
||||
|
||||
Create a Linux VM using the [Microsoft Azure Portal](https://portal.azure.com) ([Azure Instructions](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/)).
|
||||
|
||||
Provision the instance according to the requirements below.
|
||||
|
||||
### Requirements
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
|
||||
## Create the Azure Cluster
|
||||
|
||||
Use {{< product >}} to clone your Linux host and configure them as Kubernetes nodes.
|
||||
Use {{< product >}} to create a Kubernetes cluster in Azure.
|
||||
|
||||
1. From the **Clusters** page, click **Add Cluster**.
|
||||
|
||||
|
||||
+24
-13
@@ -7,7 +7,7 @@ weight: 3225
|
||||
|
||||
## Objectives
|
||||
|
||||
1. [Create a Linux Host](#create-a-linux-host)
|
||||
1. [Provision a Linux Host](#provision-a-linux-host)
|
||||
|
||||
Begin by provisioning a Linux host.
|
||||
|
||||
@@ -15,6 +15,10 @@ weight: 3225
|
||||
|
||||
Use your new Linux host as a template for your new Kubernetes cluster.
|
||||
|
||||
2. **Amazon Only:** [Tag Resources](#amazon-only-br-tag-resources)
|
||||
|
||||
If you're using Amazon to create your custom cluster, log into AWS and tag your resources with a cluster ID.
|
||||
|
||||
## Provision a Linux Host
|
||||
|
||||
Begin creation of a custom cluster by provisioning a Linux host. Your host can be:
|
||||
@@ -38,8 +42,7 @@ Provision the host according to the requirements below.
|
||||
>**Bare-Metal Server Note:**
|
||||
>
|
||||
While creating your cluster, you must assign Kubernetes roles to your cluster nodes. If you plan on dedicating bare-metal servers to each role, you must provision a bare-metal server for each role (i.e. provision multiple bare-metal servers).
|
||||
>
|
||||
>**Amazon Cloud Provider Note:** If you are going to configure your cluster to use `Amazon` cloud provider, you must tag your Amazon EC2 resources with a `ClusterID`. After you complete [Create the Custom Cluster](#create-the-custom-cluster), complete [Configuring the Kubernetes Cloud Provider to Amazon: Tag resources with ClusterID](#configuring-the-kubernetes-cloud-provider-to-amazon-br-tag-resources-with-clusterid).<br/><br/>You can use Amazon EC2 instances without configuring a cloud provider in Kubernetes, you only have to configure the cloud provider if you want to use specific Kubernetes cloud provider functionality. Read more on [Kubernetes Cloud Providers](https://kubernetes.io/docs/concepts/cluster-administration/cloud-providers/)
|
||||
|
||||
|
||||
## Create the Custom Cluster
|
||||
|
||||
@@ -77,22 +80,30 @@ Use {{< product >}} to clone your Linux host and configure them as Kubernetes no
|
||||
|
||||
{{< result_create-cluster >}}
|
||||
|
||||
### Configuring the Kubernetes Cloud Provider to Amazon:<br/> Tag resources with ClusterID
|
||||
## Amazon Only:<br/>Tag Resources
|
||||
|
||||
When you have configured your cluster to use `Amazon` as **Cloud Provider**, you will need to tag AWS resources. The following resources need to tagged with a `ClusterID`:
|
||||
If you have configured your cluster to use Amazon as **Cloud Provider**, tag your AWS resources with a cluster ID.
|
||||
|
||||
* **Nodes**: All hosts added in Rancher.
|
||||
* **Subnet**: The subnet used for your cluster
|
||||
* **Security Group**: The security group used for your cluster.
|
||||
[Amazon Documentation: Tagging Your Amazon EC2 Resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)
|
||||
|
||||
>**Note:** Do not tag multiple security groups, as this will generate an error when creating Elastic Load Balancer (ELB).
|
||||
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`
|
||||
```
|
||||
Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned
|
||||
```
|
||||
|
||||
where `CLUSTERID` can be chosen as you like, as long as it is equal across all tags set.
|
||||
`<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.
|
||||
|
||||
Setting the value of the tag to owned, tells the cluster that all resources with this tag are owned and managed by this cluster. If you share resources between clusters, you can change the tag to:
|
||||
If you share resources between clusters, you can change the tag to:
|
||||
|
||||
**Key** = `kubernetes.io/cluster/CLUSTERID` **Value** = `shared`.
|
||||
```
|
||||
Key=kubernetes.io/cluster/CLUSTERID, Value=shared
|
||||
```
|
||||
|
||||
+1
-29
@@ -5,35 +5,7 @@ weight: 3275
|
||||
|
||||
# Creating a DigitalOcean Cluster
|
||||
|
||||
## Objectives
|
||||
|
||||
1. [Create a Droplet](#create-a-droplet)
|
||||
|
||||
Begin by logging into DigitalOcean and provisioning a new droplet.
|
||||
|
||||
2. [Create the Cluster](#create-the-digital-ocean-cluster)
|
||||
|
||||
Use your new droplet as a template for your new Kubernetes cluster.
|
||||
|
||||
## Create a Droplet
|
||||
|
||||
Create a _droplet_, DigitalOcean's name for a virtual machine, using the DigitalOcean website.
|
||||
|
||||
[DigitalOcean Instructions](https://www.digitalocean.com/community/tutorials/how-to-create-your-first-digitalocean-droplet)
|
||||
|
||||
Provision the droplet according to the requirements below.
|
||||
|
||||
### Requirements
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
|
||||
## Create the DigitalOcean Cluster
|
||||
|
||||
Use {{< product >}} to clone your Linux host and configure them as Kubernetes nodes.
|
||||
Use {{< product >}} to create a Kubernetes cluster using DigitalOcean.
|
||||
|
||||
1. From the **Clusters** page, click **Add Cluster**.
|
||||
|
||||
|
||||
@@ -47,14 +47,6 @@ Use {{< product >}} to set up and configure your Kubernetes cluster.
|
||||
|
||||
7. Use **Nodes** to provision each node in your cluster and choose a geographical region.
|
||||
|
||||
Provision the nodes according to our requirements below.
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
|
||||
8. Review your options to confirm they're correct. Then click **Create**.
|
||||
|
||||
{{< result_create-cluster >}}
|
||||
|
||||
+1
-29
@@ -5,35 +5,7 @@ weight: 3375
|
||||
|
||||
# Creating a vSphere Cluster
|
||||
|
||||
## Objectives
|
||||
|
||||
1. [Create a Linux Virtual Machine](#create-a-linux-virtual-machine)
|
||||
|
||||
Begin by logging into vSphere and provisioning a Linux virtual machine (VM).
|
||||
|
||||
2. [Create the Cluster](#create-the-vsphere-cluster)
|
||||
|
||||
Use your new VM as a template for your new Kubernetes cluster.
|
||||
|
||||
## Create a Linux Virtual Machine
|
||||
|
||||
Create a Linux VM using vSphere.
|
||||
|
||||
[VMware Instructions](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-39D19B2B-A11C-42AE-AC80-DDA8682AB42C.html)
|
||||
|
||||
Provision the nodes according to the requirements below.
|
||||
|
||||
### Requirements
|
||||
|
||||
{{< requirements_os >}}
|
||||
|
||||
{{< requirements_hardware >}}
|
||||
|
||||
{{< requirements_software >}}
|
||||
|
||||
## Create the vSphere Cluster
|
||||
|
||||
Use {{< product >}} to clone your Linux host and configure them as Kubernetes nodes.
|
||||
Use {{< product >}} to create a Kubernetes cluster in vSphere.
|
||||
|
||||
1. From the **Clusters** page, click **Add Cluster**.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user