|
| 1 | +--- |
| 2 | +title: WindowsデバッグTips |
| 3 | +content_type: concept |
| 4 | +--- |
| 5 | + |
| 6 | +<!-- overview --> |
| 7 | + |
| 8 | +<!-- body --> |
| 9 | + |
| 10 | +## ノードレベルのトラブルシューティング{#troubleshooting-node} |
| 11 | + |
| 12 | +1. Podが"Container Creating"と表示されたまま動かなくなったり、何度も再起動を繰り返します |
| 13 | + |
| 14 | + pauseイメージがWindows OSのバージョンと互換性があることを確認してください。 |
| 15 | + 最新/推奨のpauseイメージや詳細情報については、[Pauseコンテナ](/docs/concepts/windows/intro/#pause-container)を参照してください。 |
| 16 | + |
| 17 | + {{< note >}} |
| 18 | + コンテナランタイムとしてcontainerdを使用している場合、pauseイメージはconfig.toml設定ファイルの`plugins.plugins.cri.sandbox_image`フィールドで指定されます。 |
| 19 | + {{< /note >}} |
| 20 | + |
| 21 | +1. Podが`ErrImgPull`または`ImagePullBackOff`のステータスを表示します |
| 22 | + |
| 23 | + Podが[互換性](http://learn.microsoft.com/ja-jp/virtualization/windowscontainers/deploy-containers/version-compatibility)のあるWindowsノードにスケジュールされていることを確認してください。 |
| 24 | + |
| 25 | + Podに対して互換性のあるノードを指定する方法の詳細については、[このガイド](/docs/concepts/windows/user-guide/#ensuring-os-specific-workloads-land-on-the-appropriate-container-host)を参照してください。 |
| 26 | + |
| 27 | +## ネットワークのトラブルシューティング{#troubleshooting-network} |
| 28 | + |
| 29 | +1. Windows Podがネットワークに接続できません |
| 30 | + |
| 31 | + 仮想マシンを使用している場合は、すべてのVMのネットワークアダプターでMACスプーフィングが**有効**になっていることを確認してください。 |
| 32 | + |
| 33 | +1. Windows Podから外部リソースにpingできません |
| 34 | + |
| 35 | + Windows Podには、ICMPプロトコル用にプログラムされたアウトバウンドルールはありません。ただし、TCP/UDPはサポートされています。 |
| 36 | + クラスター外のリソースへの接続を実証する場合は、`ping <IP>`を対応する`curl <IP>`コマンドに置き換えてください。 |
| 37 | + |
| 38 | + それでも問題が解決しない場合は、[cni.conf](http://github.com/Microsoft/SDN/blob/master/Kubernetes/flannel/l2bridge/cni/config/cni.conf)のネットワーク設定に問題がある可能性が高いです。 |
| 39 | + この静的ファイルはいつでも編集できます。 |
| 40 | + 設定の更新は、新しく作成されたすべてのKubernetesリソースに適用されます。 |
| 41 | + |
| 42 | + Kubernetesのネットワーク要件の1つ([Kubernetesモデル](/ja/docs/concepts/cluster-administration/networking/)を参照)は、内部でNATせずにクラスター通信が行われることです。 |
| 43 | + この要件を満たすために、アウトバウンドのNATを発生させたくないすべての通信のための[ExceptionList](http://github.com/Microsoft/SDN/blob/master/Kubernetes/flannel/l2bridge/cni/config/cni.conf#L20)があります。 |
| 44 | + ただしこれは、クエリしようとしている外部IPを`ExceptionList`から除外する必要があることも意味します。 |
| 45 | + そうして初めて、Windows Podからのトラフィックが正しくSNATされ、外部からの応答を受信できるようになります。 |
| 46 | + この点について、`cni.conf`の`ExceptionList`は次のようになります: |
| 47 | + |
| 48 | + ```conf |
| 49 | + "ExceptionList": [ |
| 50 | + "10.244.0.0/16", # クラスターのサブネット |
| 51 | + "10.96.0.0/12", # Serviceのサブネット |
| 52 | + "10.127.130.0/24" # 管理(ホスト)のサブネット |
| 53 | + ] |
| 54 | + ``` |
| 55 | + |
| 56 | +1. Windowsノードが`NodePort`タイプのServiceにアクセスできません |
| 57 | + |
| 58 | + ノード自身からのローカルNodePortへのアクセスは失敗します。 |
| 59 | + これは既知の制限です。 |
| 60 | + NodePortへのアクセスは、他のノードや外部のクライアントからは動作します。 |
| 61 | + |
| 62 | +1. コンテナのvNICとHNSエンドポイントが削除されています |
| 63 | + |
| 64 | + この問題は`hostname-override`パラメーターが[kube-proxy](/docs/reference/command-line-tools-reference/kube-proxy/) |
| 65 | + に渡されていない場合に発生する可能性があります。 |
| 66 | + これを解決するためには、ユーザーは次のようにkube-proxyにホスト名を渡す必要があります: |
| 67 | + |
| 68 | + ```powershell |
| 69 | + C:\k\kube-proxy.exe --hostname-override=$(hostname) |
| 70 | + ``` |
| 71 | + |
| 72 | +1. WindowsノードがService IPを使用してサービスにアクセスできません |
| 73 | + |
| 74 | + これはWindows上のネットワークスタックの既知の制限です。 |
| 75 | + ただし、Windows PodはService IPにアクセスできます。 |
| 76 | + |
| 77 | +1. kubeletの起動時にネットワークアダプターが見つかりません |
| 78 | + |
| 79 | + Windowsのネットワーキングスタックでは、Kubernetesネットワーキングが動作するために仮想アダプターが必要です。 |
| 80 | + (管理者シェルで)次のコマンドを実行しても結果が返されない場合、kubeletが動作するために必要な前提条件である仮想ネットワークの作成に失敗しています。 |
| 81 | + |
| 82 | + ```powershell |
| 83 | + Get-HnsNetwork | ? Name -ieq "cbr0" |
| 84 | + Get-NetAdapter | ? Name -Like "vEthernet (Ethernet*" |
| 85 | + ``` |
| 86 | + |
| 87 | + ホストのネットワークアダプターが"Ethernet"ではない場合、`start.ps1`スクリプトの[InterfaceName](http://github.com/microsoft/SDN/blob/master/Kubernetes/flannel/start.ps1#L7)パラメーターを修正することが有益です。 |
| 88 | + それ以外の場合は、`start-kubelet.ps1`スクリプトの出力結果を参照して、仮想ネットワークの作成中にエラーが発生していないか確認します。 |
| 89 | + |
| 90 | +1. DNS名前解決が正しく動作しません |
| 91 | + |
| 92 | + この[セクション](/ja/docs/concepts/services-networking/dns-pod-service/#dns-windows)のWindowsにおけるDNSの制限について確認してください。 |
| 93 | + |
| 94 | +1. `kubectl port-forward`が"unable to do port forwarding: wincat not found"で失敗します |
| 95 | + |
| 96 | + これは、pauseインフラコンテナ`mcr.microsoft.com/oss/kubernetes/pause:3.6`に`wincat.exe`を含める形で、Kubernetes 1.15にて実装されました。 |
| 97 | + 必ずサポートされたKubernetesのバージョンを使用してください。 |
| 98 | + 独自のpauseインフラコンテナをビルドしたい場合は、必ず[wincat](http://github.com/kubernetes/kubernetes/tree/master/build/pause/windows/wincat)を含めるようにしてください。 |
| 99 | + |
| 100 | +1. Windows Serverノードがプロキシの背後にあるため、Kubernetesのインストールに失敗しています |
| 101 | + |
| 102 | + プロキシの背後にある場合は、次のPowerShell環境変数が定義されている必要があります: |
| 103 | + |
| 104 | + ```PowerShell |
| 105 | + [Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://proxy.example.com:80/", [EnvironmentVariableTarget]::Machine) |
| 106 | + [Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://proxy.example.com:443/", [EnvironmentVariableTarget]::Machine) |
| 107 | + ``` |
| 108 | + |
| 109 | +### Flannelのトラブルシューティング |
| 110 | + |
| 111 | +1. Flannelを使用すると、クラスターに再参加した後にノードに問題が発生します |
| 112 | + |
| 113 | + 以前に削除したノードがクラスターに再参加すると、flanneldはノードに新しいPodサブネットを割り当てようとします。 |
| 114 | + ユーザーは、次のパスにある古いPodサブネットの設定ファイルを削除する必要があります: |
| 115 | + |
| 116 | + ```powershell |
| 117 | + Remove-Item C:\k\SourceVip.json |
| 118 | + Remove-Item C:\k\SourceVipRequest.json |
| 119 | + ``` |
| 120 | + |
| 121 | +1. Flanneldが"Waiting for the Network to be created"と表示されたままになります |
| 122 | + |
| 123 | + この[Issue](http://github.com/coreos/flannel/issues/1066)に関する多数の報告があります; |
| 124 | + 最も可能性が高いのは、flannelネットワークの管理IPが設定されるタイミングの問題です。 |
| 125 | + 回避策は、`start.ps1`を再度実行するか、次のように手動で再起動することです: |
| 126 | + |
| 127 | + ```powershell |
| 128 | + [Environment]::SetEnvironmentVariable("NODE_NAME", "<Windows_Worker_Hostname>") |
| 129 | + C:\flannel\flanneld.exe --kubeconfig-file=c:\k\config --iface=<Windows_Worker_Node_IP> --ip-masq=1 --kube-subnet-mgr=1 |
| 130 | + ``` |
| 131 | + |
| 132 | +1. `/run/flannel/subnet.env`が見つからないためにWindows Podが起動しません |
| 133 | + |
| 134 | + これはFlannelが正常に起動できなかったことを示しています。 |
| 135 | + `flanneld.exe`を再起動するか、Kubernetesマスター上の`/run/flannel/subnet.env`をWindowsワーカーノード上の`C:\run\flannel\subnet.env`に手動でコピーして、`FLANNEL_SUBNET`行を異なる数値に変更します。 |
| 136 | + 例えば、ノードのサブネットを10.244.4.1/24としたい場合は次のようにします: |
| 137 | + |
| 138 | + ```env |
| 139 | + FLANNEL_NETWORK=10.244.0.0/16 |
| 140 | + FLANNEL_SUBNET=10.244.4.1/24 |
| 141 | + FLANNEL_MTU=1500 |
| 142 | + FLANNEL_IPMASQ=true |
| 143 | + ``` |
| 144 | + |
| 145 | +### さらなる調査 |
| 146 | + |
| 147 | +これらの手順で問題が解決しない場合は、下記からKubernetesのWindowsノード上でWindowsコンテナを実行するためのヘルプを得ることができます: |
| 148 | + |
| 149 | +* StackOverflowの[Windows Server Container](http://stackoverflow.com/questions/tagged/windows-server-container)トピック |
| 150 | +* Kubernetesの公式フォーラム[discuss.kubernetes.io](http://discuss.kubernetes.io/) |
| 151 | +* Kubernetes Slack [#SIG-Windowsチャンネル](http://kubernetes.slack.com/messages/sig-windows) |
| 152 | + |
0 commit comments