mirror of https://github.com/istio/istio.io.git
Translate quick-start-gke-dm into Chinese (#1979)
* Translate quick-start-gke-dm into Chinese * translate link titles and fix Chinese punctuations * relint
This commit is contained in:
Fu Xu
istio-bot
parent
0165de8cfa
commit
b36b0c31e0
|
|
@ -0,0 +1,251 @@
|
|||
---
|
||||
title: 使用 Google Kubernetes Engine 快速开始
|
||||
description: 快速开始操作指南，用 Google Kubernetes Engine (GKE) 安装 Istio 服务
|
||||
weight: 11
|
||||
keywords: [kubernetes,gke]
|
||||
---
|
||||
|
||||
快速开始操作指南，使用 [Google Cloud Deployment Manager](https://cloud.google.com/deployment-manager/)，在 [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine/)（GKE）上安装和运行 Istio。
|
||||
|
||||
这个快速开始创建了一个新的 GKE [zonal cluster](https://cloud.google.com/kubernetes-engine/versioning-and-upgrades#versions_available_for_new_cluster_masters)，安装当前版本的 Istio 并部署 [Bookinfo](/docs/examples/bookinfo/) 样例应用。在 [Kubernetes 安装 Istio 指南](/docs/setup/kubernetes/quick-start/) 的基础上，使用 Deployment Manager 为 Kubernetes Engine 提供一个自动的细化步骤。
|
||||
|
||||
## 前置条件
|
||||
|
||||
- 本样例需要一个有效的，并且打开了账单功能的 Google Cloud Platform 项目。如果你还没有 GCP 账户，你可以注册一个300美金的[免费试用](https://cloud.google.com/free/)账户。
|
||||
|
||||
- 确认为你的项目打开了 [Google Kubernetes Engine API](https://console.cloud.google.com/apis/library/container.googleapis.com/)（并能通过导航条中的 “APIs & Services” -> “Dashboard” 找到）。如果你没有看到 “API enabled”，那么你可能需要点击 “Enable this API” 按钮来开启 API。
|
||||
|
||||
- 你必须安装和配置 [`gcloud` command line tool](https://cloud.google.com/sdk/docs/) 并安装 `kubectl` 组件（`gcloud components install kubectl`）。如果你不想在你的电脑上安装 `gcloud` 客户端，你可以通过 [Google Cloud Shell](https://cloud.google.com/shell/docs/) 使用 `gcloud` 来完成同样的事情。
|
||||
|
||||
- {{< warning_icon >}} 你必须设置你的默认计算服务账户来包括以下内容：
|
||||
|
||||
- `roles/container.admin` (Kubernetes Engine Admin)
|
||||
- `Editor` (默认)
|
||||
|
||||
为了设置以上内容，如下图所示，在 [Cloud Console](https://console.cloud.google.com/iam-admin/iam/project) 上导航到 **IAM** 章节，并找到你的形如 `projectNumber-compute@developer.gserviceaccount.com` 的默认 GCE/GKE 服务账号。服务账号默认应该仅是 **Editor** 角色。然后在这个账户的 **Roles** 下拉列表中，找到 **Kubernetes Engine** 组，并选择 **Kubernetes Engine Admin** 角色。你的账户将会变成**多重身份**。
|
||||
|
||||
{{< image width="100%" ratio="22.94%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_gcp_iam.png"
|
||||
caption="GKE-IAM Service"
|
||||
>}}
|
||||
|
||||
然后添加 `Kubernetes Engine Admin` 角色:
|
||||
|
||||
{{< image width="70%" ratio="65.04%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_gcp_iam_role.png"
|
||||
caption="GKE-IAM Role"
|
||||
>}}
|
||||
|
||||
## 安装
|
||||
|
||||
### 启动 Deployment Manager
|
||||
|
||||
1. 一旦你的账户和项目启用，点击下面的链接，打开 Deployment Manager。
|
||||
|
||||
[Istio GKE Deployment Manager](https://accounts.google.com/signin/v2/identifier?service=cloudconsole&continue=https://console.cloud.google.com/launcher/config?templateurl={{< github_file >}}/install/gcp/deployment_manager/istio-cluster.jinja&followup=https://console.cloud.google.com/launcher/config?templateurl=https://raw.githubusercontent.com/istio/istio/master/install/gcp/deployment_manager/istio-cluster.jinja&flowName=GlifWebSignIn&flowEntry=ServiceLogin)
|
||||
|
||||
就像其他教程中的“如何访问已安装的功能”一样，我们也建议保留默认设置。工具会默认创建一个特殊设置的 GKE alpha cluster，然后安装 Istio [控制平面](/docs/concepts/what-is-istio/#architecture)、
|
||||
[BookInfo](/docs/examples/bookinfo/) 样例应用、
|
||||
[Grafana](/docs/tasks/telemetry/using-istio-dashboard/) 、
|
||||
[Prometheus](/docs/tasks/telemetry/querying-metrics/) 、
|
||||
[ServiceGraph](/docs/tasks/telemetry/servicegraph/) 和
|
||||
[跟踪](/docs/tasks/telemetry/distributed-tracing/) 。
|
||||
接下来你可以了解一下怎样访问所有这些功能。脚本只在 `default` 的命名空间中启用 Istio 自动注入。
|
||||
|
||||
1. 点击 **Deploy**:
|
||||
|
||||
{{< image width="100%" ratio="67.17%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_launcher.png"
|
||||
caption="GKE-Istio Launcher"
|
||||
>}}
|
||||
|
||||
等 Istio 完全部署好。注意这会消耗5分钟左右。
|
||||
|
||||
### 引导 `gcloud`
|
||||
|
||||
部署完成后，在你安装好的 `gcloud` 的工作站里，完成以下事项：
|
||||
|
||||
1. 为你刚刚创建的 cluster 引导 kubectl，并确认 cluster 在运行中，并且 Istio 是启用状态。
|
||||
|
||||
{{< text bash >}}
|
||||
$ gcloud container clusters list
|
||||
NAME LOCATION MASTER_VERSION MASTER_IP MACHINE_TYPE NODE_VERSION NUM_NODES STATUS
|
||||
istio-cluster us-central1-a 1.9.7-gke.1 35.232.222.60 n1-standard-2 1.9.7-gke.1 4 RUNNING
|
||||
{{< /text >}}
|
||||
|
||||
这里，这个集群的名字是 `istio-cluster`。
|
||||
|
||||
1. 接下来为这个集群获取授权
|
||||
|
||||
{{< text bash >}}
|
||||
$ gcloud container clusters get-credentials istio-cluster --zone=us-central1-a
|
||||
{{< /text >}}
|
||||
|
||||
## 验证安装
|
||||
|
||||
验证 Istio 已经安装在它自己的命名空间中
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get deployments,ing -n istio-system
|
||||
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
|
||||
deploy/grafana 1 1 1 1 4m
|
||||
deploy/istio-citadel 1 1 1 1 4m
|
||||
deploy/istio-egressgateway 1 1 1 1 4m
|
||||
deploy/istio-ingress 1 1 1 1 4m
|
||||
deploy/istio-ingressgateway 1 1 1 1 4m
|
||||
deploy/istio-pilot 1 1 1 1 4m
|
||||
deploy/istio-policy 1 1 1 1 4m
|
||||
deploy/istio-sidecar-injector 1 1 1 1 4m
|
||||
deploy/istio-statsd-prom-bridge 1 1 1 1 4m
|
||||
deploy/istio-telemetry 1 1 1 1 4m
|
||||
deploy/prometheus 1 1 1 1 4m
|
||||
deploy/servicegraph 1 1 1 1 4m
|
||||
{{< /text >}}
|
||||
|
||||
现在确认 BookInfo 样例应用也已经安装好：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get deployments,ing
|
||||
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
|
||||
deploy/details-v1 1 1 1 1 7m
|
||||
deploy/productpage-v1 1 1 1 1 7m
|
||||
deploy/ratings-v1 1 1 1 1 7m
|
||||
deploy/reviews-v1 1 1 1 1 7m
|
||||
deploy/reviews-v2 1 1 1 1 7m
|
||||
deploy/reviews-v3 1 1 1 1 7m
|
||||
{{< /text >}}
|
||||
|
||||
现在获取 `istio-ingress` 的 IP：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get svc istio-ingress -n istio-system
|
||||
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
||||
istio-ingressgateway LoadBalancer 10.59.251.109 35.194.26.85 80:31380/TCP,443:31390/TCP,31400:31400/TCP 6m
|
||||
{{< /text >}}
|
||||
|
||||
记录下已经给 BookInfo product page 指定好的 IP 和端口。（例子中是 `35.194.26.85:80`）
|
||||
|
||||
你也可以在 [Cloud Console](https://console.cloud.google.com/kubernetes/workload) 中的 **Kubernetes Engine -> Workloads** 章节找到这些：
|
||||
|
||||
{{< image width="70%" ratio="80.37%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_kubernetes_workloads.png"
|
||||
caption="GKE-Workloads"
|
||||
>}}
|
||||
|
||||
### 访问 BookInfo 样例
|
||||
|
||||
1. 为 BookInfo 的外网 IP 创建一个环境变量：
|
||||
|
||||
{{< text bash >}}
|
||||
$ export GATEWAY_URL=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
|
||||
$ echo $GATEWAY_URL
|
||||
{{< /text >}}
|
||||
|
||||
1. 确认一下你可以访问 Bookinfo `http://${GATEWAY_URL}/productpage`:
|
||||
|
||||
{{< image width="100%" ratio="45.04%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_bookinfo.png"
|
||||
caption="Bookinfo"
|
||||
>}}
|
||||
|
||||
1. 现在可以给它制造点流量：
|
||||
|
||||
{{< text bash >}}
|
||||
$ for i in {1..100}; do curl -o /dev/null -s -w "%{http_code}\n" http://${GATEWAY_URL}/productpage; done
|
||||
{{< /text >}}
|
||||
|
||||
## 验证已经安装的 Istio 插件
|
||||
|
||||
当你验证了 Istio 控制平面和样例应用正常工作后，尝试访问一下已经安装好的 Istio 插件。
|
||||
|
||||
如果你使用 Cloud Shell 而不是已经安装好的 `gcloud` 客户端，你可以使用 [Web Preview](https://cloud.google.com/shell/docs/using-web-preview#previewing_the_application) 功能来进行端口转发和代理。比如，你要用 Cloud Shell 访问 Grafana，那你需要把 kubectl 的端口映射从 3000:3000 改成 8080:3000。你可以通过 Web Preview 代理的 8080 到 8084 这些端口，同时预览其他4个控制台。
|
||||
|
||||
### Grafana
|
||||
|
||||
建立一个 Grafana 通道：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=grafana -o jsonpath='{.items[0].metadata.name}') 3000:3000 &
|
||||
{{< /text >}}
|
||||
|
||||
然后访问
|
||||
|
||||
{{< text plain >}}
|
||||
http://localhost:3000/dashboard/db/istio-dashboard
|
||||
{{< /text >}}
|
||||
|
||||
你应该可以看到一些你之前发送的请求的统计信息。
|
||||
|
||||
{{< image width="100%" ratio="48.49%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_grafana.png"
|
||||
caption="Grafana"
|
||||
>}}
|
||||
|
||||
更多关于 Grafana 插件的细节，请点击[关于 Grafana 插件](/docs/tasks/telemetry/using-istio-dashboard/#about-the-grafana-add-on)。
|
||||
|
||||
### Prometheus
|
||||
|
||||
Prometheus 是和 Grafana 一起安装好的。你可以使用控制台查看如下的 Istio 和应用指标：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=prometheus -o jsonpath='{.items[0].metadata.name}') 9090:9090 &
|
||||
{{< /text >}}
|
||||
|
||||
在下面地址可以查看控制台：
|
||||
|
||||
{{< text plain >}}
|
||||
http://localhost:9090/graph
|
||||
{{< /text >}}
|
||||
|
||||
{{< image width="100%" ratio="43.88%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_prometheus.png"
|
||||
caption="Prometheus"
|
||||
>}}
|
||||
|
||||
更多关于 Prometheus 插件的细节，请点击[关于 Prometheus 插件](/docs/tasks/telemetry/querying-metrics/#about-the-prometheus-add-on)。
|
||||
|
||||
### ServiceGraph
|
||||
|
||||
建立一个 ServiceGraph 通道：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=servicegraph -o jsonpath='{.items[0].metadata.name}') 8088:8088 &
|
||||
{{< /text >}}
|
||||
|
||||
你可以在下面的地址查看 Bookinfo 服务拓扑
|
||||
|
||||
{{< text plain >}}
|
||||
http://localhost:8088/dotviz
|
||||
{{< /text >}}
|
||||
|
||||
{{< image width="100%" ratio="53.33%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm_servicegraph.png"
|
||||
caption="ServiceGraph"
|
||||
>}}
|
||||
|
||||
更多关于 ServiceGraph 插件的细节，请点击[关于 ServiceGraph 插件](/docs/tasks/telemetry/servicegraph/#about-the-servicegraph-add-on)。
|
||||
|
||||
## 追踪
|
||||
|
||||
建立一个 Zipkin 通道：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl port-forward -n istio-system $(kubectl get pod -n istio-system -l app=jaeger -o jsonpath='{.items[0].metadata.name}') 16686:16686 &
|
||||
{{< /text >}}
|
||||
|
||||
你就可以在 [http://localhost:16686](http://localhost:16686) 查看之前的追踪统计信息
|
||||
|
||||
{{< image width="100%" ratio="42.35%"
|
||||
link="/docs/setup/kubernetes/quick-start-gke-dm/dm-tracing.png"
|
||||
caption="Tracing Dashboard"
|
||||
>}}
|
||||
|
||||
更多关于追踪的细节，请点击[了解一下发生了什么](/docs/tasks/telemetry/distributed-tracing/#understanding-what-happened)。
|
||||
|
||||
## 卸载
|
||||
|
||||
1. 在 [https://console.cloud.google.com/deployments](https://console.cloud.google.com/deployments) 找到 Cloud Console 的 Deployments 章节
|
||||
|
||||
1. 选择 deployment 并点击 **Delete**.
|
||||
|
||||
1. Deployment Manager 将会删除所有已经部署的 GKE 组件。但是，有一些元素会被保留，比如 Ingress 和 LoadBalancers。你可以通过再次进入 cloud console 的 [**Network Services** -> **LoadBalancers**](https://console.cloud.google.com/net-services/loadbalancing/loadBalancers/list) 来删除这些组件。
|
||||
Loading…
Reference in New Issue