快速开始

前置条件

下面的操作说明需要您可以访问 kubernetes 1.7.3 后更高版本 的集群,并且启用了 RBAC (基于角色的访问控制)。您需要安装了 1.7.3 或更高版本kubectl 命令。如果您希望启用 自动注入 sidecar,您需要启用 kubernetes 集群的 alpha 功能。

注意:如果您安装了 Istio 0.1.x,在安装新版本前请先 卸载 它们(包括已启用 Istio 应用程序 Pod 中的 sidecar)。

  • 安装或更新 kubernetes 命令行工具 kubectl 以匹配集群的版本 (1.7 或者更高,支持CRD功能)

  • 取决于您的 kubernetes 提供商:

    • 本地安装 Istio,安装最新版本的 Minikube (version 0.22.1 或者更高)。

    • Google Container Engine

      • 使用 kubectl 获取证书 (使用您自己的集群的名字替换 <cluster-name> ,使用集群实际所在的位置替换 <zone> ):

        1. gcloud container clusters get-credentials <cluster-name> --zone <zone> --project <project-name>
      • 将集群管理员权限授予当前用户(需要管理员权限才能为Istio创建必要的RBAC规则):

        1. kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
    • IBM Bluemix Container Service

      • 使用 kubectl 获取证书 (使用您自己的集群的名字替换 <cluster-name> ):
        1. $(bx cs cluster-config <cluster-name>|grep "export KUBECONFIG")
    • IBM Cloud Private 版本 2.1 或者更高:

      • 配置kubectl用以访问基于IBM Cloud的私有集群的步骤可以参考 这里
    • Openshift Origin 3.7 或者以上版本:

      • 默认情况下,Openshift 不允许以 UID 0运行容器。为 Istio 的入口(ingress)以及附加组件Prometheus 和 Grafana 的 service account 启用使用UID 0运行的容器:

        1. oc adm policy add-scc-to-user anyuid -z istio-ingress-service-account -n istio-system
        2. oc adm policy add-scc-to-user anyuid -z istio-grafana-service-account -n istio-system
        3. oc adm policy add-scc-to-user anyuid -z istio-prometheus-service-account -n istio-system
      • 运行应用程序 Pod 的 service account 需要特权安全性上下文限制,以此作为 sidecar 注入的一部分:

        1. oc adm policy add-scc-to-user privileged -z default -n <target-namespace>

安装步骤

从 0.2 版本开始,Istio 安装到 istio-system namespace 下,即可以管理所有其它 namespace 下的微服务。

  1. Istio release 页面上,根据您的操作系统下载对应的发行版。如果您使用的是 MacOS 或者 Linux 系统,可以使用下面的额命令自动下载和解压最新的发行版:

    1. curl -L https://git.io/getLatestIstio | sh -
  2. 解压安装文件,切换到文件所在目录。安装文件目录下包含:

    • install/ 目录下是 kubernetes 使用的 .yaml 安装文件
    • samples/ 目录下是示例程序
    • istioctl 客户端二进制文件在 bin 目录下。istioctl 文件用户手动注入 Envoy sidecar 代理、创建路由和策略等。
    • istio.VERSION 配置文件
  3. 切换到 istio 包的解压目录。例如 istio-0.4.0:

    1. cd istio-0.4.0
  4. istioctl 客户端二进制文件加到 PATH 中。

    例如,在 MacOS 或 Linux 系统上执行下面的命令:

    1. export PATH=$PWD/bin:$PATH
  5. 安装 Istio 的核心部分。选择面两个 互斥 选项中的之一:

    a) 安装 Istio 的时候不启用 sidecar 之间的 TLS 双向认证

    为具有现在应用程序的集群选择该选项,使用 Istio sidecar 的服务需要能够与非 Istio Kubernetes 服务以及使用 liveliness 和 readiness 探针、headless service 和 StatefulSet 的应用程序通信。

    1. kubectl apply -f install/kubernetes/istio.yaml

    或者

    b) 安装 Istio 的时候启用 sidecar 之间的 TLS 双向认证

    1. kubectl apply -f install/kubernetes/istio-auth.yaml

    这两个选项都会创建 istio-system 命名空间以及所需的 RBAC 权限,并部署 Istio-Pilot、Istio-Mixer、Istio-Ingress、Istio-Egress 和 Istio-CA(证书颁发机构)。

    1. 可选的:如果您的 kubernetes 集群开启了 alpha 功能,并想要启用 自动注入 sidecar,需要安装 Istio-Initializer:
    1. kubectl apply -f install/kubernetes/istio-initializer.yaml

验证安装

  1. 确认系列 kubernetes 服务已经部署了: istio-pilotistio-mixeristio-ingress

    1. kubectl get svc -n istio-system
    1. NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
    2. istio-ingress 10.83.245.171 35.184.245.62 80:32730/TCP,443:30574/TCP 5h
    3. istio-pilot 10.83.251.173 <none> 8080/TCP,8081/TCP 5h
    4. istio-mixer 10.83.244.253 <none> 9091/TCP,9094/TCP,42422/TCP 5h

    注意:如果您运行的集群不支持外部负载均衡器(如 minikube), istio-ingress 服务的 EXTERNAL-IP 显示 <pending>。你必须改为使用 NodePort service 或者 端口转发方式来访问应用程序。

  2. 确认对应的 Kubernetes pod 已部署并且所有的容器都启动并运行:
    istio-pilot-*istio-mixer-*istio-ingress-*istio-ca-*istio-initializer-* 是可以选的。

    1. kubectl get pods -n istio-system
    1. istio-ca-3657790228-j21b9 1/1 Running 0 5h
    2. istio-ingress-1842462111-j3vcs 1/1 Running 0 5h
    3. istio-initializer-184129454-zdgf5 1/1 Running 0 5h
    4. istio-pilot-2275554717-93c43 1/1 Running 0 5h
    5. istio-mixer-2104784889-20rm8 2/2 Running 0 5h

部署应用

您可以部署自己的应用或者示例应用程序如 BookInfo
注意:应用程序必须使用 HTTP/1.1 或 HTTP/2.0 协议来传递 HTTP 流量,因为 HTTP/1.0 已经不再支持。

如果您启动了 Istio-Initializer,如上所示,您可以使用 kubectl create 直接部署应用。Istio-Initializer 会向应用程序的 pod 中自动注入 Envoy 容器:

  1. kubectl create -f <your-app-spec>.yaml

如果您没有安装 Istio-initializer 的话,您必须使用 istioctl kube-inject 命令在部署应用之前向应用程序的 pod 中手动注入 Envoy 容器:

  1. kubectl create -f <(istioctl kube-inject -f <your-app-spec>.yaml)

卸载

  • 卸载 Istio initializer:

    如果您安装 Isto 的时候启用了 initializer,请卸载它:

    1. kubectl delete -f install/kubernetes/istio-initializer.yaml
  • 卸载 Istio 核心组件。对于 Istio 0.4.0 版本,删除 RBAC 权限,istio-system namespace,和该命名空间的下的各层级资源。

    不必理会在层级删除过程中的各种报错,因为这些资源可能已经被删除的。

    a) 如果您在安装 Istio 的时候关闭了 TLS 双向认证:

    1. kubectl delete -f install/kubernetes/istio.yaml

    或者

    b) 如果您在安装 Istio 的时候启用了 TLS 双向认证:

    1. kubectl delete -f install/kubernetes/istio-auth.yaml

下一步