Apply suggestions from code review
Co-authored-by: Toshiaki Inukai <82919057+t-inu@users.noreply.github.com>pull/34162/head
parent
3065803a41
commit
e1d56397ad
|
@ -27,7 +27,7 @@ no_list: true
|
||||||
|
|
||||||
本サイトのドキュメントは、様々な疑問に対する答えを提供するために構成されています。
|
本サイトのドキュメントは、様々な疑問に対する答えを提供するために構成されています。
|
||||||
|
|
||||||
[コンセプト](/ja/docs/concepts/)では、Kubernetesのアーキテクチャーと各コンポーネントの動作について説明し、[セットアップ](/ja/docs/setup/)では、使い始めるための実用的な手順を提供しています。
|
[コンセプト](/ja/docs/concepts/)では、Kubernetesのアーキテクチャと各コンポーネントの動作について説明し、[セットアップ](/ja/docs/setup/)では、使い始めるための実用的な手順を提供しています。
|
||||||
[タスク](/ja/docs/tasks/) は、よく使われるタスクの実行方法を示し、 [チュートリアル](/ja/docs/tutorials/)は、実世界の業界特有、またはエンドツーエンドの開発シナリオ、より包括的なウォークスルーとなります。
|
[タスク](/ja/docs/tasks/) は、よく使われるタスクの実行方法を示し、 [チュートリアル](/ja/docs/tutorials/)は、実世界の業界特有、またはエンドツーエンドの開発シナリオ、より包括的なウォークスルーとなります。
|
||||||
[リファレンス](/ja/docs/reference/)セクションでは、[Kubernetes API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)や[`kubectl`](/docs/reference/kubectl/overview/)などのコマンドラインインターフェース(CLI)に関する詳しいドキュメントが提供されています。
|
[リファレンス](/ja/docs/reference/)セクションでは、[Kubernetes API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)や[`kubectl`](/docs/reference/kubectl/overview/)などのコマンドラインインターフェース(CLI)に関する詳しいドキュメントが提供されています。
|
||||||
|
|
||||||
|
|
|
@ -461,7 +461,7 @@ OCI runtime exec failed: exec failed: container_linux.go:346: starting container
|
||||||
引数に`-i`/`--interactive`を指定すると、`kubectl`は自動的にエフェメラルコンテナのコンソールにアタッチされます。
|
引数に`-i`/`--interactive`を指定すると、`kubectl`は自動的にエフェメラルコンテナのコンソールにアタッチされます。
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
kubectl debug -it ephemeral-demo --image=busybox --target=ephemeral-demo
|
kubectl debug -it ephemeral-demo --image=busybox:1.28 --target=ephemeral-demo
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
```
|
||||||
|
@ -470,10 +470,10 @@ If you don't see a command prompt, try pressing enter.
|
||||||
/ #
|
/ #
|
||||||
```
|
```
|
||||||
|
|
||||||
このコマンドは新しいbusyboxコンテナを追加し、それにアタッチします。`target`パラメーターは、他のコンテナのプロセス名前空間をターゲットにします。これは`kubectl run`が作成するPodで[プロセス名前空間の共有](/ja/docs/tasks/configure-pod-container/share-process-namespace/)を有効にしないため、指定する必要があります。
|
このコマンドは新しいbusyboxコンテナを追加し、それにアタッチします。`--target`パラメーターは、他のコンテナのプロセス名前空間をターゲットにします。これは`kubectl run`が作成するPodで[プロセス名前空間の共有](/ja/docs/tasks/configure-pod-container/share-process-namespace/)を有効にしないため、指定する必要があります。
|
||||||
|
|
||||||
{{< note >}}
|
{{< note >}}
|
||||||
`target` パラメーターは{{< glossary_tooltip text="Container Runtime" term_id="container-runtime" >}}でサポートされている必要があります。サポートされていない場合、エフェメラルコンテナは起動されないか、`ps`が他のコンテナ内のプロセスを表示しないように孤立したプロセス名前空間を使用して起動されます。
|
`--target`パラメーターは{{< glossary_tooltip text="Container Runtime" term_id="container-runtime" >}}でサポートされている必要があります。サポートされていない場合、エフェメラルコンテナは起動されないか、`ps`が他のコンテナ内のプロセスを表示しないように孤立したプロセス名前空間を使用して起動されます。
|
||||||
{{< /note >}}
|
{{< /note >}}
|
||||||
|
|
||||||
新しく作成されたエフェメラルコンテナの状態は`kubectl describe`を使って見ることができます:
|
新しく作成されたエフェメラルコンテナの状態は`kubectl describe`を使って見ることができます:
|
||||||
|
@ -514,11 +514,11 @@ Podの設定オプションによって、特定の状況でのトラブルシ
|
||||||
|
|
||||||
### 新しいコンテナを追加しながらPodをコピーします
|
### 新しいコンテナを追加しながらPodをコピーします
|
||||||
|
|
||||||
新しいコンテナを追加することは、アプリケーションが動作しているが期待通りの動作をせず、トラブルシューティングユーティリティをPodに追加したい場合に便利な場合があります。
|
新しいコンテナを追加することは、アプリケーションは動作しているが期待通りの動作をせず、トラブルシューティングユーティリティをPodに追加したい場合に便利です。
|
||||||
例えば、アプリケーションのコンテナイメージは`busybox`上にビルドされているが、`busybox`に含まれていないデバッグユーティリティが必要な場合があります。このシナリオは`kubectl run`を使ってシミュレーションすることができます。
|
例えば、アプリケーションのコンテナイメージは`busybox`上にビルドされているが、`busybox`に含まれていないデバッグユーティリティが必要な場合があります。このシナリオは`kubectl run`を使ってシミュレーションすることができます。
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
kubectl run myapp --image=busybox --restart=Never -- sleep 1d
|
kubectl run myapp --image=busybox:1.28 --restart=Never -- sleep 1d
|
||||||
```
|
```
|
||||||
|
|
||||||
このコマンドを実行すると、`myapp`のコピーに`myapp-debug`という名前が付き、デバッグ用の新しいUbuntuコンテナが追加されます。
|
このコマンドを実行すると、`myapp`のコピーに`myapp-debug`という名前が付き、デバッグ用の新しいUbuntuコンテナが追加されます。
|
||||||
|
@ -538,7 +538,7 @@ root@myapp-debug:/#
|
||||||
|
|
||||||
* `i`フラグを指定すると、デフォルトで`kubectl debug`が新しいコンテナにアタッチされます。これを防ぐには、`--attach=false`を指定します。セッションが切断された場合は、`kubectl attach`を使用して再接続することができます。
|
* `i`フラグを指定すると、デフォルトで`kubectl debug`が新しいコンテナにアタッチされます。これを防ぐには、`--attach=false`を指定します。セッションが切断された場合は、`kubectl attach`を使用して再接続することができます。
|
||||||
|
|
||||||
* `share-processes` を指定すると、Pod 内のコンテナからプロセスを参照することができます。この仕組みについて詳しくは、[Pod内のコンテナ間でプロセス名前空間を共有する](/ja/docs/tasks/configure-pod-container/share-process-namespace/)を参照してください。
|
* `--share-processes`を指定すると、このPod内のコンテナが、Pod内の他のコンテナのプロセスを参照することができます。この仕組みについて詳しくは、[Pod内のコンテナ間でプロセス名前空間を共有する](/ja/docs/tasks/configure-pod-container/share-process-namespace/)を参照してください。
|
||||||
{{< /note >}}
|
{{< /note >}}
|
||||||
|
|
||||||
デバッグが終わったら、Podの後始末をするのを忘れないでください。
|
デバッグが終わったら、Podの後始末をするのを忘れないでください。
|
||||||
|
@ -549,11 +549,11 @@ kubectl delete pod myapp myapp-debug
|
||||||
|
|
||||||
### Podのコマンドを変更しながらコピーします
|
### Podのコマンドを変更しながらコピーします
|
||||||
|
|
||||||
デバッグフラグを追加するためや、アプリケーションがクラッシュするためなど、コンテナのコマンドを変更すると便利な場合があります。
|
例えば、デバッグフラグを追加する場合や、アプリケーションがクラッシュしている場合などでは、コンテナのコマンドを変更すると便利なことがあります。
|
||||||
アプリケーションのクラッシュをシミュレートするには、`kubectl run`を使用して、すぐに終了するコンテナを作成します:
|
アプリケーションのクラッシュをシミュレートするには、`kubectl run`を使用して、すぐに終了するコンテナを作成します:
|
||||||
|
|
||||||
```
|
```
|
||||||
kubectl run --image=busybox myapp -- false
|
kubectl run --image=busybox:1.28 myapp -- false
|
||||||
```
|
```
|
||||||
|
|
||||||
`kubectl describe pod myapp`を使用すると、このコンテナがクラッシュしていることがわかります:
|
`kubectl describe pod myapp`を使用すると、このコンテナがクラッシュしていることがわかります:
|
||||||
|
@ -586,9 +586,9 @@ If you don't see a command prompt, try pressing enter.
|
||||||
これで、ファイルシステムのパスのチェックやコンテナコマンドの手動実行などのタスクを実行するために使用できる対話型シェルが完成しました。
|
これで、ファイルシステムのパスのチェックやコンテナコマンドの手動実行などのタスクを実行するために使用できる対話型シェルが完成しました。
|
||||||
|
|
||||||
{{< note >}}
|
{{< note >}}
|
||||||
* 特定のコンテナのコマンドを変更するには、そのコンテナ名を`--container`で指定する必要があり、そうしないと`kubectl debug`が代わりに指定したコマンドを実行する新しいコンテナを作成します。
|
* 特定のコンテナのコマンドを変更するには、そのコンテナ名を`--container`で指定する必要があります。そうしなければ、指定したコマンドを実行するための新しいコンテナを、`kubectl debug`が代わりに作成します。
|
||||||
|
|
||||||
* ` i` フラグは、デフォルトで `kubectl debug` がコンテナにアタッチされるようにします。これを防ぐには、`--attach=false`を指定します。セッションが切断された場合は、`kubectl attach` を使用して再接続することができます。
|
* `-i`フラグは、デフォルトで`kubectl debug`がコンテナにアタッチされるようにします。これを防ぐには、`--attach=false`を指定します。セッションが切断された場合は、`kubectl attach`を使用して再接続することができます。
|
||||||
{{< /note >}}
|
{{< /note >}}
|
||||||
|
|
||||||
デバッグが終わったら、Podの後始末をするのを忘れないでください:
|
デバッグが終わったら、Podの後始末をするのを忘れないでください:
|
||||||
|
@ -599,12 +599,12 @@ kubectl delete pod myapp myapp-debug
|
||||||
|
|
||||||
### コンテナイメージを変更してPodをコピーします
|
### コンテナイメージを変更してPodをコピーします
|
||||||
|
|
||||||
状況によっては、動作不良のPodを通常のプロダクション用のイメージから、デバッグ・ビルドや追加ユーティリティを含むイメージに変更したい場合があります。
|
状況によっては、動作不良のPodを通常のプロダクション用のコンテナイメージから、デバッグビルドや追加ユーティリティを含むイメージに変更したい場合があります。
|
||||||
|
|
||||||
例として、`kubectl run`を使用してPodを作成します:
|
例として、`kubectl run`を使用してPodを作成します:
|
||||||
|
|
||||||
```
|
```
|
||||||
kubectl run myapp --image=busybox --restart=Never -- sleep 1d
|
kubectl run myapp --image=busybox:1.28 --restart=Never -- sleep 1d
|
||||||
```
|
```
|
||||||
|
|
||||||
ここで、`kubectl debug`を使用してコピーを作成し、そのコンテナイメージを`ubuntu`に変更します:
|
ここで、`kubectl debug`を使用してコピーを作成し、そのコンテナイメージを`ubuntu`に変更します:
|
||||||
|
@ -613,11 +613,12 @@ kubectl run myapp --image=busybox --restart=Never -- sleep 1d
|
||||||
kubectl debug myapp --copy-to=myapp-debug --set-image=*=ubuntu
|
kubectl debug myapp --copy-to=myapp-debug --set-image=*=ubuntu
|
||||||
```
|
```
|
||||||
|
|
||||||
`set-image`の構文は、`kubectl set image`と同じ`container_name=image`の構文を使用します。`*=ubuntu`は、全てのコンテナのイメージを`ubuntu`に変更することを意味します。
|
`--set-image`の構文は、`kubectl set image`と同じ`container_name=image`の構文を使用します。`*=ubuntu`は、全てのコンテナのイメージを`ubuntu`に変更することを意味します。
|
||||||
|
|
||||||
デバッグが終わったら、Podの後始末をするのを忘れないでください:
|
デバッグが終わったら、Podの後始末をするのを忘れないでください:
|
||||||
|
|
||||||
```shell kubectl delete pod myapp myapp-debug
|
```shell
|
||||||
|
kubectl delete pod myapp myapp-debug
|
||||||
```
|
```
|
||||||
|
|
||||||
## ノード上のシェルによるデバッグ {#node-shell-session}
|
## ノード上のシェルによるデバッグ {#node-shell-session}
|
||||||
|
|
|
@ -1,7 +1,6 @@
|
||||||
---
|
---
|
||||||
content_type: concept
|
content_type: concept
|
||||||
title: 監査
|
title: 監査
|
||||||
weight: 30
|
|
||||||
---
|
---
|
||||||
|
|
||||||
<!-- overview -->
|
<!-- overview -->
|
||||||
|
|
Loading…
Reference in New Issue