デフォルトの containerd 設定がワークロードのニーズを満たせない場合、ノードプールレベルで containerd パラメーターをカスタマイズできます。たとえば、1 つのイメージリポジトリに対して複数のミラーレジストリを設定したり、特定のレジストリの TLS 証明書検証をスキップしたりできます。
制限事項
この機能には、containerd 1.6.20 以降が必要です。ノードプールがそれ以前のバージョンを使用している場合は、アップグレードしてください。
注意事項
-
カスタム設定はバッチで適用されます。既存のノードには即座に、新しいノードには自動的に適用されます。
-
カスタマイズ可能な containerd パラメーター をコマンドラインから変更しないでください。ACK はこのような変更をブロックし、元に戻すことを要求します。
-
標準ではない構文は、適用時に自動的に修正されます。
カスタマイズ可能な containerd パラメーター
カスタムコンテナランタイム設定
|
パラメーター |
説明 |
タイプ |
値 |
|
|
イメージレイヤーの最大同時ダウンロード数です。値を大きくすると、複数レイヤーのプルは高速化されますが、ネットワークと I/O の負荷が増加します。 |
Int |
|
|
|
|
Bool |
デフォルト:true |
|
|
コアダンプファイルの最大サイズ (バイト単位) です。 特別な値:
|
Int |
|
|
|
コンテナあたりで開くことができるファイルディスクリプタの最大数です。 |
Int |
|
|
|
コンテナプロセスごとにロックできるメモリの最大サイズ (バイト単位) です。 |
Int |
|
[コンテナーイメージリポジトリのミラーサイト設定 (Registry Mirrors)]
|
説明 |
推奨事項 |
|
イメージプルを高速化するために、代替レジストリをミラーとして設定します。 各ミラーは、 この変更では、コンテナの再起動は不要です。 |
|
[証明書認証がスキップされたコンテナイメージリポジトリ (Insecure Registries)]
|
説明 |
推奨事項 |
|
イメージプルの際に、指定されたレジストリの証明書検証をスキップします。自己署名証明書を使用するテスト環境向けです。 この変更では、コンテナの再起動は不要です。 |
|
操作手順
変更は実行中のコンテナには影響しません。この操作はオフピーク時間に実行してください。
ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。
[クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、 を選択します。
-
**[ノードプール]** ページで、目的のノードプールを見つけ、その アクション 列で、
> Containerd 設定 を選択します。 -
パラメーターを追加し、ターゲットノードを指定し、バッチポリシーを設定して、送信 をクリックします。
設定例 をご参照ください。
-
カスタムランタイムパラメーター を削除すると、デフォルト値に戻ります。
-
設定はバッチでノードに適用されます。進行状況は [イベントレコード] エリアで監視でき、更新の一時停止、再開、キャンセルが可能です。ノードの更新に失敗した場合は、トラブルシューティングを行い、続行 をクリックして再試行します。
一時停止すると、更新されたノードで変更を検証できます。進行中のノードは完了しますが、再開するまで新しい更新は待機します。速やかにタスクを完了してください。一時停止されたタスクは 7 日後に自動的にキャンセルされ、すべてのレコードとログが削除されます。
-
設定例
|
docker.io のミラー |
非セキュアなプライベートレジストリ |
HTTP プライベートレジストリ |
|
[レジストリミラー] で、[イメージレジストリ] を |
[非セキュアなレジストリ] で、[イメージレジストリ] にレジストリアドレス (形式: |
[レジストリミラー] で、[イメージレジストリ] をプライベートレジストリアドレス (例: |
よくある質問
containerd のカスタム設定は実行中のサービスに影響しますか?
いいえ。変更は更新後に作成された Pod にのみ適用され、実行中の Pod には適用されません。この操作はオフピーク時間に実行してください。
既存の Pod に新しい設定を適用するには、手動で再作成してください。
エラー: not match XXX または must be between XXX のエラー
一般的な原因は次のとおりです。
-
must be between XXX:値が無効です。形式と許容範囲を確認してください。 -
not match XXX:サポートされていない変更方法です。ACK は設定ファイルのコマンドラインによる変更をブロックします。パラメーターを元の値に戻してください。
関連ドキュメント
-
ノードプールは自動 O&M 機能 をサポートしています。
-
ノード、Pod、containerd、または kubelet の問題については、「ノード問題のトラブルシューティング」、「Pod 問題のトラブルシューティング」、および「ノードとノードプールの FAQ」をご参照ください。