zh: /help/ops/misc/index.md (#3386)

This commit is contained in:
Vincent 2019-02-26 22:21:30 +08:00 committed by istio-bot
parent 1b478537c2
commit 7de3d0c772
1 changed files with 28 additions and 22 deletions

View File

@ -9,40 +9,39 @@ force_inline_toc: true
验证与 Pilot 的连接是否正常是很有用的排查问题的步骤。在服务网格中的每一个代理容器都应该能够和 Pilot 进行通信。这可以通过几个简单的步骤完成:
1. 获取 Istio Ingress pod 名称:
1. 获取 Istio Ingress pod 名称:
{{< text bash >}}
$ INGRESS_POD_NAME=$(kubectl get po -n istio-system | grep ingressgateway\- | awk '{print$1}'); echo ${INGRESS_POD_NAME};
{{< /text >}}
1. 通过 Exec 进入 Istio Ingress pod 中:
1. 使用 `exec` 进入 Istio Ingress pod 中:
{{< text bash >}}
$ kubectl exec -it $INGRESS_POD_NAME -n istio-system /bin/bash
{{< /text >}}
1. 使`curl` 测试到 Pilot 的连通性。下面的例子使用 Pilot 默认配置参数和启用双向 TLS 认证来调用 v1 registration API
1. 用 `curl` 测试到 Pilot 的连通性。下面的例子使用 Pilot 默认配置参数和启用双向 TLS 认证来调用 `edsz` 节点
{{< text bash >}}
$ curl -k --cert /etc/certs/cert-chain.pem --cacert /etc/certs/root-cert.pem --key /etc/certs/key.pem https://istio-pilot:15003/v1/registration
$ curl -k --cert /etc/certs/cert-chain.pem --cacert /etc/certs/root-cert.pem --key /etc/certs/key.pem https://istio-pilot:8080/debug/edsz
{{< /text >}}
如果禁用双向 TLS 认证:
如果禁用双向 TLS 认证:
{{< text bash >}}
$ curl http://istio-pilot:15003/v1/registration
$ curl http://istio-pilot:8080/debug/edsz
{{< /text >}}
您应该接收到列出在这个服务网格中每个服务的 "service-key" 和 "hosts" 的返回
响应内容中可以看到相关的集群信息
## 在 Mac 上本地运行 Istio 时Zipkin 中没有出现任何追踪轨迹
## 在 Mac 上本地运行 Istio 时Zipkin 中没有出现任何跟踪信息
安装了 Istio,一切似乎都在工作,除了 Zipkin 中没有出现追踪轨迹,但本应该出现
安装了 Istio 之后,看起来一切都在工作,但 Zipkin 中没有出现本该出现的跟踪信息
这可能是由已知的 [Docker 问题](https://github.com/docker/for-mac/issues/1260) 引起的,
容器可能会与宿主机上的时间有明显偏差。如果是这种情况当你在Zipkin中选择一个非常长的日期范围时你会发现这些追踪轨迹太早出现了几天。
这可能是由一个已知的 [Docker 问题](https://github.com/docker/for-mac/issues/1260)引起的,容器可能会与宿主机上的时间有明显偏差。如果是这种情况,可以尝试在 Zipkin 中选择一个非常长的日期范围,你会发现这些追踪轨迹提早出现了几天。
您还可以通过将 docker 容器内的日期与外部进行比较来确认此问题:
您还可以通过将 Docker 容器内的日期与外部进行比较来确认此问题:
{{< text bash >}}
$ docker run --entrypoint date gcr.io/istio-testing/ubuntu-16-04-slave:latest
@ -56,7 +55,7 @@ Thu Jun 15 02:25:42 UTC 2017
要解决此问题,您需要在重新安装 Istio 之前关闭然后重新启动 Docker。
## 如果 `kube-apiserver` 具有代理设置,则 sidecar 自动注入将失败
## `kube-apiserver` 设置代理,会导致 Sidecar 自动注入功能失灵
`Kube-apiserver` 包含代理设置时,例如:
@ -70,24 +69,31 @@ env:
value: 127.0.0.1,localhost,dockerhub.foo.com,devhub-docker.foo.com,10.84.100.125,10.84.100.126,10.84.100.127
{{< /text >}}
sidecar 注入将失败。唯一相关的故障日志位于 `kube-apiserver` 日志中:
Sidecar 注入将失败。唯一相关的故障日志位于 `kube-apiserver` 日志中:
{{< text plain >}}
W0227 21:51:03.156818 1 admission.go:257] Failed calling webhook, failing open sidecar-injector.istio.io: failed calling admission webhook "sidecar-injector.istio.io": Post https://istio-sidecar-injector.istio-system.svc:443/inject: Service Unavailable
{{< /text >}}
确保 pod 和 service CIDR 都没有通过 *_proxy 变量来代理。检查 `kube-apiserver` 文件和日志以验证配置以及是否正在代理任何请求。
检查 `*_proxy` 环境变量,确保 Pod 和 Service CIDR 都没有经过代理。检查 `kube-apiserver` 文件和日志以验证配置以及是否正在代理任何请求。
一个解决方法是从 `kube-apiserver` 配置中删除代理设置,然后重新启动服务器或使用更高版本的 Kubernetes。
向Kubernetes提出了与此相关的问题此后一直关闭。
[https://github.com/kubernetes/kubeadm/issues/666](https://github.com/kubernetes/kubeadm/issues/666)
[https://github.com/kubernetes/kubernetes/pull/58698#discussion_r163879443](https://github.com/kubernetes/kubernetes/pull/58698#discussion_r163879443)
Kubernetes 项目中提出了与此相关的 [Issue](https://github.com/kubernetes/kubeadm/issues/666),后来由 [PR #58698](https://github.com/kubernetes/kubernetes/pull/58698#discussion_r163879443) 关闭。
## Istio 使用的 Envoy 版本是什么
## Istio 使用的是哪个版本的 Envoy
要查找 envoy 的版本,您可以按照以下步骤操作
要查看当前部署中的 Envoy 版本,可以用 `exec` 进入容器,然后获取 `server_info` 端点的信息
1. `kubectl exec -it PODNAME -c istio-proxy -n NAMESPACE /bin/bash`
{{< text bash >}}
$ kubectl exec -it PODNAME -c istio-proxy -n NAMESPACE /bin/bash
root@5c7e9d3a4b67:/# curl localhost:15000/server_info
envoy 0/1.9.0-dev//RELEASE live 57964 57964 0
{{< /text >}}
1. `curl localhost:15000/server_info`
另外,`envoy` 和 `istio-api` 的仓库版本都会在镜像的标签中有所体现:
{{< text bash >}}
$ docker inspect -f '{{json .Config.Labels }}' ISTIO-PROXY-IMAGE
{"envoy-vcs-ref":"b3be5713f2100ab5c40316e73ce34581245bd26a","istio-api-vcs-ref":"825044c7e15f6723d558b7b878855670663c2e1e"}
{{< /text >}}