github.com/pachyderm/pachyderm@v1.13.4/doc/docs/1.10.x/deploy-manage/deploy/amazon_web_services/deploy-eks.md (about)

     1  # Deploy Pachyderm on Amazon EKS
     2  
     3  Amazon EKS provides an easy way to deploy, configure, and
     4  manage Kubernetes clusters. If you want to avoid managing your
     5  Kubernetes infrastructure, EKS might be
     6  the right choice for your organization. Pachyderm seamlessly
     7  deploys on Amazon EKS.
     8  
     9  ## Prerequisites
    10  
    11  Before you can deploy Pachyderm on an EKS cluster, verify that
    12  you have the following prerequisites installed and configured:
    13  
    14  * [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
    15  * [AWS CLI](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html)
    16  * [eksctl](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html)
    17  * [aws-iam-authenticator](https://docs.aws.amazon.com/eks/latest/userguide/install-aws-iam-authenticator.html).
    18  * [pachctl]()
    19  
    20  ## Deploy an EKS cluster by using `eksctl`
    21  
    22  Use the `eksctl` tool to deploy an EKS cluster in your
    23  Amazon AWS environment. The `eksctl create cluster` command
    24  creates a virtual private cloud (VPC), a security group,
    25  and an IAM role for Kubernetes to create resources.
    26  For detailed instructions, see [Amazon documentation](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-console.html).
    27  
    28  To deploy an EKS cluster, complete the following steps:
    29  
    30  1. Deploy an EKS cluster:
    31  
    32     ```shell
    33     eksctl create cluster --name <name> --version <version> \
    34     --nodegroup-name <name> --node-type <vm-flavor> \
    35     --nodes <number-of-nodes> --nodes-min <min-number-nodes> \
    36     --nodes-max <max-number-nodes> --node-ami auto
    37     ```
    38  
    39     **Example output:**
    40  
    41     ```shell
    42     [ℹ]  using region us-east-1
    43     [ℹ]  setting availability zones to [us-east-1a us-east-1f]
    44     [ℹ]  subnets for us-east-1a - public:192.168.0.0/19 private:192.168.64.0/19
    45     [ℹ]  subnets for us-east-1f - public:192.168.32.0/19 private:192.168.96.0/19
    46     [ℹ]  nodegroup "pachyderm-test-workers" will use "ami-0f2e8e5663e16b436" [AmazonLinux2/1.13]
    47     [ℹ]  using Kubernetes version 1.13
    48     [ℹ]  creating EKS cluster "pachyderm-test-eks" in "us-east-1" region
    49     [ℹ]  will create 2 separate CloudFormation stacks for cluster itself and the initial nodegroup
    50     [ℹ]  if you encounter any issues, check CloudFormation console or try 'eksctl utils describe-stacks --region=us-east-1 --name=pachyderm-test-eks'
    51     [ℹ]  2 sequential tasks: { create cluster control plane "svetkars-eks", create nodegroup "pachyderm-test-workers" }
    52     [ℹ]  building cluster stack "eksctl-pachyderm-test-eks-cluster"
    53     [ℹ]  deploying stack "eksctl-pachyderm-test-eks-cluster"
    54  
    55     ...
    56     [✔]  EKS cluster "pachyderm-test" in "us-east-1" region is ready
    57     ```
    58  
    59  1. Verify the deployment:
    60  
    61     ```shell
    62     kubectl get all
    63     ```
    64  
    65     **System Response:**
    66  
    67     ```shell
    68     NAME                 TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
    69     service/kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   7m9s
    70     ```
    71  
    72  1. Deploy Pachyderm as described in [Deploy Pachyderm on AWS](aws-deploy-pachyderm.md).
    73