gce getting started clarifications

This commit is contained in:
Amy Unruh 2015-06-22 18:46:16 -07:00
parent ebeb104493
commit 30e0b808f7

View File

@ -3,20 +3,20 @@ Getting started on Google Compute Engine
**Table of Contents** **Table of Contents**
- [Before you start](#before-you-start) - [Before you start](#before-you-start)
- [Prerequisites](#prerequisites) - [Prerequisites](#prerequisites)
- [Starting a cluster](#starting-a-cluster) - [Starting a cluster](#starting-a-cluster)
- [Installing the kubernetes command line tools on your workstation](#installing-the-kubernetes-command-line-tools-on-your-workstation) - [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) - [Getting started with your cluster](#getting-started-with-your-cluster)
- [Inspect your cluster](#inspect-your-cluster) - [Inspect your cluster](#inspect-your-cluster)
- [Run some examples](#run-some-examples) - [Run some examples](#run-some-examples)
- [Tearing down the cluster](#tearing-down-the-cluster) - [Tearing down the cluster](#tearing-down-the-cluster)
- [Customizing](#customizing) - [Customizing](#customizing)
- [Troubleshooting](#troubleshooting) - [Troubleshooting](#troubleshooting)
- [Project settings](#project-settings) - [Project settings](#project-settings)
- [Cluster initialization hang](#cluster-initialization-hang) - [Cluster initialization hang](#cluster-initialization-hang)
- [SSH](#ssh) - [SSH](#ssh)
- [Networking](#networking) - [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). 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 ### 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 ```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 `<kubernetes>/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 `<kubernetes>/cluster/kube-up.sh` script to start the cluster:
```bash ```bash
cd kubernetes cd kubernetes
cluster/kube-up.sh 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 `<kubernetes>/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 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. [google-containers group](https://groups.google.com/forum/#!forum/google-containers), or come ask questions on IRC at #google-containers on freenode.