Istio 中的 Sidecar 注入与流量劫持详解

在讲解 Istio 如何将 Envoy 代理注入到应用程序 Pod 中之前,我们需要先了解以下几个概念:

  • Sidecar 模式:容器应用模式之一,Service Mesh 架构的一种实现方式。
  • Init 容器:Pod 中的一种专用的容器,在应用程序容器启动之前运行,用来包含一些应用镜像中不存在的实用工具或安装脚本。
  • iptables:流量劫持是通过 iptables 转发实现的。

Init 容器

Init 容器是一种专用容器,它在应用程序容器启动之前运行,用来包含一些应用镜像中不存在的实用工具或安装脚本。

一个 Pod 中可以指定多个 Init 容器,如果指定了多个,那么 Init 容器将会按顺序依次运行。只有当前面的 Init 容器必须运行成功后,才可以运行下一个 Init 容器。当所有的 Init 容器运行完成后,Kubernetes 才初始化 Pod 和运行应用容器。

Init 容器使用 Linux Namespace,所以相对应用程序容器来说具有不同的文件系统视图。因此,它们能够具有访问 Secret 的权限,而应用程序容器则不能。

在 Pod 启动过程中,Init 容器会按顺序在网络和数据卷初始化之后启动。每个容器必须在下一个容器启动之前成功退出。如果由于运行时或失败退出,将导致容器启动失败,它会根据 Pod 的 restartPolicy 指定的策略进行重试。然而,如果 Pod 的 restartPolicy 设置为 Always,Init 容器失败时会使用 RestartPolicy 策略。

在所有的 Init 容器没有成功之前,Pod 将不会变成 Ready 状态。Init 容器的端口将不会在 Service 中进行聚集。 正在初始化中的 Pod 处于 Pending 状态,但应该会将 Initializing 状态设置为 true。Init 容器运行完成以后就会自动终止。

关于 Init 容器的详细信息请参考 Init 容器 - Kubernetes 中文指南/云原生应用架构实践手册

Sidecar 注入示例分析

我们看下 Istio 官方示例 bookinfoproductpage 的 YAML 配置,关于 bookinfo 应用的详细 YAML 配置请参考 bookinfo.yaml

  1. apiVersion: v1
  2. kind: Service
  3. metadata:
  4. name: productpage
  5. labels:
  6. app: productpage
  7. spec:
  8. ports:
  9. - port: 9080
  10. name: http
  11. selector:
  12. app: productpage
  13. ---
  14. apiVersion: extensions/v1beta1
  15. kind: Deployment
  16. metadata:
  17. name: productpage-v1
  18. spec:
  19. replicas: 1
  20. template:
  21. metadata:
  22. labels:
  23. app: productpage
  24. version: v1
  25. spec:
  26. containers:
  27. - name: productpage
  28. image: istio/examples-bookinfo-productpage-v1:1.8.0
  29. imagePullPolicy: IfNotPresent
  30. ports:
  31. - containerPort: 9080

再查看下 productpage 容器的 Dockerfile

  1. FROM python:2.7-slim
  2. COPY requirements.txt ./
  3. RUN pip install --no-cache-dir -r requirements.txt
  4. COPY productpage.py /opt/microservices/
  5. COPY templates /opt/microservices/templates
  6. COPY requirements.txt /opt/microservices/
  7. EXPOSE 9080
  8. WORKDIR /opt/microservices
  9. CMD python productpage.py 9080

我们看到 Dockerfile 中没有配置 ENTRYPOINT,所以 CMD 的配置 python productpage.py 9080 将作为默认的 ENTRYPOINT,记住这一点,再看下注入 sidecar 之后的配置。

  1. $ istioctl kube-inject -f yaml/istio-bookinfo/bookinfo.yaml

我们只截取其中与 productpage 相关的 ServiceDeployment 配置部分。

  1. apiVersion: v1
  2. kind: Service
  3. metadata:
  4. name: productpage
  5. labels:
  6. app: productpage
  7. spec:
  8. ports:
  9. - port: 9080
  10. name: http
  11. selector:
  12. app: productpage
  13. ---
  14. apiVersion: extensions/v1beta1
  15. kind: Deployment
  16. metadata:
  17. creationTimestamp: null
  18. name: productpage-v1
  19. spec:
  20. replicas: 1
  21. strategy: {}
  22. template:
  23. metadata:
  24. annotations:
  25. sidecar.istio.io/status: '{"version":"fde14299e2ae804b95be08e0f2d171d466f47983391c00519bbf01392d9ad6bb","initContainers":["istio-init"],"containers":["istio-proxy"],"volumes":["istio-envoy","istio-certs"],"imagePullSecrets":null}'
  26. creationTimestamp: null
  27. labels:
  28. app: productpage
  29. version: v1
  30. spec:
  31. containers:
  32. - image: istio/examples-bookinfo-productpage-v1:1.8.0
  33. imagePullPolicy: IfNotPresent
  34. name: productpage
  35. ports:
  36. - containerPort: 9080
  37. resources: {}
  38. - args:
  39. - proxy
  40. - sidecar
  41. - --configPath
  42. - /etc/istio/proxy
  43. - --binaryPath
  44. - /usr/local/bin/envoy
  45. - --serviceCluster
  46. - productpage
  47. - --drainDuration
  48. - 45s
  49. - --parentShutdownDuration
  50. - 1m0s
  51. - --discoveryAddress
  52. - istio-pilot.istio-system:15007
  53. - --discoveryRefreshDelay
  54. - 1s
  55. - --zipkinAddress
  56. - zipkin.istio-system:9411
  57. - --connectTimeout
  58. - 10s
  59. - --statsdUdpAddress
  60. - istio-statsd-prom-bridge.istio-system:9125
  61. - --proxyAdminPort
  62. - "15000"
  63. - --controlPlaneAuthPolicy
  64. - NONE
  65. env:
  66. - name: POD_NAME
  67. valueFrom:
  68. fieldRef:
  69. fieldPath: metadata.name
  70. - name: POD_NAMESPACE
  71. valueFrom:
  72. fieldRef:
  73. fieldPath: metadata.namespace
  74. - name: INSTANCE_IP
  75. valueFrom:
  76. fieldRef:
  77. fieldPath: status.podIP
  78. - name: ISTIO_META_POD_NAME
  79. valueFrom:
  80. fieldRef:
  81. fieldPath: metadata.name
  82. - name: ISTIO_META_INTERCEPTION_MODE
  83. value: REDIRECT
  84. image: jimmysong/istio-release-proxyv2:1.0.0
  85. imagePullPolicy: IfNotPresent
  86. name: istio-proxy
  87. resources:
  88. requests:
  89. cpu: 10m
  90. securityContext:
  91. privileged: false
  92. readOnlyRootFilesystem: true
  93. runAsUser: 1337
  94. volumeMounts:
  95. - mountPath: /etc/istio/proxy
  96. name: istio-envoy
  97. - mountPath: /etc/certs/
  98. name: istio-certs
  99. readOnly: true
  100. initContainers:
  101. - args:
  102. - -p
  103. - "15001"
  104. - -u
  105. - "1337"
  106. - -m
  107. - REDIRECT
  108. - -i
  109. - '*'
  110. - -x
  111. - ""
  112. - -b
  113. - 9080,
  114. - -d
  115. - ""
  116. image: jimmysong/istio-release-proxy_init:1.0.0
  117. imagePullPolicy: IfNotPresent
  118. name: istio-init
  119. resources: {}
  120. securityContext:
  121. capabilities:
  122. add:
  123. - NET_ADMIN
  124. privileged: true
  125. volumes:
  126. - emptyDir:
  127. medium: Memory
  128. name: istio-envoy
  129. - name: istio-certs
  130. secret:
  131. optional: true
  132. secretName: istio.default
  133. status: {}

我们看到 Service 的配置没有变化,所有的变化都在 Deployment 里,Istio 给应用 Pod 注入的配置主要包括:

  • Init 容器 istio-init:用于给 Sidecar 容器即 Envoy 代理做初始化,设置 iptables 端口转发
  • Envoy sidecar 容器 istio-proxy:运行 Envoy 代理

接下来将分别解析下这两个容器。

Init 容器解析

Istio 在 Pod 中注入的 Init 容器名为 istio-init,我们在上面 Istio 注入完成后的 YAML 文件中看到了该容器的启动参数:

  1. -p 15001 -u 1337 -m REDIRECT -i '*' -x "" -b 9080 -d ""

我们再检查下该容器的 Dockerfile 看看 ENTRYPOINT 是什么以确定启动时执行的命令。

  1. FROM ubuntu:xenial
  2. RUN apt-get update && apt-get install -y \
  3. iproute2 \
  4. iptables \
  5. && rm -rf /var/lib/apt/lists/*
  6. ADD istio-iptables.sh /usr/local/bin/
  7. ENTRYPOINT ["/usr/local/bin/istio-iptables.sh"]

我们看到 istio-init 容器的入口是 /usr/local/bin/istio-iptables.sh 脚本,再按图索骥看看这个脚本里到底写的什么,该脚本的位置在 Istio 源码仓库的 tools/deb/istio-iptables.sh,一共 300 多行,就不贴在这里了。下面我们就来解析下这个启动脚本。

Init 容器启动入口

Init 容器的启动入口是 /usr/local/bin/istio-iptables.sh 脚本,该脚本的用法如下:

  1. $ istio-iptables.sh -p PORT -u UID -g GID [-m mode] [-b ports] [-d ports] [-i CIDR] [-x CIDR] [-h]
  2. -p: 指定重定向所有 TCP 流量的 Envoy 端口(默认为 $ENVOY_PORT = 15001
  3. -u: 指定未应用重定向的用户的 UID。通常,这是代理容器的 UID(默认为 $ENVOY_USER uidistio_proxy uid 1337
  4. -g: 指定未应用重定向的用户的 GID。(与 -u param 相同的默认值)
  5. -m: 指定入站连接重定向到 Envoy 的模式,“REDIRECT TPROXY”(默认为 $ISTIO_INBOUND_INTERCEPTION_MODE)
  6. -b: 逗号分隔的入站端口列表,其流量将重定向到 Envoy(可选)。使用通配符 “*” 表示重定向所有端口。为空时表示禁用所有入站重定向(默认为 $ISTIO_INBOUND_PORTS
  7. -d: 指定要从重定向到 Envoy 中排除(可选)的入站端口列表,以逗号格式分隔。使用通配符“*” 表示重定向所有入站流量(默认为 $ISTIO_LOCAL_EXCLUDE_PORTS
  8. -i: 指定重定向到 Envoy(可选)的 IP 地址范围,以逗号分隔的 CIDR 格式列表。使用通配符 “*” 表示重定向所有出站流量。空列表将禁用所有出站重定向(默认为 $ISTIO_SERVICE_CIDR
  9. -x: 指定将从重定向中排除的 IP 地址范围,以逗号分隔的 CIDR 格式列表。使用通配符 “*” 表示重定向所有出站流量(默认为 $ISTIO_SERVICE_EXCLUDE_CIDR)。
  10. 环境变量位于 $ISTIO_SIDECAR_CONFIG(默认在:/var/lib/istio/envoy/sidecar.env

通过查看该脚本你将看到,以上传入的参数都会重新组装成 iptables 命令的参数。

再参考 istio-init 容器的启动参数,完整的启动命令如下:

  1. $ /usr/local/bin/istio-iptables.sh -p 15001 -u 1337 -m REDIRECT -i '*' -x "" -b 9080 -d ""

该容器存在的意义就是让 Envoy 代理可以拦截所有的进出 Pod 的流量,即将入站流量重定向到 Sidecar,再拦截应用容器的出站流量经过 Sidecar 处理后再出站。

命令解析

这条启动命令的作用是:

  • 将应用容器的所有流量都转发到 Envoy 的 15001 端口。
  • 使用 istio-proxy 用户身份运行, UID 为 1337,即 Envoy 所处的用户空间,这也是 istio-proxy 容器默认使用的用户,见 YAML 配置中的 runAsUser 字段。
  • 使用默认的 REDIRECT 模式来重定向流量。
  • 将所有出站流量都重定向到 Envoy 代理。
  • 将所有访问 9080 端口(即应用容器 productpage 的端口)的流量重定向到 Envoy 代理。

因为 Init 容器初始化完毕后就会自动终止,因为我们无法登陆到容器中查看 iptables 信息,但是 Init 容器初始化结果会保留到应用容器和 Sidecar 容器中。

istio-proxy 容器解析

为了查看 iptables 配置,我们需要登陆到 Sidecar 容器中使用 root 用户来查看,因为 kubectl 无法使用特权模式来远程操作 docker 容器,所以我们需要登陆到 productpage Pod 所在的主机上使用 docker 命令登陆容器中查看。

查看 productpage Pod 所在的主机。

  1. $ kubectl -n default get pod -l app=productpage -o wide
  2. NAME READY STATUS RESTARTS AGE IP NODE
  3. productpage-v1-745ffc55b7-2l2lw 2/2 Running 0 1d 172.33.78.10 node3

从输出结果中可以看到该 Pod 运行在 node3 上,使用 vagrant 命令登陆到 node3 主机中并切换为 root 用户。

  1. $ vagrant ssh node3
  2. $ sudo -i

查看 iptables 配置,列出 NAT(网络地址转换)表的所有规则,因为在 Init 容器启动的时候选择给 istio-iptables.sh 传递的参数中指定将入站流量重定向到 Envoy 的模式为 “REDIRECT”,因此在 iptables 中将只有 NAT 表的规格配置,如果选择 TPROXY 还会有 mangle 表配置。iptables 命令的详细用法请参考 iptables,规则配置请参考 iptables 规则配置

理解 iptables

iptables 是 Linux 内核中的防火墙软件 netfilter 的管理工具,位于用户空间,同时也是 netfilter 的一部分。Netfilter 位于内核空间,不仅有网络地址转换的功能,也具备数据包内容修改、以及数据包过滤等防火墙功能。

在了解 Init 容器初始化的 iptables 之前,我们先来了解下 iptables 和规则配置。

下图展示了 iptables 调用链。

iptables 调用链

iptables 中的表

Init 容器中使用的的 iptables 版本是 v1.6.0,共包含 5 张表:

  1. raw 用于配置数据包,raw 中的数据包不会被系统跟踪。
  2. filter 是用于存放所有与防火墙相关操作的默认表。
  3. nat 用于 网络地址转换(例如:端口转发)。
  4. mangle 用于对特定数据包的修改(参考损坏数据包)。
  5. security 用于强制访问控制 网络规则。

:在本示例中只用到了 nat 表。

不同的表中的具有的链类型如下表所示:

规则名称 raw filter nat mangle security
PREROUTING
INPUT
OUTPUT
POSTROUTING
FORWARD

下图是 iptables 的调用链顺序。

iptables 调用链

关于 iptables 的详细介绍请参考常见iptables使用规则场景整理

iptables 命令

iptables 命令的主要用途是修改这些表中的规则。iptables 命令格式如下:

  1. $ iptables [-t 表名] 命令选项[链名][条件匹配][-j 目标动作或跳转]

Init 容器中的 /istio-iptables.sh 启动入口脚本就是执行 iptables 初始化的。

理解 iptables 规则

查看 istio-proxy 容器中的默认的 iptables 规则,默认查看的是 filter 表中的规则。

  1. $ iptables -L -v
  2. Chain INPUT (policy ACCEPT 350K packets, 63M bytes)
  3. pkts bytes target prot opt in out source destination
  4. Chain FORWARD (policy ACCEPT 0 packets, 0 bytes)
  5. pkts bytes target prot opt in out source destination
  6. Chain OUTPUT (policy ACCEPT 18M packets, 1916M bytes)
  7. pkts bytes target prot opt in out source destination

我们看到三个默认的链,分别是 INPUT、FORWARD 和 OUTPUT,每个链中的第一行输出表示链名称(在本例中为INPUT/FORWARD/OUTPUT),后跟默认策略(ACCEPT)。

下图是 iptables 的建议结构图,流量在经过 INPUT 链之后就进入了上层协议栈,比如

iptables结构图

图片来自常见iptables使用规则场景整理

每条链中都可以添加多条规则,规则是按照顺序从前到后执行的。我们来看下规则的表头定义。

  • pkts:处理过的匹配的报文数量
  • bytes:累计处理的报文大小(字节数)
  • target:如果报文与规则匹配,指定目标就会被执行。
  • prot:协议,例如 tdpudpicmpall
  • opt:很少使用,这一列用于显示 IP 选项。
  • in:入站网卡。
  • out:出站网卡。
  • source:流量的源 IP 地址或子网,后者是 anywhere
  • destination:流量的目的地 IP 地址或子网,或者是 anywhere

还有一列没有表头,显示在最后,表示规则的选项,作为规则的扩展匹配条件,用来补充前面的几列中的配置。protoptinoutsourcedestination 和显示在 destination 后面的没有表头的一列扩展条件共同组成匹配规则。当流量匹配这些规则后就会执行 target

关于 iptables 规则请参考常见iptables使用规则场景整理

target 支持的类型

target 类型包括 ACCEPTREJECTDROPLOGSNATMASQUERADEDNATREDIRECTRETURN 或者跳转到其他规则等。只要执行到某一条链中只有按照顺序有一条规则匹配后就可以确定报文的去向了,除了 RETURN 类型,类似编程语言中的 return 语句,返回到它的调用点,继续执行下一条规则。target 支持的配置详解请参考 iptables 详解(1):iptables 概念

从输出结果中可以看到 Init 容器没有在 iptables 的默认链路中创建任何规则,而是创建了新的链路。

查看 iptables nat 表中注入的规则

Init 容器通过向 iptables nat 表中注入转发规则来劫持流量的,下图显示的是 productpage 服务中的 iptables 流量劫持的详细过程。

Envoy sidecar 流量劫持流程示意图

Init 容器启动时命令行参数中指定了 REDIRECT 模式,因此只创建了 NAT 表规则,接下来我们查看下 NAT 表中创建的规则,这是全文中的重点部分,前面讲了那么多都是为它做铺垫的。下面是查看 nat 表中的规则,其中链的名字中包含 ISTIO 前缀的是由 Init 容器注入的,规则匹配是根据下面显示的顺序来执行的,其中会有多次跳转。

  1. # 查看 NAT 表中规则配置的详细信息
  2. $ iptables -t nat -L -v
  3. # PREROUTING 链:用于目标地址转换(DNAT),将所有入站 TCP 流量跳转到 ISTIO_INBOUND 链上
  4. Chain PREROUTING (policy ACCEPT 0 packets, 0 bytes)
  5. pkts bytes target prot opt in out source destination
  6. 2 120 ISTIO_INBOUND tcp -- any any anywhere anywhere
  7. # INPUT 链:处理输入数据包,非 TCP 流量将继续 OUTPUT 链
  8. Chain INPUT (policy ACCEPT 2 packets, 120 bytes)
  9. pkts bytes target prot opt in out source destination
  10. # OUTPUT 链:将所有出站数据包跳转到 ISTIO_OUTPUT 链上
  11. Chain OUTPUT (policy ACCEPT 41146 packets, 3845K bytes)
  12. pkts bytes target prot opt in out source destination
  13. 93 5580 ISTIO_OUTPUT tcp -- any any anywhere anywhere
  14. # POSTROUTING 链:所有数据包流出网卡时都要先进入POSTROUTING 链,内核根据数据包目的地判断是否需要转发出去,我们看到此处未做任何处理
  15. Chain POSTROUTING (policy ACCEPT 41199 packets, 3848K bytes)
  16. pkts bytes target prot opt in out source destination
  17. # ISTIO_INBOUND 链:将所有目的地为 9080 端口的入站流量重定向到 ISTIO_IN_REDIRECT 链上
  18. Chain ISTIO_INBOUND (1 references)
  19. pkts bytes target prot opt in out source destination
  20. 2 120 ISTIO_IN_REDIRECT tcp -- any any anywhere anywhere tcp dpt:9080
  21. # ISTIO_IN_REDIRECT 链:将所有的入站流量跳转到本地的 15001 端口,至此成功的拦截了流量到 Envoy
  22. Chain ISTIO_IN_REDIRECT (1 references)
  23. pkts bytes target prot opt in out source destination
  24. 2 120 REDIRECT tcp -- any any anywhere anywhere redir ports 15001
  25. # ISTIO_OUTPUT 链:选择需要重定向到 Envoy(即本地) 的出站流量,所有非 localhost 的流量全部转发到 ISTIO_REDIRECT。为了避免流量在该 Pod 中无限循环,所有到 istio-proxy 用户空间的流量都返回到它的调用点中的下一条规则,本例中即 OUTPUT 链,因为跳出 ISTIO_OUTPUT 规则之后就进入下一条链 POSTROUTING。如果目的地非 localhost 就跳转到 ISTIO_REDIRECT;如果流量是来自 istio-proxy 用户空间的,那么就跳出该链,返回它的调用链继续执行下一条规则(OUPT 的下一条规则,无需对流量进行处理);所有的非 istio-proxy 用户空间的目的地是 localhost 的流量就跳转到 ISTIO_REDIRECT
  26. Chain ISTIO_OUTPUT (1 references)
  27. pkts bytes target prot opt in out source destination
  28. 0 0 ISTIO_REDIRECT all -- any lo anywhere !localhost
  29. 40 2400 RETURN all -- any any anywhere anywhere owner UID match istio-proxy
  30. 0 0 RETURN all -- any any anywhere anywhere owner GID match istio-proxy
  31. 0 0 RETURN all -- any any anywhere localhost
  32. 53 3180 ISTIO_REDIRECT all -- any any anywhere anywhere
  33. # ISTIO_REDIRECT 链:将所有流量重定向到 Envoy(即本地) 的 15001 端口
  34. Chain ISTIO_REDIRECT (2 references)
  35. pkts bytes target prot opt in out source destination
  36. 53 3180 REDIRECT tcp -- any any anywhere anywhere redir ports 15001

iptables 显示的链的顺序,即流量规则匹配的顺序。其中要特别注意 ISTIO_OUTPUT 链中的规则配置。为了避免流量一直在 Pod 中无限循环,所有到 istio-proxy 用户空间的流量都返回到它的调用点中的下一条规则,本例中即 OUTPUT 链,因为跳出 ISTIO_OUTPUT 规则之后就进入下一条链 POSTROUTING

ISTIO_OUTPUT 链规则匹配的详细过程如下:

  • 如果目的地非 localhost 就跳转到 ISTIO_REDIRECT 链
  • 所有来自 istio-proxy 用户空间的非 localhost 流量跳转到它的调用点 OUTPUT 继续执行 OUTPUT 链的下一条规则,因为 OUTPUT 链中没有下一条规则了,所以会继续执行 POSTROUTING 链然后跳出 iptables,直接访问目的地
  • 如果流量不是来自 istio-proxy 用户空间,又是对 localhost 的访问,那么就跳出 iptables,直接访问目的地
  • 其它所有情况都跳转到 ISTIO_REDIRECT

其实在最后这条规则前还可以增加 IP 地址过滤,让某些 IP 地址段不通过 Envoy 代理。

istio sidecar iptables 注入

以上 iptables 规则都是 Init 容器启动的时使用 istio-iptables.sh 脚本生成的,详细过程可以查看该脚本。

查看 Envoy 运行状态

首先查看 proxyv2 镜像的 Dockerfile

  1. FROM istionightly/base_debug
  2. ARG proxy_version
  3. ARG istio_version
  4. # 安装 Envoy
  5. ADD envoy /usr/local/bin/envoy
  6. # 使用环境变量的方式明文指定 proxy 的版本/功能
  7. ENV ISTIO_META_ISTIO_PROXY_VERSION "1.1.0"
  8. # 使用环境变量的方式明文指定 proxy 明确的 sha,用于指定版本的配置和调试
  9. ENV ISTIO_META_ISTIO_PROXY_SHA $proxy_version
  10. # 环境变量,指定明确的构建号,用于调试
  11. ENV ISTIO_META_ISTIO_VERSION $istio_version
  12. ADD pilot-agent /usr/local/bin/pilot-agent
  13. ADD envoy_pilot.yaml.tmpl /etc/istio/proxy/envoy_pilot.yaml.tmpl
  14. ADD envoy_policy.yaml.tmpl /etc/istio/proxy/envoy_policy.yaml.tmpl
  15. ADD envoy_telemetry.yaml.tmpl /etc/istio/proxy/envoy_telemetry.yaml.tmpl
  16. ADD istio-iptables.sh /usr/local/bin/istio-iptables.sh
  17. COPY envoy_bootstrap_v2.json /var/lib/istio/envoy/envoy_bootstrap_tmpl.json
  18. RUN chmod 755 /usr/local/bin/envoy /usr/local/bin/pilot-agent
  19. # 将 istio-proxy 用户加入 sudo 权限以允许执行 tcpdump 和其他调试命令
  20. RUN useradd -m --uid 1337 istio-proxy && \
  21. echo "istio-proxy ALL=NOPASSWD: ALL" >> /etc/sudoers && \
  22. chown -R istio-proxy /var/lib/istio
  23. # 使用 pilot-agent 来启动 Envoy
  24. ENTRYPOINT ["/usr/local/bin/pilot-agent"]

该容器的启动入口是 pilot-agent 命令,根据 YAML 配置中传递的参数,详细的启动命令入下:

  1. /usr/local/bin/pilot-agent proxy sidecar --configPath /etc/istio/proxy --binaryPath /usr/local/bin/envoy --serviceCluster productpage --drainDuration 45s --parentShutdownDuration 1m0s --discoveryAddress istio-pilot.istio-system:15007 --discoveryRefreshDelay 1s --zipkinAddress zipkin.istio-system:9411 --connectTimeout 10s --statsdUdpAddress istio-statsd-prom-bridge.istio-system:9125 --proxyAdminPort 15000 --controlPlaneAuthPolicy NONE

主要配置了 Envoy 二进制文件的位置、服务发现地址、服务集群名、监控指标上报地址、Envoy 的管理端口、热重启时间等,详细用法请参考 Istio官方文档 pilot-agent 的用法

pilot-agent 是容器中 PID 为 1 的启动进程,它启动时又创建了一个 Envoy 进程,如下:

  1. /usr/local/bin/envoy -c /etc/istio/proxy/envoy-rev0.json --restart-epoch 0 --drain-time-s 45 --parent-shutdown-time-s 60 --service-cluster productpage --service-node sidecar~172.33.78.10~productpage-v1-745ffc55b7-2l2lw.default~default.svc.cluster.local --max-obj-name-len 189 -l warn --v2-config-only

我们分别解释下以上配置的意义。

  • -c /etc/istio/proxy/envoy-rev0.json:配置文件,支持 .json.yaml.pb.pb_text 格式,pilot-agent 启动的时候读取了容器的环境变量后创建的。
  • --restart-epoch 0:Envoy 热重启周期,第一次启动默认为 0,每热重启一次该值加 1。
  • --drain-time-s 45:热重启期间 Envoy 将耗尽连接的时间。
  • --parent-shutdown-time-s 60: Envoy 在热重启时关闭父进程之前等待的时间。
  • --service-cluster productpage:Envoy 运行的本地服务集群的名字。
  • --service-node sidecar~172.33.78.10~productpage-v1-745ffc55b7-2l2lw.default~default.svc.cluster.local:定义 Envoy 运行的本地服务节点名称,其中包含了该 Pod 的名称、IP、DNS 域等信息,根据容器的环境变量拼出来的。
  • -max-obj-name-len 189:cluster/route_config/listener 中名称字段的最大长度(以字节为单位)
  • -l warn:日志级别
  • --v2-config-only:只解析 v2 引导配置文件

详细配置请参考 Envoy 的命令行选项

查看 Envoy 的配置文件 /etc/istio/proxy/envoy-rev0.json

  1. {
  2. "node": {
  3. "id": "sidecar~172.33.78.10~productpage-v1-745ffc55b7-2l2lw.default~default.svc.cluster.local",
  4. "cluster": "productpage",
  5. "metadata": {
  6. "INTERCEPTION_MODE": "REDIRECT",
  7. "ISTIO_PROXY_SHA": "istio-proxy:6166ae7ebac7f630206b2fe4e6767516bf198313",
  8. "ISTIO_PROXY_VERSION": "1.0.0",
  9. "ISTIO_VERSION": "1.0.0",
  10. "POD_NAME": "productpage-v1-745ffc55b7-2l2lw",
  11. "istio": "sidecar"
  12. }
  13. },
  14. "stats_config": {
  15. "use_all_default_tags": false
  16. },
  17. "admin": {
  18. "access_log_path": "/dev/stdout",
  19. "address": {
  20. "socket_address": {
  21. "address": "127.0.0.1",
  22. "port_value": 15000
  23. }
  24. }
  25. },
  26. "dynamic_resources": {
  27. "lds_config": {
  28. "ads": {}
  29. },
  30. "cds_config": {
  31. "ads": {}
  32. },
  33. "ads_config": {
  34. "api_type": "GRPC",
  35. "refresh_delay": {"seconds": 1, "nanos": 0},
  36. "grpc_services": [
  37. {
  38. "envoy_grpc": {
  39. "cluster_name": "xds-grpc"
  40. }
  41. }
  42. ]
  43. }
  44. },
  45. "static_resources": {
  46. "clusters": [
  47. {
  48. "name": "xds-grpc",
  49. "type": "STRICT_DNS",
  50. "connect_timeout": {"seconds": 10, "nanos": 0},
  51. "lb_policy": "ROUND_ROBIN",
  52. "hosts": [
  53. {
  54. "socket_address": {"address": "istio-pilot.istio-system", "port_value": 15010}
  55. }
  56. ],
  57. "circuit_breakers": {
  58. "thresholds": [
  59. {
  60. "priority": "default",
  61. "max_connections": "100000",
  62. "max_pending_requests": "100000",
  63. "max_requests": "100000"
  64. },
  65. {
  66. "priority": "high",
  67. "max_connections": "100000",
  68. "max_pending_requests": "100000",
  69. "max_requests": "100000"
  70. }]
  71. },
  72. "upstream_connection_options": {
  73. "tcp_keepalive": {
  74. "keepalive_time": 300
  75. }
  76. },
  77. "http2_protocol_options": { }
  78. }
  79. ,
  80. {
  81. "name": "zipkin",
  82. "type": "STRICT_DNS",
  83. "connect_timeout": {
  84. "seconds": 1
  85. },
  86. "lb_policy": "ROUND_ROBIN",
  87. "hosts": [
  88. {
  89. "socket_address": {"address": "zipkin.istio-system", "port_value": 9411}
  90. }
  91. ]
  92. }
  93. ]
  94. },
  95. "tracing": {
  96. "http": {
  97. "name": "envoy.zipkin",
  98. "config": {
  99. "collector_cluster": "zipkin"
  100. }
  101. }
  102. },
  103. "stats_sinks": [
  104. {
  105. "name": "envoy.statsd",
  106. "config": {
  107. "address": {
  108. "socket_address": {"address": "10.254.109.175", "port_value": 9125}
  109. }
  110. }
  111. }
  112. ]
  113. }

下图是使用 Istio 管理的 bookinfo 示例的访问请求路径图。

Istio bookinfo

图片来自 Istio 官方网站

对照 bookinfo 示例的 productpage 查看建立的连接。在 productpage-v1-745ffc55b7-2l2lw Pod 的 istio-proxy 容器中使用 root 用户查看打开的端口。

  1. $ lsof -i
  2. COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
  3. envoy 11 istio-proxy 9u IPv4 73951 0t0 TCP localhost:15000 (LISTEN) # Envoy admin 端口
  4. envoy 11 istio-proxy 17u IPv4 74320 0t0 TCP productpage-v1-745ffc55b7-2l2lw:46862->istio-pilot.istio-system.svc.cluster.local:15010 (ESTABLISHED) # 15010:istio-pilot 的 grcp-xds 端口
  5. envoy 11 istio-proxy 18u IPv4 73986 0t0 UDP productpage-v1-745ffc55b7-2l2lw:44332->istio-statsd-prom-bridge.istio-system.svc.cluster.local:9125 # 给 Promethues 发送 metric 的端口
  6. envoy 11 istio-proxy 52u IPv4 74599 0t0 TCP *:15001 (LISTEN) # Envoy 的监听端口
  7. envoy 11 istio-proxy 53u IPv4 74600 0t0 UDP productpage-v1-745ffc55b7-2l2lw:48011->istio-statsd-prom-bridge.istio-system.svc.cluster.local:9125 # 给 Promethues 发送 metric 端口
  8. envoy 11 istio-proxy 54u IPv4 338551 0t0 TCP productpage-v1-745ffc55b7-2l2lw:15001->172.17.8.102:52670 (ESTABLISHED) # 52670:Ingress gateway 端口
  9. envoy 11 istio-proxy 55u IPv4 338364 0t0 TCP productpage-v1-745ffc55b7-2l2lw:44046->172.33.78.9:9091 (ESTABLISHED) # 9091:istio-telemetry 服务的 grpc-mixer 端口
  10. envoy 11 istio-proxy 56u IPv4 338473 0t0 TCP productpage-v1-745ffc55b7-2l2lw:47210->zipkin.istio-system.svc.cluster.local:9411 (ESTABLISHED) # 9411: zipkin 端口
  11. envoy 11 istio-proxy 58u IPv4 338383 0t0 TCP productpage-v1-745ffc55b7-2l2lw:41564->172.33.84.8:9080 (ESTABLISHED) # 9080:details-v1 的 http 端口
  12. envoy 11 istio-proxy 59u IPv4 338390 0t0 TCP productpage-v1-745ffc55b7-2l2lw:54410->172.33.78.5:9080 (ESTABLISHED) # 9080:reivews-v2 的 http 端口
  13. envoy 11 istio-proxy 60u IPv4 338411 0t0 TCP productpage-v1-745ffc55b7-2l2lw:35200->172.33.84.5:9091 (ESTABLISHED) # 9091:istio-telemetry 服务的 grpc-mixer 端口
  14. envoy 11 istio-proxy 62u IPv4 338497 0t0 TCP productpage-v1-745ffc55b7-2l2lw:34402->172.33.84.9:9080 (ESTABLISHED) # reviews-v1 的 http 端口
  15. envoy 11 istio-proxy 63u IPv4 338525 0t0 TCP productpage-v1-745ffc55b7-2l2lw:50592->172.33.71.5:9080 (ESTABLISHED) # reviews-v3 的 http 端口

从输出经过上可以验证 Sidecar 是如何接管流量和与 istio-pilot 通信,及向 Mixer 做遥测数据汇聚的。感兴趣的读者可以再去看看其他几个服务的 istio-proxy 容器中的 iptables 和端口信息。

参考