{"id":295,"date":"2018-10-16T07:34:17","date_gmt":"2018-10-16T07:34:17","guid":{"rendered":"https:\/\/www.appservgrid.com\/paw93\/?p=295"},"modified":"2018-10-16T20:00:19","modified_gmt":"2018-10-16T20:00:19","slug":"getting-started-with-amazon-eks-provisioning-and-adding-clusters","status":"publish","type":"post","link":"https:\/\/www.appservgrid.com\/paw93\/index.php\/2018\/10\/16\/getting-started-with-amazon-eks-provisioning-and-adding-clusters\/","title":{"rendered":"Getting Started with Amazon EKS – Provisioning and Adding Clusters"},"content":{"rendered":"

This is a simple tutorial on how to launch a new Amazon EKS cluster from scratch and attach to Codefresh.<\/em><\/p>\n

Have an existing Kubernetes cluster you want to add? Please see the docs<\/a>.<\/p>\n

The source code for this tutorial can be found here:
\nhttps:\/\/github.com\/codefresh-io\/eks-installer<\/a><\/p>\n

Overview<\/h2>\n

Amazon Elastic Container Service for Kubernetes (Amazon EKS<\/a>) is the latest product release from AWS, offering fully-hosted Kubernetes clusters.<\/p>\n

This is great news for AWS users, however it is not overly simple to understand how EKS fits in with various other AWS services.<\/p>\n

To help out others get started with Amazon EKS, I\u2019ve put together a Codefresh pipeline setup.yml<\/a> that does the following:<\/p>\n

    \n
  1. Bootstraps an EKS cluster and VPC in your AWS account using Terraform<\/a><\/li>\n
  2. Saves the Terraform statefile in a Codefresh context<\/li>\n
  3. Creates some base Kubernetes resources<\/li>\n
  4. Initializes Helm in the cluster<\/li>\n
  5. Adds the cluster to your Codefresh account<\/li>\n<\/ol>\n

    There is also a corresponding teardown.yml<\/a> that:<\/p>\n

      \n
    1. Loads the Terraform statefile from Codefresh context<\/li>\n
    2. Destroys the EKS cluster from your AWS account using Terraform<\/li>\n
    3. Removes the cluster from your Codefresh account<\/li>\n<\/ol>\n

      Follow the instructions below to setup these pipelines in your account. After clicking the \u201cBuild\u201d button, your cluster should be ready to use in 10-20 minutes!<\/p>\n

      Setting up the Pipelines<\/h2>\n

      Add Repository and setup.yml pipeline<\/h3>\n

      In your Codefresh account, at the top right of your screen click the \u201cAdd Repository\u201d button. Turn on \u201cAdd by URL\u201d. Enter the following repository URL (or create and use a fork):
      \nhttps:\/\/github.com\/codefresh-io\/eks-installer<\/p>\n

      \"\"<\/p>\n

      Click \u201cNext\u201d. Click the \u201cSelect\u201d button under \u201cI have a Codefresh.yml file\u201d. For the path to codefresh.yml, enter the following:
      \n.codefresh\/setup.yml<\/p>\n

      \"\"<\/p>\n

      Click through the rest of the dialogue to create the setup.yml pipeline.<\/p>\n

      Configure Triggers<\/h3>\n

      Before going forward, make sure to delete any unwanted trigger configuration that may result in an unexpected EKS cluster launch:<\/p>\n

      \"\"<\/p>\n

      Add teardown.yml pipeline<\/h3>\n

      In the same repository view, click the \u201cAdd Pipeline\u201d link. Name this pipeline something like \u201ceks-uninstaller\u201d.<\/p>\n

      \"\"<\/p>\n

      At the bottom of the page, in the \u201cWorkflow\u201d section, select \u201cYAML\u201d. Click \u201cUse YAML from Repository\u201d. Enter the following:
      \n.codefresh\/teardown.yml<\/p>\n

      \"\"<\/p>\n

      Click \u201cSave\u201d.<\/p>\n

      Setup Environment Variables<\/h3>\n

      Under the \u201cGeneral\u201d tab, add the following global variables to be used by both of the pipelines:<\/p>\n

      AWS_ACCESS_KEY_ID encrypted<\/em> \u2013 AWS access key ID
      \nAWS_SECRET_ACCESS_KEY encrypted<\/em> \u2013 AWS secret access key
      \nCLUSTER_NAME \u2013 unique EKS cluster name<\/p>\n

      \"\"<\/p>\n

      Additionally, you can add the following optional variables for fine-tuned setup:<\/p>\n

      CLUSTER_SIZE \u2013 number of nodes in ASG (default: 1)
      \nCLUSTER_REGION \u2013 AWS region to deploy to (default: us-west-2)
      \nCLUSTER_INSTANCE_TYPE \u2013 EC2 instance type (default: m4.large)<\/p>\n

      Note that at the time of writing, EKS is only available in regions us-east-1 and us-west-2 (and seems to have reached capacity in us-east-1). Your best best is to stick with us-west-2 for now.<\/p>\n

      Click \u201cSave\u201d.<\/p>\n

      Create new EKS Cluster<\/h2>\n

      At this point, all you need to do is click \u201cBuild\u201d on the setup.yml pipeline (eks-installer)<\/p>\n

      \"\"<\/p>\n

      and wait\u2026<\/p>\n

      \"\"<\/p>\n

      Once the build is complete, navigate to the Kubernetes services page to view your newly-created EKS cluster in Codefresh:<\/p>\n

      \"\"<\/p>\n

      You can then use this cluster to deploy to from your pipelines etc.<\/p>\n

      Teardown EKS Cluster<\/h2>\n

      Similar to steps above, all you need to do to teardown your EKS cluster is to click \u201cBuild\u201d on the teardown.yml pipeline (eks-uninstaller)<\/p>\n

      \"\"<\/p>\n

      and wait\u2026<\/p>\n

      \"\"<\/p>\n

      Once the build is complete, the EKS cluster and all associated AWS resources will be destroyed, and the cluster will be removed from your Codefresh account.<\/p>\n

      Source<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

      This is a simple tutorial on how to launch a new Amazon EKS cluster from scratch and attach to Codefresh. Have an existing Kubernetes cluster you want to add? Please see the docs. The source code for this tutorial can be found here: https:\/\/github.com\/codefresh-io\/eks-installer Overview Amazon Elastic Container Service for Kubernetes (Amazon EKS) is the … <\/p>\n

      Continue reading “Getting Started with Amazon EKS – Provisioning and Adding Clusters”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-295","post","type-post","status-publish","format-standard","hentry","category-kubernetes"],"_links":{"self":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/295","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/comments?post=295"}],"version-history":[{"count":1,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/295\/revisions"}],"predecessor-version":[{"id":397,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/295\/revisions\/397"}],"wp:attachment":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/media?parent=295"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/categories?post=295"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/tags?post=295"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}