From 277edbd39029f17f9f33561807f542b10d3a3b7f Mon Sep 17 00:00:00 2001 From: badra001 Date: Wed, 10 Nov 2021 10:47:59 -0500 Subject: [PATCH] update readme --- examples/full-cluster/aws-auth/README.md | 68 ++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 examples/full-cluster/aws-auth/README.md diff --git a/examples/full-cluster/aws-auth/README.md b/examples/full-cluster/aws-auth/README.md new file mode 100644 index 0000000..e7a638f --- /dev/null +++ b/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 +```