From 30e0b808f7e8959f1ccb1beb818b3af3b2453135 Mon Sep 17 00:00:00 2001 From: Amy Unruh Date: Mon, 22 Jun 2015 18:46:16 -0700 Subject: [PATCH] gce getting started clarifications --- docs/getting-started-guides/gce.md | 48 +++++++++++++++++++----------- 1 file changed, 30 insertions(+), 18 deletions(-) diff --git a/docs/getting-started-guides/gce.md b/docs/getting-started-guides/gce.md index 80ae17ab63c..355bac6c58e 100644 --- a/docs/getting-started-guides/gce.md +++ b/docs/getting-started-guides/gce.md @@ -3,20 +3,20 @@ Getting started on Google Compute Engine **Table of Contents** - - [Before you start](#before-you-start) - - [Prerequisites](#prerequisites) - - [Starting a cluster](#starting-a-cluster) - - [Installing the kubernetes command line tools on your workstation](#installing-the-kubernetes-command-line-tools-on-your-workstation) - - [Getting started with your cluster](#getting-started-with-your-cluster) - - [Inspect your cluster](#inspect-your-cluster) - - [Run some examples](#run-some-examples) - - [Tearing down the cluster](#tearing-down-the-cluster) - - [Customizing](#customizing) - - [Troubleshooting](#troubleshooting) - - [Project settings](#project-settings) - - [Cluster initialization hang](#cluster-initialization-hang) - - [SSH](#ssh) - - [Networking](#networking) +- [Before you start](#before-you-start) +- [Prerequisites](#prerequisites) +- [Starting a cluster](#starting-a-cluster) +- [Installing the kubernetes command line tools on your workstation](#installing-the-kubernetes-command-line-tools-on-your-workstation) +- [Getting started with your cluster](#getting-started-with-your-cluster) + - [Inspect your cluster](#inspect-your-cluster) + - [Run some examples](#run-some-examples) +- [Tearing down the cluster](#tearing-down-the-cluster) +- [Customizing](#customizing) +- [Troubleshooting](#troubleshooting) + - [Project settings](#project-settings) + - [Cluster initialization hang](#cluster-initialization-hang) + - [SSH](#ssh) + - [Networking](#networking) The example below creates a Kubernetes cluster with 4 worker node Virtual Machines and a master Virtual Machine (i.e. 5 VMs in your cluster). This cluster is set up and controlled from your workstation (or wherever you find convenient). @@ -39,20 +39,32 @@ If you want to use custom binaries or pure open source Kubernetes, please contin ### Starting a cluster -You can install a client and start a cluster with this command: +You can install a client and start a cluster with either one of these commands (we list both in case only one is installed on your machine): + + + ```bash + curl -sS https://get.k8s.io | bash + ``` + +or ```bash -curl -sS https://get.k8s.io | bash +wget -q -O - https://get.k8s.io | bash ``` -Once this command completes, you will have a master VM and four worker VMs, running as a Kubernetes cluster. By default, some containers will already be running on your cluster. Containers like `kibana` and `elasticsearch` provide [logging](../logging.md), while `heapster` provides [monitoring](../../cluster/addons/cluster-monitoring/README.md) services. +Once this command completes, you will have a master VM and four worker VMs, running as a Kubernetes cluster. -Alternately, if you prefer, you can download and install the latest Kubernetes release from [this page](https://github.com/GoogleCloudPlatform/kubernetes/releases), then run the `/cluster/kube-up.sh` script to start the cluster: +By default, some containers will already be running on your cluster. Containers like `kibana` and `elasticsearch` provide [logging](../logging.md), while `heapster` provides [monitoring](../../cluster/addons/cluster-monitoring/README.md) services. + +The script run by the commands above creates a cluster with the name/prefix "kubernetes". It defines one specific cluster config, so you can't run it more than once. + +Alternately, you can download and install the latest Kubernetes release from [this page](https://github.com/GoogleCloudPlatform/kubernetes/releases), then run the `/cluster/kube-up.sh` script to start the cluster: ```bash cd kubernetes cluster/kube-up.sh ``` +If you want more than one cluster running in your project, want to use a different name, or want a different number of worker nodes, see the `/cluster/gce/config-default.sh` file for more fine-grained configuration before you start up your cluster. If you run into trouble, please see the section on [troubleshooting](gce.md#troubleshooting), post to the [google-containers group](https://groups.google.com/forum/#!forum/google-containers), or come ask questions on IRC at #google-containers on freenode.