Container Service for Kubernetes:CreateClusterNodePool

ノードプールの名前。

ノードプールのタイプ。有効な値:

• ess: 通常ノードプール (マネージド特徴と弾力的スケーリングを含む)。

• edge: エッジノードプール。

• lingjun: Lingjun ノードプール。

• hybrid: ハイブリッドクラウドノードプール。

ノードプールのリソースグループ ID。ノードプールによってスケールアウトされたインスタンスは、このリソースグループに属します。

リソースは 1 つのリソースグループにのみ属することができます。ビジネスシナリオに応じて、リソースグループをプロジェクト、アプリケーション、組織などの概念にマッピングできます。

自動スケーリングを有効にするかどうかを指定します。有効な値:

• true: ノードプールの自動スケーリング特徴を有効にします。クラスターの容量計画がアプリケーション Pod のスケジューリング要件を満たせない場合、ACK は設定された最小値および最大値インスタンス数に基づいてノードリソースを自動的にスケーリングします。バージョン 1.24 以降のクラスターでは、デフォルトで即時ノードスケーリングが有効になります。1.24 より前のバージョンのクラスターでは、デフォルトで自動ノードスケーリングが有効になります。詳細については、「ノードスケーリング」を参照してください。

• false: 自動スケーリングを無効にします。ACK は、設定された希望ノード数に基づいてノードプール内のノード数を調整し、ノード数を希望値に維持します。

値が false の場合、auto_scaling 内の他の構成パラメーターは効果を持ちません。

デフォルト値: false。

弾力的スケーリングのインスタンスタイプ。このパラメーターは enable=true の場合にのみ効果があります。有効な値:

• cpu: 通常のインスタンスタイプ。

• gpu: GPU インスタンスタイプ。

• gpushare: GPU 共有タイプ。

• spot: スポットインスタンスタイプ。

デフォルト値: cpu。

既存のインスタンスを除く、ノードプール内のスケーラブルなインスタンスの最大値。このパラメーターは enable=true の場合にのみ効果があります。

有効値: [min_instances, 2000]。デフォルト値: 0。

既存のインスタンスを除く、ノードプール内のスケーラブルなインスタンスの最小値。このパラメーターは enable=true の場合にのみ効果があります。

有効値: [0, max_instances]。デフォルト値: 0。

[非推奨] このパラメーターは非推奨です。代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

EIP を関連付けるかどうかを指定します。有効な値:

• true: EIP を関連付けます。

• false: EIP を関連付けません。

デフォルト値: false。

[非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

EIP の課金方法。有効な値:

• PayByBandwidth: 帯域幅課金。

• PayByTraffic: トラフィック課金。

デフォルト値: PayByBandwidth。

[非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

EIP のピーク帯域幅。単位: Mbit/s。

マネージドノードプール機能を有効にするかどうかを指定します。有効な値:

• true: 有効。

• false: 無効。他の関連構成は、enable が true に設定されている場合にのみ有効になります。

デフォルト値: false。

ノードの自動修復を有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効です。

• true: 有効。

• false: 無効。

デフォルト値: true。

CVE 脆弱性の自動修復を有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効です。

• true: CVE の自動修復が有効です。

• false: CVE の自動修復が無効です。

デフォルト値: true。

ノードの自動アップグレードを有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効です。

• true: 自動アップグレードが有効です。

• false: 自動アップグレードが無効です。

デフォルト値: true。

ノードの自己修復のために ECS 障害検出を有効にするかどうかを指定します。

ノードローテーションを有効にするかどうかを指定します。インテリジェントマネージドノードプールのみがこの機能をサポートしており、デフォルトで有効になっています。通常のノードプールはこの機能をサポートしていません。

ノードプール内のノードの課金方法。有効な値:

• PrePaid: サブスクリプション。

• PostPaid: 従量課金。

デフォルト値: PostPaid。

ノードプール内のノードのサブスクリプション期間。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用され、必須となります。

• period_unit=Week の場合、period の有効な値: {1, 2, 3, 4}。

• period_unit=Month の場合、period の有効な値: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}。

ノードプール内のノードの課金エポック。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用され、必須となります。

• Month: 計算ユニット (CU) として月を使用します。

• Week: 計算ユニット (CU) として週を使用します。

デフォルト値: Month。

ノードプール内のノードの自動更新を有効にするかどうかを指定します。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用されます。有効な値:

• true: 自動更新を有効にします。

• false: 自動更新を無効にします。

デフォルト値: false。

1 回の更新あたりの自動更新期間。有効な値:

• PeriodUnit=Week: 1、2、3。

• PeriodUnit=Month: 1、2、3、6、12、24、36、48、60。

デフォルト値: 1。

スポットインスタンスのタイプ。有効な値:

• NoSpot: 非スポットインスタンス。

• SpotWithPriceLimit: 値幅制限付きスポットインスタンス。

• SpotAsPriceGo: システムが現在の市場価格で自動的に呼び出しを行います。

詳細については、「スポットインスタンス」を参照してください。

オペレーティングシステムイメージのタイプ。有効な値:

• AliyunLinux: Alinux2 イメージ。

• AliyunLinuxSecurity: Alinux2 UEFI イメージ。

• AliyunLinux3: Alinux3 イメージ。

• AliyunLinux3Arm64: Alinux3 ARM イメージ。

• AliyunLinux3Security: Alinux3 UEFI イメージ。

• CentOS: CentOS イメージ。

• Windows: Windows イメージ。

• WindowsCore: WindowsCore イメージ。

• ContainerOS: コンテナ最適化イメージ。

• AliyunLinux3ContainerOptimized: Alinux3 コンテナ最適化イメージ。

カスタムイメージ ID。デフォルトでは、システム提供のイメージが使用されます。

ノードのシステムクラウドディスクのタイプ。有効な値:

• cloud_efficiency: Ultra クラウドディスク。

• cloud_ssd: 標準 SSD。

• cloud_essd: ESSD。

• cloud_auto: ESSD AutoPL クラウドディスク。

• cloud_essd_entry: ESSD Entry クラウドディスク。

デフォルト値: cloud_efficiency。

ノードのシステムクラウドディスクのサイズ。単位: GiB。

有効な値: [20,2048]。

ノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ効果が適用されます。パフォーマンスレベルはクラウドディスクのサイズによって異なります。詳細については、「ESSD クラウドディスク」を参照してください。

• PL0: 中程度の最大値同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

• PL1: 中程度の最大値同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

• PL2: 高い最大値同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが安定しています。

• PL3: 超高い最大値同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが非常に安定しています。

システムクラウドディスクを暗号化するかどうかを指定します。有効な値:

• true: システムクラウドディスクを暗号化します。

• false: システムクラウドディスクを暗号化しません。

システムクラウドディスクで使用される KMS キー ID。

システムクラウドディスクを暗号化する際に使用される暗号化アルゴリズム。有効な値: aes-256。

ノードのシステムクラウドディスクのバースト (バースト機能) を有効にするかどうかを指定します。有効な値:

• true: バーストを有効にします。

• false: バーストを無効にします。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

ノードのシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。

有効な値: 0 ～ min{50,000, 1000 × capacity - ベースラインパフォーマンス}。ベースラインパフォーマンス = min{1,800 + 50 × capacity, 50000}。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

パスワードなしログイン用のキーペアの名前。このパラメーターまたは login_password のいずれかを使用します。

SSH ログインパスワード。このパラメーターまたは key_pair のいずれかを使用します。パスワードの長さは 8～30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

スケールアウトされた ECS インスタンスが非ルートユーザーでログインするかどうかを指定します。

• true: 非ルートユーザー (ecs-user) としてログインします。

• false: ルートユーザーとしてログインします。

[非推奨] 代わりに security_hardening_os パラメーターを使用してください。

MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。この特徴は、システムイメージが Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 の場合にのみ有効にできます。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 の MLPS 2.0 Level 3 イメージに対して、等級保護コンプライアンスベースラインチェック基準およびスキャンプログラムを提供しています。

Alibaba Cloud OS セキュリティ強化を有効にするかどうかを指定します。有効な値:

• true: Alibaba Cloud OS セキュリティ強化を有効にします。

• false: Alibaba Cloud OS セキュリティ強化を無効にします。

デフォルト値: false。

パブリック IP アドレスの課金方法。有効な値:

• PayByBandwidth: 固定帯域幅課金。

• PayByTraffic: トラフィック使用量課金。

ノードの最大値アウトバウンドパブリック帯域幅。単位: Mbit/s (メガビット毎秒)。有効な値: [1,100]。

ノードプール内の希望ノード数。

ノードプールが維持すべきノードの総数です。クラスターコンポーネントが正常に動作することを保証するため、少なくとも 2 つのノードを設定することを推奨します。希望ノード数を調整することで、ノードプールをスケールインまたはスケールアウトできます。

ノードを作成する必要がない場合は、このパラメーターを 0 に設定します。後で値を手動で調整してノードを追加できます。

スケーリンググループ内の ECS インスタンスのマルチゾーンスケーリングポリシー。有効な値:

• PRIORITY: 定義した vSwitch (VSwitchIds.N) に基づいてインスタンスをスケーリングします。優先度が最も高い vSwitch のゾーンで ECS インスタンスを作成できない場合、システムは自動的に次に優先度の高い vSwitch を使用して ECS インスタンスを作成します。

• COST_OPTIMIZED: vCPU の単位価格が低い順にインスタンスの作成を試みます。スケーリング設定でプリエンプティブル課金方法の複数のインスタンスタイプが指定されている場合、スポットインスタンスが最初に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足などの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスの作成を自動的に試行するかどうかを指定できます。

  説明

  COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプが指定されているか、スポットインスタンスが使用されている場合にのみ効果が得られます。

• BALANCE: スケーリンググループで指定されたゾーン全体に ECS インスタンスを均等に割り当てます。在庫不足などの理由でゾーンのバランスが崩れた場合は、 RebalanceInstances API 操作を呼び出してリソースの再バランスを実行できます。

デフォルト値: PRIORITY。

スケーリンググループモード。有効な値:

• release: 標準モード。リソース使用量に基づいて ECS インスタンスを作成およびリリースすることでインスタンスをスケーリングします。

• recycle: 高速モード。ECS インスタンスの作成、停止、開始を行うことでインスタンスをスケーリングし、後続のスケーリング操作の速度を向上させます。停止期間中はコンピューティングリソースに対して課金されません。ローカルディスクを持つインスタンスを除き、ストレージ料金のみが課金されます。

デフォルト値: release。

スケーリンググループに必須の従量課金インスタンスの最小値。有効な値: [0,1000]。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが最初に作成されます。

スケーリンググループ内で従量課金インスタンスの最小値 (on_demand_base_capacity) を超える追加インスタンスのうち、従量課金インスタンスが占める割合。有効な値: [0,100]。

利用可能なインスタンスタイプの数。スケーリンググループは、複数のタイプのスポットインスタンスを最低コストで作成します。有効な値: [1,10]。

スポットインスタンスの補充を有効にするかどうかを指定します。有効にすると、システムがスポットインスタンスの回収通知を受信した際に、スケーリンググループは新しいインスタンスを作成して回収されるスポットインスタンスを置き換えようとします。有効な値:

• true: スポットインスタンスの補充を有効にします。

• false: スポットインスタンスの補充を無効にします。

multi_az_policy が COST_OPTIMIZED にセットされており、コスト、在庫、またはその他の理由でスポットインスタンスを作成できない場合に、必須の ECS インスタンス数を満たすために従量課金インスタンスの自動作成を許可するかどうかを指定します。有効な値:

• true: 必須の ECS インスタンス数を満たすために従量課金インスタンスの自動作成を許可します。

• false: 必須の ECS インスタンス数を満たすための従量課金インスタンスの自動作成を許可しません。

高密度クラウドディスクモードを有効にするかどうかを指定します。これは、ノードプールがインスタンスタイプを使用している場合にのみサポートされます。有効にすると、システムクラウドディスクとデータクラウドディスクの総数は、インスタンスタイプがサポートする高密度クラウドディスクの最大値を超えません。

デプロイメントセット ID。デプロイメントセットを使用して、ノードプールによってスケールアウトされた ECS インスタンスを異なる物理サーバーに分散配置し、高可用性と基盤となるディザスタリカバリを確保できます。デプロイメントセット内で ECS インスタンスが作成されると、事前に設定されたデプロイメントポリシーに基づいて指定されたリージョンで起動されます。

ノードプールのセキュリティグループ ID。このパラメーターまたは security_group_ids のいずれかを使用します。security_group_ids の使用を推奨します。

[非推奨] 代わりに image_type パラメーターを使用してください。

オペレーティングシステムのディストリビューション。有効な値:

• CentOS

• AliyunLinux

• Windows

• WindowsCore

デフォルト値: AliyunLinux。

Worker RAM ロール名。

• 空の場合、クラスターによって作成されたデフォルトの Worker RAM ロールが使用されます。

• 指定する場合、RAM ロールは信頼できるサービスが Elastic Compute Service に設定された通常のサービスロールである必要があります。詳細については、「通常のサービスロールの作成」を参照してください。指定された RAM ロールがクラスターによって作成されたデフォルトの Worker RAM ロールではない場合、ロール名は KubernetesMasterRole- または KubernetesWorkerRole- で始まることはできません。

ECS インスタンスのインスタンスメタデータアクセス構成。

システムクラウドディスクのスナップショットポリシー。

Kubelet のパラメータ設定。

コンテナランタイム名。ACK は以下の 3 つのコンテナランタイムをサポートしています。

• containerd: 推奨。すべてのクラスターバージョンでサポートされています。

• Sandboxed-Container.runv: より高い隔離性を提供するサンドボックスコンテナ。バージョン 1.31 以前のクラスターでサポートされています。

• docker: 保守終了。バージョン 1.22 以前のクラスターでサポートされています。

デフォルト値: containerd。

コンテナランタイムバージョン。

ノードの CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下の 2 つのポリシーがサポートされています。

• static: ノード上で特定のリソース特徴を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。静的ポリシーです。

• none: 既存のデフォルト CPU アフィニティスキームを有効にします。エラーが発生した場合のフォールバックとして使用されます。

デフォルト値: none。

インスタンスのユーザーデータ。ノードがクラスターに参加した後、指定されたユーザーデータスクリプトが実行されます。詳細については、「ユーザーデータスクリプト」を参照してください。

スケールアウト後にノードをスケジュール不可にするかどうかを指定します。

• true: スケジュール不可。

• false: スケジュール可能。

ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。インストール後、CloudMonitor コンソールで作成された ECS インスタンスのモニタリング情報をビューで確認できます。この特徴を有効にすることを推奨します。エラー検出にも役立ちます。有効な値:

• true: ECS ノードに CloudMonitor エージェントをインストールします。

• false: ECS ノードに CloudMonitor エージェントをインストールしません。

デフォルト値: false。

カスタムノード名。ノード名をカスタマイズすると、ノード名、ECS インスタンス名、および ECS インスタンスのホスト名がすべてそれに応じて変更されます。

ノード名は、プレフィックス、ノード IP アドレス、サフィックスの 3 つの部分で構成されます。

• 全体の長さは 2 ～ 64 文字です。ノード名は小文字または数字で始まり、小文字または数字で終わる必要があります。

• プレフィックスとサフィックスには、大文字と小文字、数字、ハイフン (-)、ピリオド (.) を使用できます。これらは大文字または小文字で始まる必要があり、ハイフン (-) またはピリオド (.) で開始または終了することはできません。連続したハイフン (-) またはピリオド (.) は使用できません。

• プレフィックスは必須です (ECS の制限)。サフィックスは任意のオプションです。

• ノード IP は、ノードの完全なプライベートネットワーク IP アドレスです。

例: ノード IP アドレスが 192.XX.YY.55、プレフィックスが aliyun.com、サフィックスが test の場合:

• Linux ノードの場合、ノード名、ECS インスタンス名、および ECS インスタンスのホスト名はすべて aliyun.com192.XX.YY.55test になります。

• Windows ノードの場合、ECS インスタンスのホスト名は 192-XX-YY-55 となり、ノード名と ECS インスタンス名はどちらも aliyun.com192.XX.YY.55test になります。

インスタンスの事前ユーザーデータ。ノードがクラスターに参加する前に、指定された事前ユーザーデータスクリプトが実行されます。詳細については、「ユーザーデータスクリプト」を参照してください。

クラスターの機密コンピューティングを有効にするかどうかを指定します。

• true: 機密コンピューティングを有効にします。

• false: 機密コンピューティングを有効にしません。

[非推奨]

強化型エッジノードプールにバインドされた Cloud Enterprise Network (CEN) インスタンスの ID。

[非推奨]

強化型エッジノードプールにバインドされた Cloud Connect Network (CCN) インスタンスの ID。

[非推奨]

強化型エッジノードプールにバインドされた Cloud Connect Network (CCN) インスタンスのリージョン。

[非推奨]

強化型エッジノードプールのネットワーク帯域幅。単位: Mbps。

[非推奨]

強化型エッジノードプールの購入期間。単位: 月。

Lingjun ノードプールを作成する際に関連付ける Lingjun クラスターの ID。

Lingjun ノードプールを作成する際に関連付ける Lingjun クラスターの Lingjun グループ ID。

Lingjun ノードプールの自動ノード追加を有効にするかどうかを指定します。

Lingjun ノードプールで使用される Worker RAM ロール。

インテリジェントマネージドモードを有効にするかどうかを指定します。 有効な値:

• true: インテリジェントマネージドモードを有効にします。これは、クラスターでインテリジェントマネージドモードが有効になっている場合にのみ有効にできます。

• false: インテリジェントマネージドモードを有効にしません。