| // Licensed to the Apache Software Foundation (ASF) under one or more |
| // contributor license agreements. See the NOTICE file distributed with |
| // this work for additional information regarding copyright ownership. |
| // The ASF licenses this file to You under the Apache License, Version 2.0 |
| // (the "License"); you may not use this file except in compliance with |
| // the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| = Amazon EKS Deployment |
| :command: kubectl |
| :soft_name: Kubernetes |
| :serviceName: Amazon EKS |
| :configDir: ../../code-snippets/k8s |
| :script: ../../code-snippets/k8s/setup.sh |
| :javaFile: ../../{javaCodeDir}/k8s/K8s.java |
| |
| |
| This page is a step-by-step guide on how to deploy an Ignite cluster on Amazon EKS. |
| |
| include::installation/kubernetes/generic-configuration.adoc[tag=intro] |
| |
| include::installation/kubernetes/generic-configuration.adoc[tag=kube-version] |
| |
| In this guide, we will use the `eksctl` command line tool to create a Kubernetes cluster. |
| Follow link:https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html[this guide,window=_blank] to install the required resources and get familiar with the tool. |
| |
| |
| == Creating an Amazon EKS Cluster |
| |
| First of all, you need to create an Amazon EKS cluster that will provide resources for our Kubernetes pods. |
| You can create a cluster using the following command: |
| |
| [source, shell] |
| ---- |
| eksctl create cluster --name ignitecluster --nodes 2 --nodes-min 1 --nodes-max 4 |
| ---- |
| |
| Check the link:https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html[EKS documentation,window=_blank] for the full list of options. |
| The provisioning of a cluster can take up to 15 minutes. |
| Check the status of the cluster using the following command: |
| |
| [source, shell] |
| ---- |
| $ eksctl get cluster -n ignitecluster |
| NAME VERSION STATUS CREATED VPC SUBNETS SECURITYGROUPS |
| ignitecluster 1.14 ACTIVE 2019-12-16T09:57:09Z vpc-0ebf4a6ee3de12c63 subnet-00fa7e85aaebcd54d,subnet-06134ae545a5cc04c,subnet-063d9fdb481e727d2,subnet-0a087062ddc47c341 sg-06a6800a67ea95528 |
| ---- |
| |
| When the status of the cluster becomes ACTIVE, you can start creating Kubernetes resources. |
| |
| Verify that your `kubectl` is configured correctly: |
| |
| [source, shell] |
| ---- |
| $ kubectl get svc |
| NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE |
| kubernetes ClusterIP 10.100.0.1 <none> 443/TCP 6m49s |
| ---- |
| |
| == Kubernetes Configuration |
| |
| include::installation/kubernetes/generic-configuration.adoc[tag=kubernetes-config] |
