虚拟机调试

本页介绍如何对 Istio 部署至虚拟机时出现的问题进行诊断和排除。 在此之前,请确保您已经按照虚拟机安装指南完成了相应操作。 此外阅读虚拟机体系架构可以帮助您更好的了解组件间是如何交互的。

对 Istio 部署至虚拟机进行故障排除跟对 Kubernetes 内运行的代理问题进行故障排除是类似的,但还是有一些关键点需要注意。

虽然在两个平台上都可以获得许多相同的信息,但对这些信息的访问是不同的。

健康检查

Istio sidecar 通常作为一个 systemd 服务(unit)运行。您可以检查其状态来确保运行正常:

  1. $ systemctl status istio

除此之外您还可以在端点(endpoint)侧以编程的方式检查来 sidecar 的运行情况:

  1. $ curl localhost:15021/healthz/ready -I

日志

Istio 代理的日志可以在以下地方找到。

访问 systemd 日志获取有关于代理的初始化信息:

  1. $ journalctl -f -u istio -n 1000

代理会将 stderr 日志和 stdout 日志分别重定向到 /var/log/istio/istio.err.log/var/log/istio/istio.log。 你可以以类似于 kubectl 的格式查看这些内容:

  1. $ tail /var/log/istio/istio.err.log /var/log/istio/istio.log -Fq -n 100

修改配置文件 cluster.env 可以调整日志级别。如果 istio 已经在运行,请务必重新启动服务:

  1. $ echo "ISTIO_AGENT_FLAGS=\"--log_output_level=dns:debug --proxyLogLevel=debug\"" >> /var/lib/istio/envoy/cluster.env
  2. $ systemctl restart istio

Iptables

确保 iptables 规则已经生效:

  1. $ sudo iptables-save
  2. ...
  3. -A ISTIO_OUTPUT -d 127.0.0.1/32 -j RETURN
  4. -A ISTIO_OUTPUT -j ISTIO_REDIRECT

Istioctl

绝大部分 istioctl 指令能在虚拟机中正常运行。例如利用 istioctl proxy-status 指令查看所有已连接的代理:

  1. $ istioctl proxy-status
  2. NAME CDS LDS EDS RDS ISTIOD VERSION
  3. vm-1.default SYNCED SYNCED SYNCED SYNCED istiod-789ffff8-f2fkt 1.12.2

然而由于 istioctl proxy-config 依赖于 Kubernetes 中的连接代理的功能,因此这对条指令无法在虚拟机环境工作。 不过我们可以传递一个包含 Envoy 配置的文件来替代,举例:

  1. $ curl -s localhost:15000/config_dump | istioctl proxy-config clusters --file -
  2. SERVICE FQDN PORT SUBSET DIRECTION TYPE
  3. istiod.istio-system.svc.cluster.local 443 - outbound EDS
  4. istiod.istio-system.svc.cluster.local 15010 - outbound EDS
  5. istiod.istio-system.svc.cluster.local 15012 - outbound EDS
  6. istiod.istio-system.svc.cluster.local 15014 - outbound EDS

自动注册

当虚拟机连接到 Istiod 时,会自动创建一个 workloadEntry。 这使得虚拟机成为 service 的一部分,类似于 Kubernetes 中的 endpoint

检查这些配置是否正确创建:

  1. $ kubectl get workloadentries
  2. NAME AGE ADDRESS
  3. vm-10.128.0.50 14m 10.128.0.50

证书

虚拟机处理证书的方式与 Kubernetes Pods 不同,Kubernetes Pods 使用 Kubernetes 提供的 SA 令牌来(service account token)来验证和续订 mTLS 证书。虚拟机则是使用现有的 mTLS 凭据向证书颁发机构进行身份验证并续订证书。

可以使用与 Kubernetes 相同的方式查看这些证书的状态:

  1. $ curl -s localhost:15000/config_dump | ./istioctl proxy-config secret --file -
  2. RESOURCE NAME TYPE STATUS VALID CERT SERIAL NUMBER NOT AFTER NOT BEFORE
  3. default Cert Chain ACTIVE true 251932493344649542420616421203546836446 2021-01-29T18:07:21Z 2021-01-28T18:07:21Z
  4. ROOTCA CA ACTIVE true 81663936513052336343895977765039160718 2031-01-26T17:54:44Z 2021-01-28T17:54:44Z

除此之外, 这些证书需要持久化到磁盘上,以确保停机或重新启动不会丢失。

  1. $ ls /etc/certs
  2. cert-chain.pem key.pem root-cert.pem