working on EKS README

Author: dak1n1

_examples/eks/README.md

@@ -1,24 +1,37 @@
-# Amazon EKS Clusters
+# EKS (Amazon Elastic Kubernetes Service)
 
-You will need the standard AWS environment variables to be set, e.g.
+This example shows how to use the Terraform Kubernetes Provider and Terraform Helm Provider to configure an EKS cluster. The example builds the EKS cluster and applies the Kubernetes configurations in a single operation.
+
+You will need the following environment variables to be set:
 
   - `AWS_ACCESS_KEY_ID`
   - `AWS_SECRET_ACCESS_KEY`
 
-See [AWS Provider docs](https://www.terraform.io/docs/providers/aws/index.html#configuration-reference) for more details about these variables
-and alternatives, like `AWS_PROFILE`.
+See [AWS Provider docs](https://www.terraform.io/docs/providers/aws/index.html#configuration-reference) for more details about these variables and alternatives, like `AWS_PROFILE`.
+
+To install the EKS cluster using default values, run terraform init and apply from the directory containing this README.
+
+```
+terraform init
+terraform apply
+```
 
-## Versions
+Optionally, the Kubernetes version can also be specified:
 
-You can set the desired version of Kubernetes via the `kubernetes_version` TF variable.
+```
+terraform apply -var=kubernetes_version=1.18
+```
 
 See https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html for currently available versions.
 
-You can set the desired version of Kubernetes via the `kubernetes_version` TF variable, like this:
+## Kubeconfig for manual CLI access
+
+This example generates a kubeconfig file in the current working directory. However, the token in this config expires in 15 minutes. I can be refreshed by running `terraform apply` again. Export the KUBECONFIG to manually access the cluster.
+
 ```
-export TF_VAR_kubernetes_version="1.18"
+export KUBECONFIG=$(terraform output kubeconfig_path)
+kubectl get pods -n test
 ```
-Alternatively you can pass it to the `apply` command line, like below.
 
 ## Worker node count and instance type
 
@@ -27,30 +40,10 @@ You can control the amount of worker nodes in the cluster as well as their machi
  - `TF_VAR_workers_count`
  - `TF_VAR_workers_type`
 
-Export values for them or pass them to the apply command line.
+Export values for them or pass them to the apply command line:
 
-## Build the cluster
-
-```
-terraform init
-terraform apply -var=kubernetes_version=1.19
-```
-
-## Exporting K8S variables
-To access the cluster you need to export the `KUBECONFIG` variable pointing to the `kubeconfig` file for the current cluster.
 ```
-export KUBECONFIG="$(terraform output kubeconfig_path)"
+terraform apply -var=workers_count=4 -var=workers_type=m4.xlarge
 ```
 
-Now you can access the cluster via `kubectl` and you can run acceptance tests against it.
 
-To run acceptance tests, your the following command in the root of the repository.
-```
-TESTARGS="-run '^TestAcc'" make testacc
-```
-
-To run only a specific set of tests, you can replace `^TestAcc` with any regular expression to filter tests by name.
-For example, to run tests for Pod resources, you can do:
-```
-TESTARGS="-run '^TestAccKubernetesPod_'" make testacc
-```