本番環境のニーズに合わせて、Container Service for Kubernetes (ACK) クラスターのコントロールプレーンコンポーネントのパラメーターをカスタマイズできます。 要件に基づいて、kube-apiserver、kube-controller-manager、cloud-controller-manager、および kube-scheduler のパラメーターを変更できます。 このトピックでは、ACK コンソールでコントロールプレーンコンポーネントのパラメーターをカスタマイズする方法について説明します。
使用上の注意
コントロールプレーンの安定性を確保するために、ACK マネージド Pro クラスター、ACK Serverless Pro クラスター、ACK Edge Pro クラスター、およびACK Lingjun クラスターのみが、一部のコアコントロールプレーンコンポーネントパラメーターのカスタム構成をサポートしています。 サポートされているパラメーターは、ACK コンソールによって異なります。
一部のパラメーターは、特定のクラスターバージョンでのみ使用できます。 クラスターをアップグレードするには、「ACK クラスターを手動でアップグレードする」をご参照ください。
パラメーターを変更すると、コントロールプレーンが自動的に再起動されます。 この変更は、オフピーク時に行ってください。
カスタムパラメーターは、デフォルトのクラスターパラメーターをオーバーライドします。 カスタムパラメーターを構成する場合は、次の点に注意してください。
パラメーターの精度と完全性を確保する
コントロールプレーンの起動エラーを防ぐために構文を確認する
パラメーターの仕様については、Kubernetes の公式ドキュメントをご参照ください。 kube-apiserver 、 kube-controller-manager 、および kube-scheduler 。
コントロールプレーンコンポーネントのパラメーターをカスタマイズする
さまざまなコンポーネントのパラメーターをカスタマイズする手順は似ています。 次の例は、kube-apiserver のパラメーターをカスタマイズする方法を示しています。
ACK コンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。
[クラスター] ページで、管理するクラスターを見つけて、その名前をクリックします。 左側のナビゲーションウィンドウで、 を選択します。
コアコンポーネント セクションで、コンポーネントを見つけて、カードの右下隅にある 設定 をクリックします。
[Kube Scheduler パラメーター] ダイアログボックスで、パラメーターを構成し、パラメーターの値が有効で完全であることを確認します。 ページの指示に従って構成を送信します。
デフォルトパラメーター
ACK マネージド Pro クラスター
コンポーネント | パラメーター | 説明 |
Kube API Server | enableAdmissionPlugins | デフォルトでは、このパラメーターは空です。 |
serviceNodePortRange | 有効値：10000 ～ 65535。 デフォルトでは、このパラメーターは空のままです。 重要 ノードポートの範囲を変更する場合は注意してください。 ノードポートの範囲が、クラスターノード上の Linux カーネルの | |
requestTimeout | デフォルトでは、このパラメーターは空です。 | |
defaultNotReadyTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
defaultUnreachableTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
maxMutatingRequestsInflight | 有効値：1 ～ 1000。 デフォルトでは、このパラメーターは空のままです。 | |
maxRequestsInflight | 有効値：1 ～ 3000。 デフォルトでは、このパラメーターは空のままです。 | |
featureGates | 以下のオプションがサポートされています： 説明
| |
oidcIssuerURL | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 重要
| |
oidcClientId | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcUsernameClaim | デフォルト値： | |
oidcUsernamePrefix | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsPrefix | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsClaim | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcRequiredClaim | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcCAContent | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
hostAliases | このパラメーターはデフォルトでは空で、Kubernetes 1.26 以降でサポートされています。 | |
enableTrace | このパラメーターはデフォルトでは空で、Kubernetes 1.28 以降でサポートされています。 詳細については、「コントロールプレーンコンポーネントのトレースを有効にする」をご参照ください。 | |
100 万件あたりのサンプリングレート | ||
Kube Controller Manager | horizontalPodAutoscalerSyncPeriod | デフォルトでは、このパラメーターは空です。 |
horizontalPodAutoscalerTolerance | デフォルトでは、このパラメーターは空です。 | |
concurrentTTLAfterFinishedSyncs | デフォルトでは、このパラメーターは空です。 | |
concurrentHorizontalPodAutoscalerSyncs | このパラメーターはデフォルトでは空で、Kubernetes 1.26 以降でサポートされています。 | |
largeClusterSizeThreshold | デフォルトでは、このパラメーターは空です。 | |
unhealthyZoneThreshold | デフォルトでは、このパラメーターは空のままです。 | |
secondaryNodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
nodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
terminatedPodGCThreshold | デフォルトでは、このパラメーターは空のままです。 | |
kubeAPIQPS | 有効な値：1 ～ 1000。デフォルトでは、このパラメーターは空のままです。 | |
kubeAPIBurst | 有効な値：1～1000。 デフォルトでは、このパラメーターは空のままです。 | |
concurrentCSRSyncs | このパラメーターはデフォルトでは空で、Kubernetes 1.32 以降でサポートされています。 | |
concurrentNodeTaintSyncs | このパラメーターはデフォルトでは空で、Kubernetes 1.32 以降でサポートされています。 | |
featureGates |
| |
Cloud Controller Manager | routeTableIDs | デフォルトでは、このパラメーターは空のままです。クラスターが存在する仮想プライベートクラウド ( VPC ) に複数のルートテーブルがある場合は、カンマ ( , ) で区切られた複数のルートテーブル ID を指定できます。例： |
Kube Scheduler | kube-scheduler のパラメーターをカスタマイズする方法の詳細については、「kube-scheduler のカスタム パラメーター」をご参照ください。 | |
ACK Serverless Pro クラスター
コンポーネント | パラメーター | 説明 |
Kube API Server | enableAdmissionPlugins | デフォルトでは、このパラメーターは空です。 |
requestTimeout | デフォルトでは、このパラメーターは空です。 | |
defaultNotReadyTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
defaultUnreachableTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
maxMutatingRequestsInflight | 有効な値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
maxRequestsInflight | 有効な値：1～3000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates | 以下のオプションがサポートされています： 説明
| |
oidcIssuerURL | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcClientId | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcUsernameClaim | デフォルト値： | |
oidcUsernamePrefix | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsPrefix | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsClaim | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcRequiredClaim | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcCAContent | このパラメーターはデフォルトで空で、Kubernetes 1.18 以降でサポートされています。 | |
Kube Controller Manager | horizontalPodAutoscalerSyncPeriod | デフォルトでは、このパラメーターは空です。 |
horizontalPodAutoscalerTolerance | デフォルトでは、このパラメーターは空です。 | |
concurrentTTLAfterFinishedSyncs | デフォルトでは、このパラメーターは空です。 | |
kubeAPIQPS | 有効な値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
kubeAPIBurst | 有効な値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates |
| |
Kube Scheduler | 複数のパラメーター。ホワイトリストに含まれている場合のみ、パラメーターをカスタマイズできます。 | kube-scheduler のパラメーターをカスタマイズする方法の詳細については、「kube-scheduler のカスタムパラメーター」をご参照ください。 |
ACK Edge Pro クラスタ
コンポーネント | パラメーター | 説明 |
Kube API Server | enableAdmissionPlugins | デフォルトでは、このパラメーターは空です。 |
serviceNodePortRange | 有効値：10000～65535。デフォルトでは、このパラメーターは空のままです。 重要 ノードポート範囲を変更する場合は注意が必要です。ノードポート範囲が、クラスタ内のノード上の Linux の | |
requestTimeout | デフォルトでは、このパラメーターは空です。 | |
defaultNotReadyTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
defaultUnreachableTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
maxMutatingRequestsInflight | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
maxRequestsInflight | 有効値：1～3000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates | サポートされているオプションは、 説明
| |
oidcIssuerURL | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcClientId | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcUsernameClaim | デフォルト値： | |
oidcUsernamePrefix | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsPrefix | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsClaim | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcRequiredClaim | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
oidcCAContent | このパラメーターはデフォルトで空であり、Kubernetes 1.18 以降でサポートされています。 | |
Kube Controller Manager | horizontalPodAutoscalerSyncPeriod | デフォルトでは、このパラメーターは空です。 |
concurrentTTLAfterFinishedSyncs | デフォルトでは、このパラメーターは空です。 | |
largeClusterSizeThreshold | デフォルトでは、このパラメーターは空です。 | |
unhealthyZoneThreshold | デフォルトでは、このパラメーターは空です。 | |
secondaryNodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
nodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
podEvictionTimeout | デフォルトでは、このパラメーターは空です。 | |
kubeAPIQPS | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
kubeAPIBurst | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates |
| |
Cloud Controller Manager | routeTableIDs | デフォルトでは、このパラメーターは空のままです。クラスタが存在する VPC に複数のルートテーブルがある場合は、カンマ (,) で区切られた複数のルートテーブル ID を指定できます。例： |
Kube Scheduler | kube-scheduler のパラメーターをカスタマイズする方法の詳細については、「kube-scheduler のカスタムパラメーター」をご参照ください。 | |
ACK Lingjun クラスター
コンポーネント | パラメーター | 説明 |
Kube API Server | enableAdmissionPlugins | デフォルトでは、このパラメーターは空です。 |
serviceNodePortRange | 有効値：10000～65535。デフォルトでは、このパラメーターは空のままです。 重要 ノードポート範囲を変更する場合は注意してください。ノードポート範囲がクラスターノード上の Linux カーネルの | |
requestTimeout | デフォルトでは、このパラメーターは空です。 | |
defaultNotReadyTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
defaultUnreachableTolerationSeconds | デフォルトでは、このパラメーターは空です。 | |
maxMutatingRequestsInflight | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
maxRequestsInflight | 有効値：1～3000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates | 以下のオプションがサポートされています： 説明
| |
oidcIssuerURL | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcClientId | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcUsernameClaim | デフォルト値： | |
oidcUsernamePrefix | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsPrefix | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcGroupsClaim | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcRequiredClaim | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
oidcCAContent | このパラメーターはデフォルトでは空で、Kubernetes 1.18 以降でサポートされています。 | |
Kube Controller Manager | horizontalPodAutoscalerSyncPeriod | デフォルトでは、このパラメーターは空です。 |
horizontalPodAutoscalerTolerance | デフォルトでは、このパラメーターは空です。 | |
concurrentTTLAfterFinishedSyncs | デフォルトでは、このパラメーターは空です。 | |
largeClusterSizeThreshold | デフォルトでは、このパラメーターは空です。 | |
unhealthyZoneThreshold | デフォルトでは、このパラメーターは空です。 | |
secondaryNodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
nodeEvictionRate | デフォルトでは、このパラメーターは空です。 | |
podEvictionTimeout | デフォルトでは、このパラメーターは空です。 | |
kubeAPIQPS | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
kubeAPIBurst | 有効値：1～1000。デフォルトでは、このパラメーターは空のままです。 | |
featureGates |
| |
Cloud Controller Manager | routeTableIDs | デフォルトでは、このパラメーターは空のままです。クラスターが存在する VPC に複数のルートテーブルがある場合は、コンマ（,）で区切られた複数のルートテーブル ID を指定できます。例： |
Kube Scheduler | kube-scheduler のパラメーターをカスタマイズする方法の詳細については、「kube-scheduler のカスタムパラメーター」をご参照ください。 | |