Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve eks deployment docs #530

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Improve eks deployment docs #530

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8f93edf
improve eks deployment docs
ncclementi Feb 14, 2025
e7f0511
fix typo
ncclementi Feb 15, 2025
0561ece
fix grammar
ncclementi Feb 18, 2025
a60b23c
fix typo
ncclementi Feb 18, 2025
add1627
fix line breaking
ncclementi Feb 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 14 additions & 5 deletions source/cloud/aws/eks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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`.

```{note}
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.

2. If you are not using your default AWS profile, add `--profile <your-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 <public key ID> \ # Be sure to set your public key ID here
--ssh-public-key <public key ID> \ # 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
Expand All @@ -38,6 +46,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.
Add `--profile <your-profile>` if you are not using the default profile.

```console
$ aws eks --region us-east-1 update-kubeconfig --name rapids
Expand Down
Loading