title: 在 GKE 上安装 Rancher description: keywords:

  • rancher
  • rancher中文
  • rancher中文文档
  • rancher官网
  • rancher文档
  • Rancher
  • rancher 中文
  • rancher 中文文档
  • rancher cn
  • 高可用安装指南
  • 安装 Rancher
  • 在 GKE 上安装 Rancher

在本节中，你将学习如何使用 GKE 安装 Rancher。

如果你已经有一个 GKE Kubernetes 集群，请跳到关于安装 ingress 的步骤，然后按照本页上的说明安装 Rancher Helm chart 。

先决条件

  • 你将需要一个谷歌账户。
  • 你将需要一个 Google Cloud 计费账户。你可以使用 Google Cloud Console 来管理你的 Cloud Billing 账户。关于 Cloud Console 的更多信息，请访问控制台的一般指南。
  • 你将需要至少一个在用的 IP 地址和至少 2 个 CPU 的云配额。关于 Rancher Server硬件要求的更多细节，请参考本节

1. 启用 Kubernetes Engine API

执行以下步骤以启用 Kubernetes Engine API：

  1. 访问 Google Cloud Console 中的Kubernetes Engine 页面。
  2. 创建或选择一个项目。
  3. 打开项目，为项目启用 Kubernetes Engine API。等待 API 和相关服务被启用。这可能需要几分钟的时间。
  4. 确保为你的云项目启用了计费。关于如何为你的项目启用计费的信息，请参考Google Cloud 文档。

2. 打开 Cloud Shell

Cloud Shell 是一个 shell 环境，用于管理托管在 GCP 上的资源。Cloud Shell 预装了 gcloud 命令行工具和 kubectl 命令行工具。该 gcloud 工具为 kubectl GCP 提供了主要的命令行界面，并提供了针对 Kubernetes 集群运行命令的主要命令行界面。

以下部分描述了如何从 Google Cloud Console 或从本地工作站启动 Cloud Shell。

Cloud Shell

要从 Google Cloud Console 启动 shell，请到控制台的右上角，点击终端按钮。当悬停在该按钮上时，它被标记为 Activate Cloud Shell。

本地 Shell

要安装gcloud和kubectl，请执行以下步骤：

  1. 按照这些步骤安装 Cloud SDK。Cloud SDK 包括gcloud命令行工具。根据你的操作系统，步骤有所不同。

  2. 安装 Cloud SDK 后，通过运行以下命令安装kubectl命令行工具:

    1. gcloud components install kubectl

    在后面的步骤中，kubectl将被配置为使用新的 GKE 集群。

  3. 安装 Helm 3，如果还没有安装。

  4. 用HELM_EXPERIMENTAL_OCI变量启用 Helm 实验性支持 OCI 镜像。在~/.bashrc（或 macOS 中的~/.bash_profile，或你的 shell 存储环境变量的地方）添加以下行：

    1. export HELM_EXPERIMENTAL_OCI=1

  5. 运行以下命令来加载你更新的 .bashrc 文件:

    1. source ~/.bashrc

    如果你运行的是 macOS，使用这个命令:

    1. source ~/.bash_profile

3. 配置 gcloud CLI

使用以下方法之一来设置 gcloud 的默认设置:

  • 如果您想了解设置默认值，请使用 gcloud init。
  • 使用 gcloud config，来单独设置您的项目 ID、区域和地区。

import Tabs from ‘@theme/Tabs’; import TabItem from ‘@theme/TabItem’;

1. 运行 gcloud init 并按照指示操作。 gcloud init 如果你在远程服务器上使用 SSH，使用—console-only 标志，以防止该命令启动浏览器。 gcloud init --console-only 2. 按照指示，授权 gcloud 使用你的 Google Cloud 账户，并选择你创建的新项目。

4. 确认 gcloud 的配置是正确的

运行:

  1. gcloud config list

输出应该类似于以下内容:

  1. [compute]
  2. region = us-west1 # Your chosen region
  3. zone = us-west1-b # Your chosen zone
  4. [core]
  5. account = <Your email>
  6. disable_usage_reporting = True
  7. project = <Your project ID>
  9. Your active configuration is: [default]

5. 创建一个 GKE 集群

下面的命令创建了一个三节点的集群。

将cluster-name替换为新集群的名称。

在选择 Kubernetes 版本时，请务必先查阅 支持矩阵 找到针对你的 Rancher 版本进行验证的 Kubernetes 最高版本。

  1. gcloud container clusters create cluster-name --num-nodes=3 --cluster-version=1.20.10-gke.301

6. 获取认证凭证

创建集群后，你需要获得认证凭证，以便与集群互动:

  1. gcloud container clusters get-credentials cluster-name

这个命令可以配置kubectl使用你创建的集群。

7. 安装一个 Ingress

集群需要一个 Ingress，以便 Rancher 可以从集群外部访问。

下面的命令安装了一个带有 LoadBalancer 服务的nginx-ingress-controller:

  1. helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
  2. helm repo update
  3. helm upgrade --install \
  4.   ingress-nginx ingress-nginx/ingress-nginx \
  5.   --namespace ingress-nginx \
  6.   --set controller.service.type=LoadBalancer \
  7.   --version 3.12.0 \
  8.   --create-namespace

8. 获取负载均衡器的 IP

要获得负载均衡器的地址，请运行:

  1. kubectl get service ingress-nginx-controller --namespace=ingress-nginx

结果应该与下面类似:

  1. NAME                       TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE
  2. ingress-nginx-controller   LoadBalancer   10.3.244.156   35.233.206.34   80:31876/TCP,443:32497/TCP   81s

保存EXTERNAL-IP。

9. 设置 DNS

到 Rancher Server的外部流量将需要指向你创建的负载均衡器。

设置一个 DNS 来指向你保存的外部 IP。这个 DNS 将被用作 Rancher Server的 URL。

有许多有效的方法来设置 DNS。如需帮助，请参考谷歌云文档中关于管理 DNS 记录。

10. 安装 Rancher Helm Chart

接下来，按照本页上的说明安装 Rancher Helm Chart。 Helm 说明对于在任何 Kubernetes 发行版上安装 Rancher 是一样的。

当你安装 Rancher 时，使用前一步的 DNS 名称作为 Rancher Server的 URL。它可以作为一个 Helm 选项传入。例如，如果 DNS 名称是rancher.my.org，你可以用--set hostname=rancher.my.org选项运行 Helm 安装命令。