From 723abce4e5d68335295e465520cf5ce3d32fabb5 Mon Sep 17 00:00:00 2001
From: eric-hole <eric.hole@gmail.com>
Date: Sun, 15 Dec 2019 23:54:39 -0800
Subject: [PATCH] Generated code: kops_create_cluster

---
 docs/cli/kops_create_cluster.md | 35 +++++++++++++++++----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/docs/cli/kops_create_cluster.md b/docs/cli/kops_create_cluster.md
index ae0ad5c622..e7a77d47b4 100644
--- a/docs/cli/kops_create_cluster.md
+++ b/docs/cli/kops_create_cluster.md
@@ -18,15 +18,15 @@ kops create cluster [flags]
 ### Examples
 
 ```
-  # Create a cluster in AWS
+  # Create a cluster in AWS in a single zone.
   kops create cluster --name=kubernetes-cluster.example.com \
-  --state=s3://kops-state-1234 --zones=eu-west-1a \
+  --state=s3://kops-state-1234 \
+  --zones=eu-west-1a \
   --node-count=2
   
-  # Create a cluster in AWS that has HA masters.  This cluster
-  # will be setup with an internal networking in a private VPC.
-  # A bastion instance will be setup to provide instance access.
-  
+  # Create a cluster in AWS with HA masters. This cluster
+  # has also been configured for private networking in a kops-managed VPC.
+  # The bastion flag is set to create an entrypoint for admins to SSH.
   export NODE_SIZE=${NODE_SIZE:-m4.large}
   export MASTER_SIZE=${MASTER_SIZE:-m4.large}
   export ZONES=${ZONES:-"us-east-1d,us-east-1b,us-east-1c"}
@@ -42,23 +42,24 @@ kops create cluster [flags]
   --bastion="true" \
   --yes
   
-  # Create cluster in GCE.
-  # This is an alpha feature.
+  # Create a cluster in GCE.
   export KOPS_STATE_STORE="gs://mybucket-kops"
   export ZONES=${MASTER_ZONES:-"us-east1-b,us-east1-c,us-east1-d"}
-  export KOPS_FEATURE_FLAGS=AlphaAllowGCE
-  
-  kops create cluster kubernetes-k8s-gce.example.com
+  export KOPS_FEATURE_FLAGS=AlphaAllowGCE # Note: GCE support is not GA.
+  kops create cluster kubernetes-k8s-gce.example.com \
   --zones $ZONES \
   --master-zones $ZONES \
-  --node-count 3
-  --project my-gce-project \
-  --image "ubuntu-os-cloud/ubuntu-1604-xenial-v20170202" \
+  --node-count 3 \
   --yes
-  # Create manifest for a cluster in AWS
+  
+  # Generate a cluster spec to apply later.
+  # Run the following, then: kops create -f filename.yamlh
   kops create cluster --name=kubernetes-cluster.example.com \
-  --state=s3://kops-state-1234 --zones=eu-west-1a \
-  --node-count=2 --dry-run -oyaml
+  --state=s3://kops-state-1234 \
+  --zones=eu-west-1a \
+  --node-count=2 \
+  --dry-run \
+  -oyaml > filename.yaml
 ```
 
 ### Options