[jjo] fix: docu update: use 1.16 for kube versions, add a note re: aw…

…s cognito issue (#866)
vmware-archive · Jun 29, 2020 · 0be6c72 · 0be6c72
1 parent bf23e50
commit 0be6c72
Show file tree

Hide file tree

Showing 3 changed files with 13 additions and 3 deletions.
diff --git a/docs/quickstart-aks.md b/docs/quickstart-aks.md
@@ -45,7 +45,7 @@ In this section, you will deploy an Azure Kubernetes Service (AKS) cluster using
   export AZURE_REGION=eastus
   export AZURE_RESOURCE_GROUP=my-kubeprod-group
   export AZURE_AKS_CLUSTER=my-aks-cluster
-  export AZURE_AKS_K8S_VERSION=1.11.5
+  export AZURE_AKS_K8S_VERSION=1.16.9  # please do read below for actual available versions in the region
   ```
 
   - `BKPR_DNS_ZONE` specifies the DNS suffix for the externally-visible websites and services deployed in the cluster.

diff --git a/docs/quickstart-eks.md b/docs/quickstart-eks.md
@@ -43,7 +43,7 @@ In this section, you will deploy an Amazon Elastic Container Service for Kuberne
   export BKPR_DNS_ZONE=my-domain.com
   export AWS_EKS_USER=my-user@example.com
   export AWS_EKS_CLUSTER=my-eks-cluster
-  export AWS_EKS_K8S_VERSION=1.11
+  export AWS_EKS_K8S_VERSION=1.16
   ```
 
   - `BKPR_DNS_ZONE` specifies the DNS suffix for the externally-visible websites and services deployed in the cluster.
@@ -146,6 +146,16 @@ In order to access protected resources which require authentication, such as Pro
 
 At any time, if you are presented with an Amazon AWS authentication form, you can use this user account to authenticate against protected resources in BKPR.
 
+NOTE: if the credentials you configured for the user fail to work, e.g.
+getting into a "loop" being asked for password change after 1st login, while
+consistently not succeeding, you may need to forcebly set its credentials and
+state with:
+
+  ```bash
+  aws --region REGION cognito-idp admin-set-user-password --user-pool-id ID --username USER --password PASS --permanent
+  ```
+
+
 ### Step 3: Deploy BKPR
 
 To bootstrap your Kubernetes cluster with BKPR, use the command below:

diff --git a/docs/quickstart-gke.md b/docs/quickstart-gke.md
@@ -60,7 +60,7 @@ In this section, you will deploy a Google Kubernetes Engine (GKE) cluster using
   export GCLOUD_ZONE="us-east1-d"
   export GCLOUD_AUTHZ_DOMAIN="my-domain.com"
   export GCLOUD_K8S_CLUSTER="my-gke-cluster"
-  export GCLOUD_K8S_VERSION="1.11"
+  export GCLOUD_K8S_VERSION="1.16"
   ```
 
   - `BKPR_DNS_ZONE` specifies the DNS suffix for the externally-visible websites and services deployed in the cluster. A TLD or a sub-domain may be used.