Container Service for Kubernetes (ACK) コンソールから kube-apiserver、kube-controller-manager、CCM、kube-scheduler の設定を調整できます。
以下の手順に従ってパラメーターをカスタマイズし、クラスタータイプ別に利用可能なパラメーターを確認してください。
事前準備
次のものが揃っていることを確認してください：
-
ACK Pro クラスター（マネージド、サーバーレス、Edge、または LINGJUN）
-
コンテナサービス管理コンソール でクラスターアドオンを変更する権限
使用上の注意
-
対応クラスタータイプ： コントロールプレーン パラメーターのカスタマイズは、ACK managed Pro、ACK Serverless Pro、ACK Edge Pro、ACK Lingjun クラスターでのみ可能です。
-
コントロールプレーンの再起動： パラメーター変更を保存すると、コントロールプレーンが再起動します。変更はオフピーク時間に行ってください。
-
デフォルト値の上書き： カスタムパラメーターはデフォルト値を完全に置き換えます。保存する前に、設定に漏れがないことを確認してください。パラメーターが正しくない場合、コントロールプレーンが起動しないことがあります。
-
バージョン制約： 一部のパラメーターは、各パラメーターテーブルに記載されているとおり、特定のクラスターバージョンが必要です。アップグレードするには、クラスターを手動でアップグレードするをご参照ください。
-
正規のソースとしてのコンソール： コンソールには、カスタマイズ可能なパラメーターの最新の一覧が表示されます。以下の表は、ドキュメントに記載されているデフォルト値を反映しています。
コントロールプレーンコンポーネントのパラメーターのカスタマイズ
すべてのコンポーネントで手順は同じです。この例では kube-apiserver を使用します。
-
コンテナサービス管理コンソールにログインします。左側のナビゲーションペインで、[クラスター]をクリックします。
-
[クラスター] ページで、クラスターの名前をクリックします。左側のナビゲーションペインで、[アドオン] をクリックします。
-
[コアコンポーネント] セクションで、目的のコンポーネントを見つけ、[設定] をクリックします。
-
[パラメーター] ダイアログボックスで、カスタムパラメーターを入力します。設定を確認し、画面の指示に従って送信します。
デフォルト パラメーター
以下の表に、クラスタータイプごとにカスタマイズ可能なパラメーターを示します。パラメーターのセマンティクスと有効な値については、Kubernetes のドキュメント：kube-apiserver、kube-controller-manager、kube-scheduler をご参照ください。
ACK マネージドクラスター Pro Edition
kube-apiserver
| パラメーター | 説明 | 有効範囲/備考 |
|---|---|---|
enableAdmissionPlugins |
追加のアドミッションコントローラープラグインを有効にします。 | デフォルト：空白。クラスターバージョン 1.28 以降が必要です。 |
serviceNodePortRange |
NodePort サービスのポート範囲。 |
10000–65535。デフォルト：空白。
重要
この範囲は、クラスターノード上の |
requestTimeout |
タイムアウトが指定されていない API リクエスト用のグローバルタイムアウト。 | デフォルト：空白 (Kubernetes のデフォルトを使用)。 |
defaultNotReadyTolerationSeconds |
NotReady 状態のノードで、Pod がエビクションされるまでの猶予期間。 | デフォルト：空白。 |
defaultUnreachableTolerationSeconds |
Unreachable 状態のノードで、Pod がエビクションされるまでの猶予期間。 | デフォルト：空白。 |
maxMutatingRequestsInflight |
同時に実行できる変更 API リクエストの最大数。超過したリクエストは拒否されます。 | 1–1000。デフォルト：空白。 |
maxRequestsInflight |
同時に実行できる非変更 API リクエストの最大数。 | 1–3000。デフォルト：空白。 |
featureGates |
Kubernetes のフィーチャーゲートを有効または無効にします。 |
サポートされる値：
ServerSideApply
、
TTLAfterFinished
、
EphemeralContainers
、
RemoveSelfLink
、
HPAScaleToZero
。デフォルト：空白。
説明
|
oidcIssuerURL |
外部 ID プロバイダーと連携するための、OpenID Connect (OIDC) 発行者の URL。 |
デフォルト：空白。クラスターバージョン 1.18 以降が必要です。
重要
このパラメーターを設定すると、kube-apiserver が指定されたアドレスにアクセスします。パブリックエンドポイントの場合は、パブリックネットワークアクセスを有効にしてください。API サーバーがエンドポイントに到達できない場合は、 |
oidcClientId |
OIDC プロバイダーのクライアント ID。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernameClaim |
OIDC ユーザー名の JWT クレーム。 | デフォルト：sub。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernamePrefix |
競合を防ぐための OIDC ユーザー名のプレフィックス。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsPrefix |
OIDC グループ名のプレフィックス。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsClaim |
OIDC ユーザーグループの JWT クレーム。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcRequiredClaim |
OIDC ID トークンに必要なキーと値のペア。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcCAContent |
OIDC プロバイダーを検証するための、PEM エンコードされた認証局 (CA) のコンテンツ。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
hostAliases |
kube-apiserver Pod の /etc/hosts ファイルにおける、ホスト名と IP アドレスのカスタムマッピング。 |
デフォルト：空白。クラスターバージョン 1.26 以降が必要です。 |
enableTrace |
コントロールプレーンコンポーネントの分散トレーシングを有効にします。 | デフォルト：空白。クラスターバージョン 1.28 以降が必要です。詳細については、「コントロールプレーンコンポーネントのトレーシング分析を有効にする」をご参照ください。 |
samplingRatePerMillion |
デフォルト：空白。 |
kube-controller-manager
| パラメーター | 説明 | 有効範囲/備考 |
|---|---|---|
horizontalPodAutoscalerSyncPeriod |
Horizontal Pod Autoscaler (HPA) コントローラーが目的のレプリカ数を再計算する頻度。 | デフォルト：空白 (Kubernetes のデフォルトを使用)。 |
horizontalPodAutoscalerTolerance |
HPA がスケーリングをトリガーする前の最小比率変化。スラッシングを防ぎます。 | デフォルト：空白。 |
concurrentTTLAfterFinishedSyncs |
TTL の有効期限が切れた完了済みジョブをクリーンアップする同時ワーカー数。 | デフォルト：空白。 |
concurrentHorizontalPodAutoscalerSyncs |
HPA 同期の同時ワーカーの数。 | デフォルト：空白。クラスターバージョン 1.26 以降が必要です。 |
largeClusterSizeThreshold |
エビクションにおいてクラスターが「大規模」と見なされるノード数のしきい値。 | デフォルト：空白。 |
unhealthyZoneThreshold |
エビクション率の低下をトリガーするために、ゾーン内で異常と見なされるノードの割合。 | デフォルト：空白。 |
secondaryNodeEvictionRate |
セカンダリ (低減) エビクションモードでのノードエビクション率。 | デフォルト：空白。 |
nodeEvictionRate |
通常のノードエビクション率。 | デフォルト：空白。 |
terminatedPodGCThreshold |
ガベージコレクションをトリガーする終了した Pod の数。 | デフォルト：空白。 |
kubeAPIQPS |
kube-controller-manager から kube-apiserver に対する、1 秒あたりの最大クエリ数 (QPS)。 | 1–1000。デフォルト：空白。 |
kubeAPIBurst |
kube-controller-manager から kube-apiserver に対する、最大リクエストバースト。 | 1–1000。デフォルト：空白。 |
concurrentCSRSyncs |
CertificateSigningRequest (CSR) オブジェクトを処理する同時ワーカー数。 | デフォルト：空白。クラスターバージョン 1.32 以降が必要です。 |
concurrentNodeTaintSyncs |
ノードの Taint 状態を同期する同時ワーカー数。 | デフォルト：空白。クラスターバージョン 1.32 以降が必要です。 |
featureGates |
コントローラーマネージャーのフィーチャーゲートを有効または無効にします。 | サポートされる値：TTLAfterFinished。デフォルト：空白。 |
cloud-controller-manager (CCM)
| パラメーター | 説明 | 有効範囲/備考 |
|---|---|---|
routeTableIDs |
CCM が管理する Virtual Private Cloud (VPC) ルートテーブル ID のリスト (カンマ区切り)。 | デフォルト：空白。VPC に複数のルートテーブルがある場合に設定します。例：vtb-**,vtb***。 |
kube-scheduler
kube-scheduler のパラメーターについては、「スケジューラーパラメーターのカスタマイズ」をご参照ください。
ACK serverless cluster Pro Edition
kube-apiserver
| パラメーター | 説明 | 有効範囲 / 注意事項 |
|---|---|---|
enableAdmissionPlugins |
追加のアドミッションコントローラープラグインを有効にします。 | デフォルト：空白。 |
requestTimeout |
個別のタイムアウトが設定されていない API リクエストに対するグローバルタイムアウト。 | デフォルト：空白 (Kubernetes のデフォルトを使用)。 |
defaultNotReadyTolerationSeconds |
エビクションされるまで、NotReady 状態のノード上でコンテナが実行できる時間。 | デフォルト：空白。 |
defaultUnreachableTolerationSeconds |
エビクションされるまで、Unreachable 状態のノード上でコンテナが実行できる時間。 | デフォルト：空白。 |
maxMutatingRequestsInflight |
同時に処理できる変更 API リクエストの最大数。上限を超えたリクエストは拒否されます。 | 1–1000。デフォルト：空白。 |
maxRequestsInflight |
同時に処理できる非変更 API リクエストの最大数。 | 1–3000。デフォルト：空白。 |
featureGates |
Kubernetes のフィーチャーゲートを有効または無効にします。 |
サポートされている値： ServerSideApply、TTLAfterFinished、EphemeralContainers、RemoveSelfLink、HPAScaleToZero。デフォルト：空白。
説明
|
oidcIssuerURL |
外部 ID プロバイダーとの連携に使用する OIDC イシュアーの URL。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcClientId |
OIDC プロバイダーのクライアント ID。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernameClaim |
OIDC ユーザー名の JWT クレーム。 | デフォルト：sub。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernamePrefix |
競合を防ぐための OIDC ユーザー名のプレフィックス。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsPrefix |
OIDC グループ名のプレフィックス。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsClaim |
OIDC ユーザーグループの JWT クレーム。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcRequiredClaim |
OIDC ID トークン内で必須となるキーと値のペア。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
oidcCAContent |
OIDC プロバイダーの検証に使用する PEM エンコードされた CA コンテンツ。 | デフォルト：空白。クラスターバージョン 1.18 以降が必要です。 |
kube-controller-manager
| パラメーター | 説明 | 有効範囲 / 注意事項 |
|---|---|---|
horizontalPodAutoscalerSyncPeriod |
HPA コントローラーが目的のレプリカ数を再計算する頻度。 | デフォルト：空白 (Kubernetes のデフォルトを使用)。 |
horizontalPodAutoscalerTolerance |
HPA がスケーリングをトリガーするまでに必要な最小の比率変化。 | デフォルト：空白。 |
concurrentTTLAfterFinishedSyncs |
TTL の期限が切れた完了済みジョブをクリーンアップする同時ワーカー数。 | デフォルト：空白。 |
kubeAPIQPS |
kube-controller-manager から kube-apiserver への QPS の最大値。 | 1–1000。デフォルト：空白。 |
kubeAPIBurst |
kube-controller-manager から kube-apiserver へのリクエストバーストの最大値。 | 1–1000。デフォルト：空白。 |
featureGates |
コントローラーマネージャーのフィーチャーゲートを有効または無効にします。 | サポートされている値： TTLAfterFinished。デフォルト：空白。 |
kube-scheduler
kube-scheduler のカスタマイズは、許可リストに登録されたユーザーが利用できます。サポートされているパラメーターについては、スケジューラーパラメーターのカスタマイズをご参照ください。
ACK Edge クラスター Pro 版
kube-apiserver
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
enableAdmissionPlugins |
追加の Admission Controller プラグインを有効にします。 | デフォルト： 空白。 |
serviceNodePortRange |
NodePort サービスのポート範囲。 |
10000–65535。デフォルト： 空白。
重要
この範囲は、クラスターノード上の |
requestTimeout |
特定のタイムアウトが設定されていない API リクエストのグローバルタイムアウト。 | デフォルト： 空白 (Kubernetes のデフォルトを使用)。 |
defaultNotReadyTolerationSeconds |
NotReady 状態のノードで Pod がエビクションされるまでの猶予期間。 | デフォルト： 空白。 |
defaultUnreachableTolerationSeconds |
Unreachable 状態のノードで Pod がエビクションされるまでの猶予期間。 | デフォルト： 空白。 |
maxMutatingRequestsInflight |
同時に実行できる変更 API リクエストの最大数。超過したリクエストは拒否されます。 | 1–1000。デフォルト： 空白。 |
maxRequestsInflight |
同時に実行できる非変更 API リクエストの最大数。 | 1–3000。デフォルト： 空白。 |
featureGates |
Kubernetes のフィーチャーゲートを有効化または無効化します。 |
サポートされる値：
ServerSideApply
、
TTLAfterFinished
、
EphemeralContainers
、
RemoveSelfLink
、
HPAScaleToZero
。デフォルト： 空白。
説明
|
oidcIssuerURL |
外部 ID プロバイダー統合用の OIDC 発行者 URL。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcClientId |
OIDC プロバイダーのクライアントID。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernameClaim |
OIDC ユーザー名の JWT クレーム。 | デフォルト： sub。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernamePrefix |
競合を防ぐための OIDC ユーザー名のプレフィックス。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsPrefix |
OIDC グループ名のプレフィックス。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsClaim |
OIDC ユーザーグループの JWT クレーム。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcRequiredClaim |
OIDC ID トークンに必須のキーと値のペア。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcCAContent |
OIDC プロバイダーを検証するための、PEM 形式でエンコードされた CA コンテンツ。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
kube-controller-manager
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
horizontalPodAutoscalerSyncPeriod |
Horizontal Pod Autoscaler コントローラーが望ましいレプリカ数を再計算する頻度。 | デフォルト： 空白 (Kubernetes のデフォルトを使用)。 |
concurrentTTLAfterFinishedSyncs |
TTL の期限が切れた終了済みジョブをクリーンアップする同時ワーカー数。 | デフォルト： 空白。 |
largeClusterSizeThreshold |
エビクションの際にクラスターが「大規模」と見なされるノード数のしきい値。 | デフォルト： 空白。 |
unhealthyZoneThreshold |
エビクションレートの低下をトリガーする、ゾーン内の異常なノードの割合。 | デフォルト： 空白。 |
secondaryNodeEvictionRate |
セカンダリ (低減) エビクションモードでのノードのエビクションレート。 | デフォルト： 空白。 |
nodeEvictionRate |
通常時のノードのエビクションレート。 | デフォルト： 空白。 |
podEvictionTimeout |
応答しないノード上の Pod がエビクションされるまでの猶予期間。 | デフォルト： 空白。 |
kubeAPIQPS |
kube-controller-manager から kube-apiserver への最大 QPS。 | 1–1000。デフォルト： 空白。 |
kubeAPIBurst |
kube-controller-manager から kube-apiserver への最大リクエストバースト。 | 1–1000。デフォルト： 空白。 |
featureGates |
コントローラーマネージャーのフィーチャーゲートを有効化または無効化します。 | サポートされる値： TTLAfterFinished。デフォルト： 空白。 |
cloud-controller-manager (CCM)
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
routeTableIDs |
CCM が管理する VPC ルートテーブル ID のカンマ区切りリスト。 | デフォルト： 空白。VPC に複数のルートテーブルがある場合に設定します。例： vtb-xxxxxxxx,vtb-yyyyyyyy。 |
kube-scheduler
kube-scheduler のパラメーターについては、スケジューラーパラメーターのカスタマイズをご参照ください。
ACK LINGJUN クラスター
kube-apiserver
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
enableAdmissionPlugins |
追加のアドミッションコントローラープラグインを有効にします。 | デフォルト： 空白。 |
serviceNodePortRange |
NodePort サービスのポート範囲。 |
10000–65535。デフォルト： 空白。
重要
この範囲は、クラスターノード上の |
requestTimeout |
タイムアウトが未設定の API リクエストに対するグローバルタイムアウト。 | デフォルト： 空白 (Kubernetes のデフォルトを使用)。 |
defaultNotReadyTolerationSeconds |
NotReady 状態のノード上で、コンテナがエビクションされるまで実行を継続できる期間。 | デフォルト： 空白。 |
defaultUnreachableTolerationSeconds |
Unreachable 状態のノード上で、コンテナがエビクションされるまで実行を継続できる期間。 | デフォルト： 空白。 |
maxMutatingRequestsInflight |
同時に実行できる変更 API リクエストの最大数。超過したリクエストは拒否されます。 | 1–1000。デフォルト： 空白。 |
maxRequestsInflight |
同時に実行できる非変更 API リクエストの最大数。 | 1–3000。デフォルト： 空白。 |
featureGates |
Kubernetes のフィーチャーゲートを有効または無効にします。 |
サポートされる値： ServerSideApply、 TTLAfterFinished、 EphemeralContainers、 RemoveSelfLink、 HPAScaleToZero。デフォルト： 空白。
説明
|
oidcIssuerURL |
外部 ID プロバイダーとの統合で使用する OIDC 発行者の URL。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcClientId |
OIDC プロバイダーのクライアント ID。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernameClaim |
OIDC ユーザー名の JWT クレーム。 | デフォルト： sub。クラスターバージョン 1.18 以降が必要です。 |
oidcUsernamePrefix |
競合を防ぐための OIDC ユーザー名のプレフィックス。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsPrefix |
OIDC グループ名のプレフィックス。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcGroupsClaim |
OIDC ユーザーグループの JWT クレーム。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcRequiredClaim |
OIDC ID トークンに必要なキーと値のペア。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
oidcCAContent |
OIDC プロバイダーの検証に使用する、PEM 形式でエンコードされた CA コンテンツ。 | デフォルト： 空白。クラスターバージョン 1.18 以降が必要です。 |
kube-controller-manager
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
horizontalPodAutoscalerSyncPeriod |
Horizontal Pod Autoscaler コントローラーが目的のレプリカ数を再計算する頻度。 | デフォルト： 空白 (Kubernetes のデフォルトを使用)。 |
horizontalPodAutoscalerTolerance |
Horizontal Pod Autoscaler がスケーリングをトリガーする最小の比率変化。 | デフォルト： 空白。 |
concurrentTTLAfterFinishedSyncs |
TTL が期限切れとなった終了済みジョブをクリーンアップする同時ワーカーの数。 | デフォルト： 空白。 |
largeClusterSizeThreshold |
エビクションにおいてクラスターが「大規模」と見なされるノード数のしきい値。 | デフォルト： 空白。 |
unhealthyZoneThreshold |
エビクションレートの低下をトリガーする条件となる、ゾーン内の異常なノードの割合。 | デフォルト： 空白。 |
secondaryNodeEvictionRate |
セカンダリ (低減) エビクションモードでのノードのエビクションレート。 | デフォルト： 空白。 |
nodeEvictionRate |
通常のノードのエビクションレート。 | デフォルト： 空白。 |
podEvictionTimeout |
応答しないノード上の Pod のエビクションまでの猶予期間。 | デフォルト： 空白。 |
kubeAPIQPS |
kube-controller-manager から kube-apiserver への最大 QPS。 | 1–1000。デフォルト： 空白。 |
kubeAPIBurst |
kube-controller-manager から kube-apiserver への最大リクエストバースト。 | 1–1000。デフォルト： 空白。 |
featureGates |
コントローラーマネージャーのフィーチャーゲートを有効または無効にします。 | サポートされる値： TTLAfterFinished。デフォルト： 空白。 |
cloud-controller-manager (CCM)
| パラメーター | 説明 | 有効範囲 / 備考 |
|---|---|---|
routeTableIDs |
CCM が管理対象とする VPC ルートテーブル ID のリスト (カンマ区切り)。 | デフォルト： 空白。VPC に複数のルートテーブルがある場合に設定します。例： vtb-bp123456,vtb-bp789012。 |
kube-scheduler
kube-scheduler のパラメーターについては、「スケジューラーパラメーターのカスタマイズ」をご参照ください。