Skip to content

Commit 16a9874

Browse files
committed
[ja] Translate content/ja/docs/tasks/debug/debug-cluster/windows.md into Japanese
1 parent 4d804f9 commit 16a9874

File tree

1 file changed

+152
-0
lines changed
  • content/ja/docs/tasks/debug/debug-cluster

1 file changed

+152
-0
lines changed
Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
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

Comments
 (0)