update readme

examples/full-cluster/aws-auth/README.md

@@ -0,0 +1,68 @@
+# aws-auth
+
+This sets up the the `aws-auth` ConfigMap for Kubernetes as needed in part of the cluster configuration.
+
+## Links
+
+## Terraform Automated
+
+A `tf-run.data` file exists here, so the simplest way to implemnt is with the `tf-run.sh` script.
+
+* copy the `remote_state.yml` from the parent and update `directory` to be the current directory
+* run the tf-run.sh
+
+```console
+% tf-run.sh apply
+```
+
+* example of the tf-run.sh`steps
+
+This is part of a larger cluster configuration, so at the end of the run it indicates another directory
+to visit when done.
+
+```console
+% tf-run.sh list
+** END: start=1636558187 end=1636558187 elapsed=0 logfile=logs/run.plan.20211110.1636558187.log (not-created)
+* running action=plan
+* START: tf-run.sh v1.1.2 start=1636558903 end= logfile=logs/run.plan.20211110.1636558903.log (not-created)
+* reading from tf-run.data
+* read 6 entries from tf-run.data
+> list
+** START: start=1636558903
+* 1 COMMAND> tf-directory-setup.py -l none -f
+* 2 COMMAND> setup-new-directory.sh
+* 3 COMMAND> tf-init -upgrade
+* 4 tf-plan 
+* 5 COMMAND> tf-directory-setup.py -l s3
+* 6 STOP> cd ../efs and tf-run.sh apply
+** END: start=1636558903 end=1636558903 elapsed=0 logfile=logs/run.plan.20211110.1636558903.log (not-created)
+```
+
+It is highly recommended to use the `tf-run.sh` approach.
+
+## Terraform Manual
+
+First, copy the `remote_state.yml` from the parent and update `directory` to be the current directory.
+
+```shell
+tf-directory-setup.py -l none
+setup-new-directory.sh
+tf-init
+````
+
+* Apply the rest
+
+```shell
+tf-apply
+tf-directory-setup.py -l s3
+```
+
+## Post Setup Examination
+
+Your `kubectl` configuration file needs to be setup (one is extracted in `setup/kube.config` as part of this configuration).
+
+```console
+% kubectl --kubeconfig setup/kube.config get configmap -n kube-system aws-auth 
+NAME       DATA   AGE
+aws-auth   2      44d
+```