mirror of https://github.com/istio/istio.io.git
117 lines
3.9 KiB
Markdown
117 lines
3.9 KiB
Markdown
---
|
||
title: 报告错误
|
||
description: 如果发现错误该怎么办。
|
||
weight: 34
|
||
aliases:
|
||
- /zh/bugs.html
|
||
- /zh/bugs/index.html
|
||
- /zh/help/bugs/
|
||
- /zh/about/bugs
|
||
- /zh/latest/about/bugs
|
||
icon: bugs
|
||
owner: istio/wg-docs-maintainers
|
||
test: n/a
|
||
---
|
||
|
||
不好！您发现了一个问题？我们希望知道这一点。
|
||
|
||
## 产品问题 {#product-bugs}
|
||
|
||
搜索我们的[问题数据库](https://github.com/istio/istio/issues/)来了解我们是否已经知道您的问题以及何时可以解决它。
|
||
如果您在该数据库中没有找到您的问题，
|
||
请打开一个[新 Issue](https://github.com/istio/istio/issues/new/choose)让我们知道出现了什么错误。
|
||
|
||
如果您认为错误实际上是一个安全漏洞，请访问[报告安全漏洞](/zh/about/security-vulnerabilities/)了解如何处理。
|
||
|
||
### Kubernetes 集群状态存档 {#Kubernetes-cluster-state-archives}
|
||
|
||
如果您正在运行 Kubernetes，请考虑使用错误报告将集群状态存档。为了方便起见，
|
||
您可以运行 `istioctl bug-report` 命令生成一个存档，该存档包含 Kubernetes
|
||
集群中所有相关的状态：
|
||
|
||
{{< text bash >}}
|
||
$ istioctl bug-report
|
||
{{< /text >}}
|
||
|
||
然后在您报告问题时随附上刚生成的 `bug-report.tgz`。
|
||
|
||
如果您的网格跨越了多个集群，对每个集群运行 `istioctl bug-report` 并指定 `--context`
|
||
或者 `--kubeconfig` 参数。
|
||
|
||
{{< tip >}}
|
||
`istioctl bug-report` 命令仅适用于 `istioctl` 1.8.0 及以上版本，
|
||
但其依然可以对已经安装的较低版本 Istio 生效。
|
||
{{< /tip >}}
|
||
|
||
{{< tip >}}
|
||
如果您在大型集群上运行 `bug-report`，它可能无法完成。
|
||
请使用 `--include ns1,ns2` 选项仅针对相关命名空间的代理命令和日志集合。如需更多 `bug-report` 选项，
|
||
请参阅 [istioctl bug-report 参考](/zh/docs/reference/commands/istioctl/#istioctl-bug-report)。
|
||
{{< /tip >}}
|
||
|
||
如果您无法使用 `bug-report` 命令，请附上您自己的存档包含：
|
||
|
||
* `istioctl analyze` 的输出：
|
||
|
||
{{< text bash >}}
|
||
$ istioctl analyze --all-namespaces
|
||
{{< /text >}}
|
||
|
||
* 所有命名空间下 `pods`、`services`、`deployments`、`endpoints` 资源：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl get pods,services,deployments,endpoints --all-namespaces -o yaml > k8s_resources.yaml
|
||
{{< /text >}}
|
||
|
||
* `istio-system` 下的 Secret：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl --namespace istio-system get secrets
|
||
{{< /text >}}
|
||
|
||
* `istio-system` 下的 ConfigMap：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl --namespace istio-system get cm -o yaml
|
||
{{< /text >}}
|
||
|
||
* 来自所有 Istio 组件和 Sidecar 的当前日志和历史日志。这里有一些关于如何获取这些日志的例子，
|
||
请根据您的环境进行调整：
|
||
|
||
* Istiod 日志：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl logs -n istio-system -l app=istiod
|
||
{{< /text >}}
|
||
|
||
* Ingress Gateway 日志：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl logs -l istio=ingressgateway -n istio-system
|
||
{{< /text >}}
|
||
|
||
* Egress Gateway 日志：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl logs -l istio=egressgateway -n istio-system
|
||
{{< /text >}}
|
||
|
||
* Sidecar 日志：
|
||
|
||
{{< text bash >}}
|
||
$ for ns in $(kubectl get ns -o jsonpath='{.items[*].metadata.name}') ; do kubectl logs -l service.istio.io/canonical-revision -c istio-proxy -n $ns ; done
|
||
{{< /text >}}
|
||
|
||
* 所有 `Istio` 相关的配置文件：
|
||
|
||
{{< text bash >}}
|
||
$ kubectl get istio-io --all-namespaces -o yaml
|
||
{{< /text >}}
|
||
|
||
## 文档错误 {#documentation-bugs}
|
||
|
||
搜索我们的[文档问题数据库](https://github.com/istio/istio.io/issues/)，
|
||
以查看是否我们已经知道您的问题，并了解何时可以解决这些问题。如果您没有在数据库中找到相应的问题，
|
||
请[在那里报告问题](https://github.com/istio/istio.io/issues/new)。
|
||
如果您想提交对页面的修改建议，可以在每个页面的右下角找到"在 GitHub 上编辑此页"的链接。
|