|
| 1 | +--- |
| 2 | +content_type: "reference" |
| 3 | +title: KubeletチェックポイントAPI |
| 4 | +weight: 10 |
| 5 | +--- |
| 6 | + |
| 7 | +{{< feature-state for_k8s_version="v1.25" state="alpha" >}} |
| 8 | + |
| 9 | +コンテナのチェックポイントは実行中のコンテナのステートフルコピーを作成するための機能です。 |
| 10 | +コンテナのステートフルコピーがあると、デバックや類似の目的のために別のコンピューターに移動させることができます。 |
| 11 | + |
| 12 | +チェックポイントコンテナデータを復元可能なコンピューターに移動させる場合、その復元したコンテナは、チェックポイントが作成された正確に同じ地点で実行が再開されます。 |
| 13 | +保存したデータを検査することも可能です。 |
| 14 | +ただし、検査を行うための適したツールを保持している必要があります。 |
| 15 | + |
| 16 | +コンテナのチェックポイントを作成することで、セキュリティ影響が発生する場合があります。 |
| 17 | +通常、チェックポイントはチェックポイントされたコンテナ内のすべてのプロセスのすべてのメモリーページを含んでいます。 |
| 18 | +メモリー内で使用された全てがローカルディスク上で利用できるようになることを意味しています。 |
| 19 | +これはすべてのプライベートデータを含んでおり、もしかしたら暗号化に使用した鍵も含まれているかもしれません。 |
| 20 | +基礎となるCRI実装(そのノード上のコンテナランタイム)は、`root`ユーザーのみがアクセス可能なチェックポイントアーカイブを作成するべきです。 |
| 21 | +チェックポイントアーカイブが他のシステムに転送された場合、全てのメモリーページがチェックポイントアーカイブのオーナーによって読み取れるようになることを覚えておくことが重要です。 |
| 22 | + |
| 23 | +## 操作方法 {#operations} |
| 24 | + |
| 25 | +### `post` 指定したコンテナのチェックポイント {#post-checkpoint} |
| 26 | + |
| 27 | +指定したPodから指定したコンテナのチェックポイントを作成するようにkubeletに指示します。 |
| 28 | + |
| 29 | +kubeletチェックポイントインターフェイスへのアクセスの制御方法についての詳細な情報は、[Kubelet authentication/authorization reference](/docs/reference/access-authn-authz/kubelet-authn-authz)を参照してください。 |
| 30 | + |
| 31 | +kubeletは基礎となる{{<glossary_tooltip term_id="cri" text="CRI">}}実装にチェックポイントをリクエストします。 |
| 32 | +チェックポイントリクエストでは、kubeletが`checkpoint-<podFullName>-<containerName>-<timestamp>.tar`のようなチェックポイントアーカイブの名前を指定します。 |
| 33 | +併せて、(`--root-dir`で定義される)rootディレクトリ配下の`checkpoints`ディレクトリに、チェックポイントアーカイブを保存することをリクエストします。 |
| 34 | +デフォルトは`/var/lib/kubelet/checkpoints`です。 |
| 35 | + |
| 36 | +チェックポイントアーカイブは _tar_ フォーマットであり、[`tar`](https://pubs.opengroup.org/onlinepubs/7908799/xcu/tar.html)の実装を使用して一覧表示できます。 |
| 37 | +アーカイブの内容は、基礎となるCRI実装(ノード上のコンテナランタイム)に依存します。 |
| 38 | + |
| 39 | +#### HTTPリクエスト {#post-checkpoint-request} |
| 40 | + |
| 41 | +POST /checkpoint/{namespace}/{pod}/{container} |
| 42 | + |
| 43 | +#### パラメーター {#post-checkpoint-params} |
| 44 | + |
| 45 | +- **namespace** (*パス内*): string, 必須項目 |
| 46 | + |
| 47 | + {{< glossary_tooltip term_id="namespace" >}} |
| 48 | + |
| 49 | +- **pod** (*パス内*): string, 必須項目 |
| 50 | + |
| 51 | + {{< glossary_tooltip term_id="pod" >}} |
| 52 | + |
| 53 | +- **container** (*パス内*): string, 必須項目 |
| 54 | + |
| 55 | + {{< glossary_tooltip term_id="container" >}} |
| 56 | + |
| 57 | +- **timeout** (*クエリ内*): integer |
| 58 | + |
| 59 | + チェックポイントの作成が終了するまで待機する秒単位のタイムアウト。 |
| 60 | + ゼロまたはタイムアウトが指定されていない場合、デフォルトは{{<glossary_tooltip term_id="cri" text="CRI">}}タイムアウトの値が使用されます。 |
| 61 | + チェックポイント作成時間はコンテナの使用メモリーに直接依存します。 |
| 62 | + コンテナの使用メモリーが多いほど、対応するチェックポイントを作成するために必要な時間が長くなります。 |
| 63 | + |
| 64 | +#### レスポンス {#post-checkpoint-response} |
| 65 | + |
| 66 | +200: OK |
| 67 | + |
| 68 | +401: Unauthorized |
| 69 | + |
| 70 | +404: Not Found (`ContainerCheckpoint`フィーチャーゲートが無効の場合) |
| 71 | + |
| 72 | +404: Not Found (指定した`namespace`や`pod`、`container`が見つからない場合) |
| 73 | + |
| 74 | +500: Internal Server Error (CRI実装でチェックポイント中にエラーが発生した場合(詳細はエラーメッセージを参照)) |
| 75 | + |
| 76 | +500: Internal Server Error (CRI実装がチェックポイントCRI APIを実装していない場合(詳細はエラーメッセージを参照)) |
| 77 | + |
| 78 | +{{< comment >}} |
| 79 | +TODO: CRI実装がチェックポイントや復元の機能を持つ場合のリターンコードについてさらなる情報を追加すること。 |
| 80 | + このTODOは、CRI実装が新しいContainerCheckpoint CRI APIコールを実装するために、Kubernetesの変更をマージすることを必要とするため、リリース前には修正できません。 |
| 81 | + これを修正するためには1.25リリースの後を待つ必要があります。 |
| 82 | +{{< /comment >}} |
0 commit comments