kubernetes
/
kops
mirror of https://github.com/kubernetes/kops.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #6278 from elithrar/docs/state-store-easier 

[docs] Use env var for state store examples
This commit is contained in:
Kubernetes Prow Robot 2019-04-24 12:22:26 -07:00 committed by GitHub
parent bea86cb4d9 f29004e6ea
commit 00782fd908
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/tutorial/gce.md
View File

@ -17,7 +17,16 @@ kops needs a state store, to hold the configuration for your clusters. The simp
for Google Cloud is to store it in a Google Cloud Storage bucket in the same account, so that's how we'll for Google Cloud is to store it in a Google Cloud Storage bucket in the same account, so that's how we'll
start. start.
So, just create an empty bucket - you can use any name: `gsutil mb gs://kubernetes-clusters/` So, just create an empty bucket - you can use any (available) name - e.g. `gsutil mb gs://kubernetes-clusters/`
Further, rather than typing the `--state` argument every time, it's much easier to export the `KOPS_STATE_STORE`
environment variable:
```
export KOPS_STATE_STORE=gs://kubernetes-clusters/
```
You can also put this in your `~/.bashrc` or similar.
# Creating our first cluster # Creating our first cluster
@ -26,12 +35,14 @@ So, just create an empty bucket - you can use any name: `gsutil mb gs://kubernet
``` ```
PROJECT=`gcloud config get-value project` PROJECT=`gcloud config get-value project`
export KOPS_FEATURE_FLAGS=AlphaAllowGCE # to unlock the GCE features export KOPS_FEATURE_FLAGS=AlphaAllowGCE # to unlock the GCE features
kops create cluster simple.k8s.local --zones us-central1-a --state gs://kubernetes-clusters/ --project=${PROJECT} kops create cluster simple.k8s.local --zones us-central1-a --state ${KOPS_STATE_STORE}/ --project=${PROJECT}
``` ```
You can now list the Cluster objects in your kops state store (the GCS bucket we created): You can now list the Cluster objects in your kops state store (the GCS bucket
we created).
`kops get cluster --state gs://kubernetes-clusters/` ```
kops get cluster --state ${KOPS_STATE_STORE}
``` ```
NAME CLOUD ZONES NAME CLOUD ZONES
@ -49,7 +60,7 @@ objects on a kubernetes cluster.
You can see the details of your Cluster object by doing: You can see the details of your Cluster object by doing:
`> kops get cluster --state gs://kubernetes-clusters/ simple.k8s.local -oyaml` `> kops get cluster --state ${KOPS_STATE_STORE}/ simple.k8s.local -oyaml`
``` ```
apiVersion: kops/v1alpha2 apiVersion: kops/v1alpha2
kind: Cluster kind: Cluster
@ -99,7 +110,7 @@ spec:
Similarly, you can also see your InstanceGroups using: Similarly, you can also see your InstanceGroups using:
`kops get instancegroup --state gs://kubernetes-clusters/ --name simple.k8s.local` `kops get instancegroup --state ${KOPS_STATE_STORE}/ --name simple.k8s.local`
``` ```
NAME ROLE MACHINETYPE MIN MAX SUBNETS NAME ROLE MACHINETYPE MIN MAX SUBNETS
master-us-central1-a Master n1-standard-1 1 1 us-central1 master-us-central1-a Master n1-standard-1 1 1 us-central1
@ -116,17 +127,6 @@ and one for our nodes (and we have two nodes configured).
We'll see a lot more of Cluster objects and InstanceGroups as we use kops to reconfigure clusters. But let's get We'll see a lot more of Cluster objects and InstanceGroups as we use kops to reconfigure clusters. But let's get
on with our first cluster. on with our first cluster.
# Export KOPS_STATE_STORE
Rather than typing the `--state` argument every time, it's much easier to export the `KOPS_STATE_STORE`
environment variable:
```
export KOPS_STATE_STORE=gs://kubernetes-clusters/
```
You can also put this in your `~/.bashrc` or similar.
# Creating a cluster # Creating a cluster
`kops create cluster` created the Cluster object & InstanceGroup object in our state store, `kops create cluster` created the Cluster object & InstanceGroup object in our state store,