下面的例子用4个节点虚拟机和1个主虚拟机（也就是说集群中使用了5个虚拟机）创建了一个Kubernetes集群。您可以在您的工作站（或是任何您觉得合适的地方）安装和控制这个集群。

开始之前

如果您想要一个简化的入门体验和图形用户界面来管理集群，请考虑尝试使用谷歌容器引擎（GKE）安装和管理托管集群。 如果您想使用自定义的二进制文件或者原生的开源Kubernetes，请看下面的说明。

前提条件

1.您需要一个可以结算费用的Google云平台账户，更多细节详见Google开发者控制台。

2.安装gcloud是必要的。 gcloud可以作为谷歌云SDK的一部分来安装。

3.然后，确保您已经安装了gcloud preview命令行组件。在命令行中运行gcloud preview。如果它要求安装任何组件，就按照提示安装。如果它只是显示帮助文本，那就大功告成了。这是必需的因为集群安装脚本使用gcloud preview命名空间中的GCE实例组，所以这一步是必要的。您还需要在开发控制台中启用计算引擎实例组管理器API。

4.确保gcloud被设定使用您想使用的谷歌云平台项目。您可以使用gcloud配置清单项目检查当前的项目，并通过 gcloud config set project <project-id> 来更改它。

5.确保您拥有基于gcloud身份验证登录的GCloud凭据。

6.确保您可以通过命令行启动一个GCE虚拟机。至少确保您可以实践GCE快速入门的创建实例部分。

7.确保您在没有交互式提示符的情况下可以ssh连接到VM。参阅GCE快速入门登录实例部分。

启动集群

您可以使用下面任意一条命令（以防万一。我们列出了两个，以防您的机器上只安装了某一个）来安装客户端并启动集群：

或者

此命令完成后，会有一个master虚拟机和四个worker虚拟机作为Kubernetes集群来运行。

默认情况下，一些容器已经运行在集群上。一些容器如kibana和elasticsearch提供日志记录，而heapster提供监控服务。

上面提到的命令运行脚本创建一个名为或者前缀为“kubernetes”的集群。它定义了一个特定的集群配置，所以只能运行一次。

或者，您可以从这个页面下载并安装最新的Kubernetes 发行版，然后运行/cluster/kube-up.sh脚本来启动集群：

如果您想在项目中运行不止一个集群，想使用不同的名字或者不同数量的工作节点，在启动集群之前参见 /cluster/gce/config-default.sh文件来进行更细粒度的配置。

如果您遇到问题，请参见故障排除章节,给Google容器组发邮件或者在IRC freenode的

#google-containers频道提问。

接下来的几个步骤将向您展示：

1.如何在您的工作站上安装命令行客户端来管理集群

2.如何使用集群的一些示例

3.如何删除群集

4.如何启动使用非默认选项的集群（如更大的集群）

在您的工作站中安装Kubernetes命令行工具

集群启动脚本会在工作站中留下一个正在运行的集群和一个kubernetes目录。下一步是要确保kubectl工具是在您的path中。

该kubectl工具控制Kubernetes集群管理器。它可以让您检查集群资源，创建、删除和更新组件以及更多功能。您会用它来查看新集群并生成示例应用程序。 添加适当的二进制文件夹到您的path中以便可以访问kubectl：

注：gcloud还附带kubectl，默认情况下被添加到您的path中。然而，gcloud所捆绑的kubectl版本可能会比通过get.k8s.io安装脚本下载的版本旧。我们建议您使用下载的二进制文件，以避免与客户机/服务器版本偏差所带来的潜在问题。

为bash配备Kubernetes命令行工具自动补全

您会发现让kubectl自动补全非常有用：

注：这种补全会在您的bash会话一直有效，如果您想要它永久有效，您需要在bash profile中添加这一行。 另外的一个选择，在大多数linux发行版中，您也可以像下面这样复制完整的文件到您的 bash_completions.d ：

但是，你在更新kubectl的时候也要更新它。

启动您的集群

监控您的集群

一旦kubectl在您的path中，您就可以用它来查看您的集群。也就是运行：

应该会显示一组服务,看起来像这样:

同样，您可以查看在集群启动时创建的pod。您可以这样做：

您会看到如下所示的pod列表（名字细节会有所不同）：

一些pod启动时可能会花费数秒（在此期间，它们会显示为挂起状态），但是在一小段时间后再次检查，它们就都是运行状态了。

运行一些例子

然后，通过一个简单的nginx示例来拿新的集群练练手。 想要了解更多完整的应用程序，请查看示例目录。该Guestbook示例就是一个很好的“入门”演练。

拆除集群

使用kube-down.sh脚本来移除/删除/拆除集群：

同样地，同一目录下的kube-up.sh会做好备份。您无需重新运行curl或wget命令：安装Kubernetes集群所需要的一切都已在您的工作站中就绪。

定制集群

上面的脚本依赖于Google存储来暂存Kubernetes发行版。然后，它会启动（默认）单个master虚拟机以及4个worker虚拟机。您可以通过编辑kubernetes/cluster/gce/configdefault.sh来调整一些参数，您可以在这里查看集群创建成功的记录。

故障排除

项目设置

您需要启用谷歌云存储API和谷歌云存储JSON API，新项目是默认启用的。如果没有启用，可以在谷歌云控制台完成。更多详情请参阅谷歌云存储JSON API

正如前提条件部分所列那样，还要确保地是，您已经启用计算引擎实例组管理器API，并且能够根据GCE快速入门中的指导那样，从命令行中启动一个GCE虚拟机。

集群初始化挂起

如果Kubernetes启动脚本挂起并等待API可用，您可以通过ssh方式连接到主虚拟机和节点虚

拟机来查看日志如：

一旦您解决了这个问题，在再次尝试运行kube-up.sh之前 ，您应该在部分集群创建后运行kube-down.sh来做一下清理。

SSH

如果您无法通过SSH连接到您的实例，请确保GCE防火墙没有屏蔽虚拟机的22端口。默认情况下，是可以正常连接到实例的，但是，如果您编辑了防火墙规则或者创建了一个新的非默认的网络，您需要将其暴露：

此外，您的GCE SSH密钥必须要么没有密码，要么需要使用ssh-agent。

网络通信

该实例必须能够使用自己的私有IP连接到对方。该脚本使用“默认”网络，该网络有一个被称为“default-allow-internal”的防火墙规则，它允许私有IP地址上的任何端口跑流量。如果这个规则在默认网络中缺失或者您修改了在cluster/config-default.sh中正在使用的网络，那么使用下面的字段值创建一个新的规则：

Source Ranges:10.0.0.0/8

Allowed Protocols and Port:tcp:1-65535;udp:1-65535;icmp