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

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

最終更新日:Jun 22, 2026

デフォルトの containerd 設定がワークロードに不十分な場合、ノードプールの containerd パラメーターをカスタマイズできます。たとえば、特定のイメージレジストリに対して複数のレジストリミラーを設定したり、イメージレジストリの証明書検証をスキップするようにシステムを設定したりできます。

制限事項

この機能は、コンテナランタイムとして containerd 1.6.20 以降を使用するノードプールでのみ利用できます。それより前のバージョンを使用している場合は、アップグレードする必要があります。

注意事項

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

  • コマンドラインから カスタマイズ可能な containerd パラメーター を変更しないでください。Container Service for Kubernetes (ACK) はこれらの変更をブロックします。このような変更を元に戻す必要があります。

  • カスタム containerd 設定を適用する際、システムは非標準の構文を自動的に修正します。

カスタマイズ可能な 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

  • 有効範囲:0 以上の整数

  • デフォルト値:infinity

limitNoFile

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

Int

  • 有効範囲:1024 以上

  • デフォルト値:1048576

limitMemLock

コンテナー内のプロセスがロックできるメモリの最大量 (バイト単位)。

Int

  • 有効範囲:65536 以上

  • デフォルト値:通常は 65536 で、ホスト OS と一致します。

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

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

説明

推奨事項

イメージレジストリに対してレジストリミラーを設定することで、コンテナランタイムが代替レジストリからイメージをプルして、イメージプルを高速化できます。

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

この変更では、コンテナーを再起動する必要はありません。
  • ローカルイメージレジストリを使用して、イメージのプルを高速化してください。

  • 高可用性とフォールトトレランスのために、複数のレジストリミラーを設定してください。

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

説明

推奨事項

イメージをプルする際、指定したイメージレジストリに対してコンテナランタイムが証明書検証をスキップできるようにします。この設定は、自己署名証明書を使用するレジストリからイメージをプルするテスト環境を対象としています。

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

  • このパラメーターは、自己署名証明書を使用するプライベートレジストリ、または有効な証明書を取得できないプライベートレジストリに対してのみ設定してください。

操作手順

containerd 設定の変更は既存のコンテナーに影響しません。クラスターの安定性を確保するため、この操作はピーク時間外に実行することを推奨します。

  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

このエラーは通常、次の理由で発生します。

  • XXX の範囲内である必要があります: 入力した値は無効です。値の形式が正しく、許容範囲内であることをご確認ください。

  • not match XXX:サポートされていない変更方法が使用されています。 ACK は、コマンドラインから設定ファイルを直接変更することをブロックします。ファイル内のパラメーターを元の値に戻してください。

関連トピック