From 8f93edf07fbbfd7478709c996c790e3931f39ba6 Mon Sep 17 00:00:00 2001 From: ncclementi Date: Fri, 14 Feb 2025 18:59:03 -0500 Subject: [PATCH 1/5] improve eks deployment docs --- source/cloud/aws/eks.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/source/cloud/aws/eks.md b/source/cloud/aws/eks.md index 4a28cea4..a30f87a9 100644 --- a/source/cloud/aws/eks.md +++ b/source/cloud/aws/eks.md @@ -10,7 +10,7 @@ To run RAPIDS you'll need a Kubernetes cluster with GPUs available. ## Prerequisites -First you'll need to have the [`aws` CLI tool](https://aws.amazon.com/cli/) and [`eksctl` CLI tool](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html) installed along with [`kubectl`](https://kubernetes.io/docs/tasks/tools/), [`helm`](https://helm.sh/docs/intro/install/), etc for managing Kubernetes. +First you'll need to have the [`aws` CLI tool](https://aws.amazon.com/cli/) and [`eksctl` CLI tool](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html) installed along with [`kubectl`](https://kubernetes.io/docs/tasks/tools/), [`helm`](https://helm.sh/docs/intro/install/), for managing Kubernetes. Ensure you are logged into the `aws` CLI. @@ -20,16 +20,24 @@ $ aws configure ## Create the Kubernetes cluster -Now we can launch a GPU enabled EKS cluster. First launch an EKS cluster with `eksctl`. +Now we can launch a GPU enabled EKS cluster with `eksctl`. + +```{notes} +1. You will need to create or import public ssh-key to be able to execute the following command. +In your aws console under `EC2` in the side panel under Network & Security > Key Pairs, you can create a +key pair or import (see "Actions" dropdown) one you've created locally. + +2. If you are not using your default AWS profile, add `--profile ` to the following command. +``` ```console $ eksctl create cluster rapids \ - --version 1.29 \ + --version 1.30 \ --nodes 3 \ - --node-type=p3.8xlarge \ + --node-type=g4dn.xlarge \ --timeout=40m \ --ssh-access \ - --ssh-public-key \ # Be sure to set your public key ID here + --ssh-public-key \ # Named assigned during creation of your key in aws console --region us-east-1 \ --zones=us-east-1c,us-east-1b,us-east-1d \ --auto-kubeconfig @@ -37,7 +45,7 @@ $ eksctl create cluster rapids \ With this command, you’ve launched an EKS cluster called `rapids`. You’ve specified that it should use nodes of type `p3.8xlarge`. We also specified that we don't want to install the NVIDIA drivers as we will do that with the NVIDIA operator. -To access the cluster we need to pull down the credentials. +To access the cluster we need to pull down the credentials. Add `--profile ` if you are not using the default profile. ```console $ aws eks --region us-east-1 update-kubeconfig --name rapids From e7f051119571c929bf82cb82ce3ed851dc15ba5e Mon Sep 17 00:00:00 2001 From: ncclementi Date: Fri, 14 Feb 2025 19:33:59 -0500 Subject: [PATCH 2/5] fix typo --- source/cloud/aws/eks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/cloud/aws/eks.md b/source/cloud/aws/eks.md index a30f87a9..11fde211 100644 --- a/source/cloud/aws/eks.md +++ b/source/cloud/aws/eks.md @@ -22,7 +22,7 @@ $ aws configure Now we can launch a GPU enabled EKS cluster with `eksctl`. -```{notes} +```{note} 1. You will need to create or import public ssh-key to be able to execute the following command. In your aws console under `EC2` in the side panel under Network & Security > Key Pairs, you can create a key pair or import (see "Actions" dropdown) one you've created locally. From 0561ece6a517476a8ec2352c26c003aba476bf6d Mon Sep 17 00:00:00 2001 From: Naty Clementi Date: Tue, 18 Feb 2025 16:04:09 -0500 Subject: [PATCH 3/5] fix grammar Co-authored-by: James Lamb --- source/cloud/aws/eks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/cloud/aws/eks.md b/source/cloud/aws/eks.md index 11fde211..70c3b461 100644 --- a/source/cloud/aws/eks.md +++ b/source/cloud/aws/eks.md @@ -23,7 +23,7 @@ $ aws configure Now we can launch a GPU enabled EKS cluster with `eksctl`. ```{note} -1. You will need to create or import public ssh-key to be able to execute the following command. +1. You will need to create or import a public SSH key to be able to execute the following command. In your aws console under `EC2` in the side panel under Network & Security > Key Pairs, you can create a key pair or import (see "Actions" dropdown) one you've created locally. From a60b23c37bbc495a23d7a9245640a9bb80591365 Mon Sep 17 00:00:00 2001 From: Naty Clementi Date: Tue, 18 Feb 2025 16:04:23 -0500 Subject: [PATCH 4/5] fix typo Co-authored-by: James Lamb --- source/cloud/aws/eks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/cloud/aws/eks.md b/source/cloud/aws/eks.md index 70c3b461..b74b3e01 100644 --- a/source/cloud/aws/eks.md +++ b/source/cloud/aws/eks.md @@ -37,7 +37,7 @@ $ eksctl create cluster rapids \ --node-type=g4dn.xlarge \ --timeout=40m \ --ssh-access \ - --ssh-public-key \ # Named assigned during creation of your key in aws console + --ssh-public-key \ # Name assigned during creation of your key in aws console --region us-east-1 \ --zones=us-east-1c,us-east-1b,us-east-1d \ --auto-kubeconfig From add162756d2493b8797be31ba4ac970080917127 Mon Sep 17 00:00:00 2001 From: Naty Clementi Date: Tue, 18 Feb 2025 16:05:01 -0500 Subject: [PATCH 5/5] fix line breaking Co-authored-by: James Lamb --- source/cloud/aws/eks.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/cloud/aws/eks.md b/source/cloud/aws/eks.md index b74b3e01..8eef60bc 100644 --- a/source/cloud/aws/eks.md +++ b/source/cloud/aws/eks.md @@ -45,7 +45,8 @@ $ eksctl create cluster rapids \ With this command, you’ve launched an EKS cluster called `rapids`. You’ve specified that it should use nodes of type `p3.8xlarge`. We also specified that we don't want to install the NVIDIA drivers as we will do that with the NVIDIA operator. -To access the cluster we need to pull down the credentials. Add `--profile ` if you are not using the default profile. +To access the cluster we need to pull down the credentials. +Add `--profile ` if you are not using the default profile. ```console $ aws eks --region us-east-1 update-kubeconfig --name rapids