anchor.diff:  = Create Kubernetes cluster using kops
   :toc:
   
  -This tutorial will walk you through how to install a Kubernetes cluster using kops on AWS.
  -
  -https://github.com/kubernetes/kops[kops], short for Kubernetes Operations, is a set of tools for installing, operating, and deleting Kubernetes clusters in the cloud. A rolling upgrade of an older version of Kubernetes to a new version can also be performed. It also manages the cluster add-ons. After the cluster is created, the usual kubectl CLI can be used to manage resources in the cluster.
  +This tutorial will walk you through how to install a Kubernetes cluster on AWS using kops.
  +
  +https://github.com/kubernetes/kops[kops], short for Kubernetes Operations, is a set of tools for installing, operating, and deleting Kubernetes clusters in the cloud. It can also perform rolling upgrades from older versions of Kubernetes to newer ones. kops also manages the cluster add-ons. After the cluster is created, the usual link:getting-started[kubectl CLI] can be used to manage resources in the cluster.
  +
  +kops is available on Mac OSX, Linux, or the Windows 10 Linux Subsystem. 
   
   == Install kops
   
  
positive.code: 
      brew upgrade kops
  
  ==== Linux:
  
      wget https://github.com/kubernetes/kops/releases/download/1.7.1/kops-linux-amd64
      sudo chmod +x kops-linux-amd64
      sudo mv kops-linux-amd64 /usr/local/bin/kops
  
  kops is available on Mac OSX, Linux or the Windows 10 Linux Subsystem. 
  Complete installation instructions are available at https://github.com/kubernetes/kops#installing.
  
  Check kops version:
  
  
negative.code: 
  Latest and early versions of kops can be downloaded from https://github.com/kubernetes/kops/releases.
  
  You will also need the Kubernetes CLI (kubectl) to manage the resources on the Kubernetes cluster. If you don't have the Kubernetes CLI installed, please follow the instructions link:../getting-started#download-and-install[here] to do so.
  
  === Configure kops
  
  kops uses a public SSH key while creating a cluster. The location of this file defaults to `~/.ssh/id_rsa.pub`. Please generate an SSH key using `ssh-keygen` command.
  
      $ ssh-keygen 
      Generating public/private rsa key pair.
      Enter file in which to save the key (~/.ssh/id_rsa):
      Enter passphrase (empty for no passphrase): 
      Enter same passphrase again: 
      Your identification has been saved in ~/.ssh/id_rsa
      Your public key has been saved in ~/.ssh/id_rsa.pub.
      The key fingerprint is:
      SHA256:bQXH2zAAcFVtpEwcOL5D1QZnXp3zkiC123456789
      The key's randomart image is:
      +---[RSA 2048]----+
      |      ..oo=B**+ +|
      |       . o+=B*=+.|
      |        +..+*O+E=|
      |       . =o=.o=oo|
      |        S.*..  o |
      |         oo      |
      |           .     |
      |                 |
      |                 |
      +----[SHA256]-----+
  
  Alternatively, you can use the `--ssh-public-key` option to specify a custom location. 
  More details about kops security can be found in the https://github.com/kubernetes/kops/blob/master/docs/security.md[documentation for kops].
  
  == IAM user permissions
  
  Make sure the latest version of the http://docs.aws.amazon.com/cli/latest/userguide/installing.html[AWS CLI]
  is installed. 
  
     $ pip install --upgrade awscli
  
  The AWS user profile used in this workshop must have these http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html[IAM policies] attached.
  
      AmazonEC2FullAccess
      AmazonRoute53FullAccess
  