From ef950a022f36a1ac7ceb6cf453481b4a942e2ba8 Mon Sep 17 00:00:00 2001 From: Nathan Jenan Date: Fri, 22 Jun 2018 13:59:02 -0700 Subject: [PATCH] Adding EKS cluster creation documentation --- .../create-cluster-eks/_index.md | 57 ++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) diff --git a/content/rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-eks/_index.md b/content/rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-eks/_index.md index c17f3066576..6d3325fdb22 100644 --- a/content/rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-eks/_index.md +++ b/content/rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-eks/_index.md @@ -3,4 +3,59 @@ title: Creating a EKS Cluster shortTitle: Amazon EKS weight: 3325 draft: true ---- \ No newline at end of file +--- +## Objectives + +1. [Create an account with appropriate permissions](#give-appropriate-permissions) + + Create (or give an existing) user appropriate permissions to create an EKS cluster. + +2. [Create an access key and secret key](#create-access-key-and-secret-key) + + Create an access key and secret key to access Amazon Web Services (AWS) resources from Rancher. + +3. [Create the EKS Cluster](#create-the-eks-cluster) + + Using the AWS account, create your Amazon Elastic Container Service for Kubernetes (EKS) cluster in Rancher. + +## Give Appropriate Permissions + +Make sure that the account you will be using to create the EKS cluster has the appropriate permissions. Referring to the official [EKS documentation](https://docs.aws.amazon.com/eks/latest/userguide/IAM_policies.html) for details. + +## Create Access Key and Secret Key + +Use AWS to create an access key and client secret. + +1. In the AWS Console, go to the **IAM** service. + +2. Select **Users**. + +3. Find the user you wish to create the EKS cluster with. Select the user. + +4. Click **Security Credentials**. + +5. Click **Create access key**. + +6. Record the **Access key ID** and **Secret access key**. You will need to use these in Rancher to create your EKS cluster. + +## Create the EKS Cluster + +Use {{< product >}} to set up and configure your Kubernetes cluster. + +1. From the **Clusters** page, click **Add Cluster**. + +2. Choose **Amazon EKS**. + +3. Enter a **Cluster Name**. + +4. {{< step_create-cluster_member-roles >}} + +5. Enter your **Access Key**. + +6. Enter your **Secret Key** + +7. Click **Next: Authenticate & configure nodes**. + +8. Specify any additional options (such as instance type or minimum and maximum number of nodes). Then click **Create**. + +{{< result_create-cluster >}}