无需 Gateway API 开始使用

本指南可让您仅使用其旧版 API 快速评估 Istio。如果您想使用 Kubernetes Gateway API， 请参阅该示例。如果您已经熟悉了 Istio 或想要安装其他配置文件或高级的部署模型， 请参阅 FAQ 页面：我应该使用哪种 Istio 安装方法？。

这些步骤需要您有一个运行 Kubernetes (1.27, 1.28, 1.29, 1.30) 所支持版本的 cluster。您可以使用任意受支持的平台，例如 Minikube 或特定平台安装说明中指定的其他平台。

遵循以下步骤开始使用 Istio：

  1. 下载并安装 Istio
  2. 部署样例应用
  3. 打开应用程序并允许外部流量
  4. 查看仪表板

下载 Istio

  1. 转到 Istio 发布页面下载适合您操作系统的安装文件， 或下载并自动解压最新的版本（Linux 或 macOS）：

    1. $ curl -L https://istio.io/downloadIstio | sh -

    上述命令将下载 Istio 的最新版本（按数字顺序）。 您可以通过命令行传递变量，下载特定的版本或重载处理器架构。 例如要下载 x86_64 架构的 Istio 1.23.3，执行以下命令：

    1. $ curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.23.3 TARGET_ARCH=x86_64 sh -

  2. 切换到 Istio 文件包目录。例如，如果文件包是 istio-1.23.3：

    1. $ cd istio-1.23.3

    安装目录包含：

    • 位于 samples/ 中的样例应用
    • 位于 bin/ 目录中的 istioctl 客户端二进制文件。

  3. 添加 istioctl 客户端到您的路径（Linux 或 macOS）：

    1. $ export PATH=$PWD/bin:$PATH

安装 Istio

  1. 本次安装使用 demo 配置文件。 这个配置文件包含了便于测试的一组默认值，当然您可以使用其他配置文件用于生产或性能测试。

    如果您的平台有特定于供应商（例如 Openshift）的配置文件， 可以在以下命令中直接使用而不是采用 demo 配置文件。 更多细节请参阅平台指示说明。

    1. $ istioctl install --set profile=demo -y
    2. ✔ Istio core installed
    3. ✔ Istiod installed
    4. ✔ Egress gateways installed
    5. ✔ Ingress gateways installed
    6. ✔ Installation complete

  2. 添加命名空间标签，指示 Istio 在您稍后部署应用时自动注入 Envoy Sidecar 代理：

    1. $ kubectl label namespace default istio-injection=enabled
    2. namespace/default labeled

部署样例应用

  1. 部署 Bookinfo 示例应用：

    Zip

    1. $ kubectl apply -f @samples/bookinfo/platform/kube/bookinfo.yaml@
    2. service/details created
    3. serviceaccount/bookinfo-details created
    4. deployment.apps/details-v1 created
    5. service/ratings created
    6. serviceaccount/bookinfo-ratings created
    7. deployment.apps/ratings-v1 created
    8. service/reviews created
    9. serviceaccount/bookinfo-reviews created
    10. deployment.apps/reviews-v1 created
    11. deployment.apps/reviews-v2 created
    12. deployment.apps/reviews-v3 created
    13. service/productpage created
    14. serviceaccount/bookinfo-productpage created
    15. deployment.apps/productpage-v1 created

  2. 此应用将启动。随着每个 Pod 就绪，Istio Sidecar 将随之被部署。

    1. $ kubectl get services
    2. NAME          TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
    3. details       ClusterIP   10.0.0.212      <none>        9080/TCP   29s
    4. kubernetes    ClusterIP   10.0.0.1        <none>        443/TCP    25m
    5. productpage   ClusterIP   10.0.0.57       <none>        9080/TCP   28s
    6. ratings       ClusterIP   10.0.0.33       <none>        9080/TCP   29s
    7. reviews       ClusterIP   10.0.0.28       <none>        9080/TCP   29s

    还有

    1. $ kubectl get pods
    2. NAME                              READY   STATUS    RESTARTS   AGE
    3. details-v1-558b8b4b76-2llld       2/2     Running   0          2m41s
    4. productpage-v1-6987489c74-lpkgl   2/2     Running   0          2m40s
    5. ratings-v1-7dc98c7588-vzftc       2/2     Running   0          2m41s
    6. reviews-v1-7f99cc4496-gdxfn       2/2     Running   0          2m41s
    7. reviews-v2-7d79d5bd5d-8zzqd       2/2     Running   0          2m41s
    8. reviews-v3-7dbcdcbc56-m8dph       2/2     Running   0          2m41s

    再次运行上一条命令，等到所有 Pod 报告 READY 2/2 且 STATUS 为 Running， 然后转到下一步。这可能要用几分钟时间，具体时间取决于您的平台。

  3. 确认到此为止一切运行良好。执行以下命令通过检查响应中的页面标题查看应用是否在集群内运行且正在提供 HTML 页面：

    1. $ kubectl exec "$(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}')" -c ratings -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"
    2. <title>Simple Bookstore App</title>

打开应用并允许对外流量

Bookinfo 应用已被部署但还不能从外部进行访问。 要使其能够被访问，您需要创建 Istio Ingress Gateway， 将路径映射到网格边缘处的某个路由。

  1. 将此应用程序与 Istio Gateway 关联：

    Zip

    1. $ kubectl apply -f @samples/bookinfo/networking/bookinfo-gateway.yaml@
    2. gateway.networking.istio.io/bookinfo-gateway created
    3. virtualservice.networking.istio.io/bookinfo created

  2. 确保配置没有问题：

    1. $ istioctl analyze
    2. ✔ No validation issues found when analyzing namespace: default.

确定 Ingress IP 和端口

按照以下说明设置用于访问网关的 INGRESS_HOST 和 INGRESS_PORT 变量。 使用选项卡选择适用于您所选平台的说明：

在新的终端窗口中运行此命令以启动将流量发送到 Istio Ingress Gateway 的 Minikube 隧道。 这将为 service/istio-ingressgateway 提供外部负载均衡器及 EXTERNAL-IP。

  1. $ minikube tunnel

设置 Ingress 主机和端口：

  1. $ export INGRESS_HOST=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  2. $ export INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="http2")].port}')
  3. $ export SECURE_INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')

确保已成功为每个环境变量分配 IP 地址和端口：

  1. $ echo "$INGRESS_HOST"
  2. 127.0.0.1
  1. $ echo "$INGRESS_PORT"
  2. 80
  1. $ echo "$SECURE_INGRESS_PORT"
  2. 443

执行以下命令来确定您的 Kubernetes 集群是否在支持外部负载均衡器的环境中运行：

  1. $ kubectl get svc istio-ingressgateway -n istio-system
  2. NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                                      AGE
  3. istio-ingressgateway   LoadBalancer   172.21.109.129   130.211.10.121  80:31380/TCP,443:31390/TCP,31400:31400/TCP   17h

如果设置了 EXTERNAL-IP 值，则表示您的环境具有可用于 Ingress Gateway 的外部负载均衡器。 如果 EXTERNAL-IP 值为 <none>（或始终为 <pending>）， 则表示您的环境不能为 Ingress Gateway 提供外部负载均衡器。在这种情况下， 您可以使用服务的节点端口访问网关。

选择适合您环境的说明：

如果您确定您的环境具有外部负载均衡器，请按照这些说明进行操作。

设置 Ingress IP 和端口：

  1. $ export INGRESS_HOST=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  2. $ export INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="http2")].port}')
  3. $ export SECURE_INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')

在某些环境中，负载均衡器可能使用主机名而不是 IP 地址来公开。在这种情况下， Ingress Gateway 的 EXTERNAL-IP 值将不是 IP 地址，而是主机名， 并且上述命令将无法设置 INGRESS_HOST 环境变量。使用以下命令更正 INGRESS_HOST 值：

  1. $ export INGRESS_HOST=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')

如果您的环境没有外部负载均衡器，请按照这些说明操作并选择节点端口。

设置 Ingress 端口：

  1. $ export INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="http2")].nodePort}')
  2. $ export SECURE_INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].nodePort}')

GKE：

  1. $ export INGRESS_HOST=worker-node-address

您需要创建防火墙规则以允许 TCP 流量进入 ingressgateway 服务的端口。 运行以下命令以允许 HTTP 端口、安全端口（HTTPS）或两者的流量：

  1. $ gcloud compute firewall-rules create allow-gateway-http --allow "tcp:$INGRESS_PORT"
  2. $ gcloud compute firewall-rules create allow-gateway-https --allow "tcp:$SECURE_INGRESS_PORT"

IBM Cloud Kubernetes Service：

  1. $ ibmcloud ks workers --cluster cluster-name-or-id
  2. $ export INGRESS_HOST=public-IP-of-one-of-the-worker-nodes

Docker For Desktop：

  1. $ export INGRESS_HOST=127.0.0.1

其他环境：

  1. $ export INGRESS_HOST=$(kubectl get po -l istio=ingressgateway -n istio-system -o jsonpath='{.items[0].status.hostIP}')

  1. 设置 GATEWAY_URL:

    1. $ export GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT

  2. 确保 IP 地址和端口均被成功分配给了环境变量：

    1. $ echo "$GATEWAY_URL"
    2. 127.0.0.1:80

验证外部访问

通过浏览器查看 Bookinfo 产品页面，确认可以访问 Bookinfo 应用。

  1. 执行以下命令检索 Bookinfo 应用的对外地址。

    1. $ echo "http://$GATEWAY_URL/productpage"

  2. 将上一条命令的输出粘贴到您的 Web 浏览器中，确认 Bookinfo 产品页面显示正常。

查看仪表板

Istio 集成了几种不同的遥测应用。 这些可以帮助您了解服务网格的结构，能够显示网格的拓扑，还能分析网格的健康状况。

参阅以下指示说明部署 Kiali 仪表板， 以及 Prometheus、 Grafana 和 Jaeger。

  1. 安装 Kiali 和其他插件并等待其完成部署。

    1. $ kubectl apply -f samples/addons
    2. $ kubectl rollout status deployment/kiali -n istio-system
    3. Waiting for deployment "kiali" rollout to finish: 0 of 1 updated replicas are available...
    4. deployment "kiali" successfully rolled out

    如果尝试安装插件时报错，请重新运行命令。 因为再次执行命令可以解决一些时序问题。

  2. 访问 Kiali 仪表板。

    1. $ istioctl dashboard kiali

  3. 在左侧导航菜单中，从 Namespace 下拉菜单中选择 Graph，选择 default。

    要查看追踪数据，必须向服务发送请求。请求的数量取决于 Istio 的采样率。 采样率在安装 Istio 时设置，默认采样速率为 1%。在第一个跟踪可见之前，您需要发送至少 100 个请求。 使用以下命令向 productpage 服务发送 100 个请求：

    1. $ for i in $(seq 1 100); do curl -s -o /dev/null "http://$GATEWAY_URL/productpage"; done

    Kiali 仪表板显示了网格的概述以及 Bookinfo 样例应用中服务之间的关系。 Kiali 还能过滤显示流量。

    Kiali Dashboard
    Kiali Dashboard

下一步

恭喜完成了评估安装！

以下任务便于初学者使用这个 demo 安装进一步评估 Istio 的功能特性：

自定义 Istio 用于生产之前，请参阅以下资源：

加入 Istio 社区

欢迎您加入 Istio 社区提问和给出反馈。

卸载

要删除 Bookinfo 样例应用及其配置，请参阅 Bookinfo 清理。

卸载 Istio 时将删除 RBAC 权限和 istio-system 命名空间下的所有资源层次结构。 可以安全地忽略不存在资源的错误，因为它们可能已经被按层次结构删除了。

Zip

  1. $ kubectl delete -f @samples/addons@
  2. $ istioctl uninstall -y --purge

istio-system 命名空间默认未被移除。如果不再需要，请执行以下命令将其移除：

  1. $ kubectl delete namespace istio-system

指示 Istio 自动注入 Envoy Sidecar 代理的标签默认未被移除。 如果不再需要，执行以下命令将其移除：

  1. $ kubectl label namespace default istio-injection-