すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:ノードプールの containerd パラメーターのカスタマイズ

最終更新日:Oct 22, 2026

デフォルトの containerd 設定がワークロードのニーズを満たせない場合、ノードプールレベルで containerd パラメーターをカスタマイズできます。たとえば、1 つのイメージリポジトリに対して複数のミラーレジストリを設定したり、特定のレジストリの TLS 証明書検証をスキップしたりできます。

制限事項

この機能には、containerd 1.6.20 以降が必要です。ノードプールがそれ以前のバージョンを使用している場合は、アップグレードしてください。

注意事項

  • カスタム設定はバッチで適用されます。既存のノードには即座に、新しいノードには自動的に適用されます。

  • カスタマイズ可能な containerd パラメーター をコマンドラインから変更しないでください。ACK はこのような変更をブロックし、元に戻すことを要求します。

  • 標準ではない構文は、適用時に自動的に修正されます。

カスタマイズ可能な containerd パラメーター

カスタムコンテナランタイム設定

パラメーター

説明

タイプ

値

max_concurrent_downloads

イメージレイヤーの最大同時ダウンロード数です。値を大きくすると、複数レイヤーのプルは高速化されますが、ネットワークと I/O の負荷が増加します。

Int

  • 有効範囲:1~20

  • デフォルト:containerd のバージョンによって異なります。

    • containerd 2.x 以降:3

    • containerd 1.x:ランタイムの内部ロジックによって決定されます。

ignore_image_defined_volumes

VOLUME 命令で定義された匿名ボリュームを無視するかどうかを指定します。true に設定すると、匿名ボリュームの自動作成を防ぎます。

Bool

デフォルト:true

limitCore

コアダンプファイルの最大サイズ (バイト単位) です。

特別な値:

  • 0:コアダンプを無効にします。

  • infinity:無制限。

Int

  • 有効範囲:非負整数

  • デフォルト:infinity

limitNoFile

コンテナあたりで開くことができるファイルディスクリプタの最大数です。

Int

  • 有効範囲:≥ 1024

  • デフォルト:1048576

limitMemLock

コンテナプロセスごとにロックできるメモリの最大サイズ (バイト単位) です。

Int

  • 有効範囲:≥ 65536

  • デフォルト:65536 (ホスト OS と一致)。

    Lingjun ノード、または初期化時に RDMA/EDMA デバイスが検出されたノードの場合、デフォルトは infinity です。ノードの準備完了後にアタッチされたデバイスは、この設定をトリガーしません。

[コンテナーイメージリポジトリのミラーサイト設定 (Registry Mirrors)]

説明

推奨事項

イメージプルを高速化するために、代替レジストリをミラーとして設定します。

各ミラーは、override_path を介したカスタムパスマッピングをサポートします。

この変更では、コンテナの再起動は不要です。
  • ローカルレジストリを使用してプルを高速化します。

  • 高可用性のために複数のミラーを設定します。

[証明書認証がスキップされたコンテナイメージリポジトリ (Insecure Registries)]

説明

推奨事項

イメージプルの際に、指定されたレジストリの証明書検証をスキップします。自己署名証明書を使用するテスト環境向けです。

この変更では、コンテナの再起動は不要です。
  • 証明書検証をスキップすると、セキュリティリスクが生じます。開発環境およびテスト環境でのみ使用してください。

  • 自己署名証明書または取得不可能な証明書を持つプライベートレジストリに対してのみ使用してください。

操作手順

変更は実行中のコンテナには影響しません。この操作はオフピーク時間に実行してください。

  1. ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

  2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、[ノード] > [ノードプール] を選択します。

  3. **[ノードプール]** ページで、目的のノードプールを見つけ、その アクション 列で、image > Containerd 設定 を選択します。

  4. パラメーターを追加し、ターゲットノードを指定し、バッチポリシーを設定して、送信 をクリックします。

    設定例 をご参照ください。
    • カスタムランタイムパラメーター を削除すると、デフォルト値に戻ります。

    • 設定はバッチでノードに適用されます。進行状況は [イベントレコード] エリアで監視でき、更新の一時停止、再開、キャンセルが可能です。ノードの更新に失敗した場合は、トラブルシューティングを行い、続行 をクリックして再試行します。

      一時停止すると、更新されたノードで変更を検証できます。進行中のノードは完了しますが、再開するまで新しい更新は待機します。速やかにタスクを完了してください。一時停止されたタスクは 7 日後に自動的にキャンセルされ、すべてのレコードとログが削除されます。

設定例

docker.io のミラー

非セキュアなプライベートレジストリ

HTTP プライベートレジストリ

[レジストリミラー] で、[イメージレジストリ] を docker.io に、[レジストリミラー] をミラーアドレス (例:https://example.com) に設定し、[override_path] を false に設定します。

[非セキュアなレジストリ] で、[イメージレジストリ] にレジストリアドレス (形式:IP アドレス:ポート、例:192.xxx.xxx.xxx:443) を入力し、[skip_verify] を true に設定します。

[レジストリミラー] で、[イメージレジストリ] をプライベートレジストリアドレス (例:192.xxx.1) に、[レジストリミラー] をその HTTP アドレス (例:http://192.xxx.1) に設定し、[override_path] を false に設定します。さらにマッピングを追加するには、[+ 追加] をクリックします。

よくある質問

containerd のカスタム設定は実行中のサービスに影響しますか?

いいえ。変更は更新後に作成された Pod にのみ適用され、実行中の Pod には適用されません。この操作はオフピーク時間に実行してください。

既存の Pod に新しい設定を適用するには、手動で再作成してください。

エラー: not match XXX または must be between XXX のエラー

一般的な原因は次のとおりです。

  • must be between XXX:値が無効です。形式と許容範囲を確認してください。

  • not match XXX:サポートされていない変更方法です。ACK は設定ファイルのコマンドラインによる変更をブロックします。パラメーターを元の値に戻してください。

関連ドキュメント