バグ報告

バグを発見されましたか？ご報告いただければ幸いです。

製品のバグ

まず、Issueデータベースを検索して、既に同様の問題が報告されていないか、そして修正時期の見込みを確認してください。データベースに該当の問題が見つからない場合は、新規Issue を作成して、発生している問題を詳しくご報告ください。

バグがセキュリティ脆弱性であると思われる場合は、セキュリティ脆弱性の報告 をご確認ください。

Kubernetesクラスタの状態アーカイブ

Kubernetes上で実行している場合は、バグレポートにクラスタの状態アーカイブを含めることを検討してください。便宜上、istioctl bug-reportコマンドを実行して、Kubernetesクラスタの関連状態を含むアーカイブを作成できます。

$ istioctl bug-report

その後、生成されたbug-report.tgzを報告された問題に添付してください。

メッシュが複数のクラスタにまたがる場合は、--contextまたは--kubeconfigフラグを指定して、各クラスタに対してistioctl bug-reportを実行してください。

bug-reportコマンドを使用できない場合は、以下を含む独自のアーカイブを添付してください。

• istioctl analyze の出力

  $ istioctl analyze --all-namespaces
  

• すべての名前空間のPod、サービス、デプロイメント、エンドポイント

  $ kubectl get pods,services,deployments,endpoints --all-namespaces -o yaml > k8s_resources.yaml
  

• istio-systemの名前空間のシークレット名

  $ kubectl --namespace istio-system get secrets
  

• istio-system名前空間のConfigMap

  $ kubectl --namespace istio-system get cm -o yaml
  

• すべてのIstioコンポーネントとサイドカーの現在のログと過去のログ。取得方法の例を以下に示します。ご自身の環境に合わせて適宜修正してください。

  • Istiodログ

    $ kubectl logs -n istio-system -l app=istiod
    

  • イングレスゲートウェイログ

    $ kubectl logs -l istio=ingressgateway -n istio-system
    

  • エグレスゲートウェイログ

    $ kubectl logs -l istio=egressgateway -n istio-system
    

  • サイドカーログ

    $ 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
    

• すべてのIstio構成アーティファクト

  $ kubectl get istio-io --all-namespaces -o yaml
  

ドキュメントのバグ

まず、ドキュメントのIssueデータベースを検索して、既に同様の問題が報告されていないか、そして修正時期の見込みを確認してください。データベースに該当の問題が見つからない場合は、そこで問題を報告してください。ページへの編集提案を提出したい場合は、各ページの右下に「GitHubでこのページを編集」リンクがあります。