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: 月を課金単位として使用します。

• Week: 週を課金単位として使用します。

デフォルト値: Month。

ノードプール内のノードの自動更新を有効にするかどうかを指定します。instance_charge_type が PrePaid に設定されている場合にのみ有効です。有効な値:

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

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

デフォルト値: false。

各自動更新サイクルの期間。有効な値:

• 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: ウルトラクラウドディスク。

• 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-baseline performance}。ベースラインパフォーマンス=min{1,800+50*capacity, 50000}。

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

パスワードなしログイン用のキーペアの名前。login_password とは相互排他です。

SSH ログインパスワード。key_pair とは相互排他です。パスワードの長さは 8〜30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

非 root ユーザーとして ECS インスタンスにログインするかどうかを指定します。

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

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

[非推奨] 代わりに 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 レベル 3 イメージに対して、等級保護コンプライアンスベースラインチェック基準とスキャンプログラムを提供しています。

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

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

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

デフォルト値: false。

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

• PayByBandwidth: 帯域幅課金。

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

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

ノードプールの希望するノード数。

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

設定しない場合。

The multi-zone scaling policy for ECS instances in the scaling group. Valid values:

• PRIORITY: Scales based on the vSwitches (VSwitchIds.N) you define. When ECS instances cannot be created in the zone of a higher-priority vSwitch, the next-priority vSwitch is automatically used.

• COST_OPTIMIZED: Attempts to create instances in order of vCPU unit price from lowest to highest. When the scaling configuration settings include multiple instance types with the spot billable methods, spot instances are created first. You can use the CompensateWithOnDemand parameter to specify whether to automatically attempt to create pay-as-you-go instances when spot instances cannot be created due to insufficient inventory.

  説明

  COST_OPTIMIZED takes effect only when the scaling configuration settings include multiple instance types or use spot instances.

• BALANCE: Evenly allocates ECS instances across the multiple active zones specified in the scaling group. If zones become unbalanced due to insufficient inventory, you can call the RebalanceInstances API operation to rebalance resources.

Default value: PRIORITY.

The scaling group mode. Valid values:

• release: Standard mode. Scales by creating and releasing ECS instances based on resource usage.

• recycle: Swift mode. Scales by creating, stopping, and starting instances, which improves the speed of subsequent scaling operations. Stopped instances are not charged for compute resources, only for storage. This does not apply to instances with local disks.

Default value: release.

The minimum number of pay-as-you-go instances required in the scaling group. Valid values: [0,1000]. Pay-as-you-go instances are created first when the number of pay-as-you-go instances is less than this value.

The percentage of pay-as-you-go instances among the extra instances that exceed the minimum number of pay-as-you-go instances (on_demand_base_capacity). Valid values: [0,100].

The number of available instance types. The scaling group creates spot instances across the lowest-cost instance types in a balanced manner. Valid values: [1,10].

Specifies whether to enable supplementing spot instances. When enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed. Valid values:

• true: Enables supplementing spot instances.

• false: Disables supplementing spot instances.

When multi_az_policy is set to COST_OPTIMIZED, specifies whether to allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances when spot instances cannot be created due to price or inventory reasons. Valid values:

• true: Allows automatic creation of pay-as-you-go instances to meet the required number of ECS instances.

• false: Does not allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances.

The deployment set ID. You can use a deployment set to distribute ECS instances scaled out by the node pool across different physical servers, ensuring high availability and underlying disaster recovery. When creating ECS instances within a deployment set, instances are distributed across the specified region based on the pre-configured deployment strategy.

The security group ID of the node pool. Use either this parameter or security_group_ids. We recommend that you use security_group_ids.

[This field is deprecated] Use the image_type parameter instead.

The operating system distribution. Valid values:

• CentOS

• AliyunLinux

• Windows

• WindowsCore

Default value: AliyunLinux.

The Worker RAM role name.

• If empty, the default Worker RAM role created by the cluster is used.

• If specified, the RAM role must be a normal service role with its trusted service configured as Elastic Compute Service. For more information, see Create a normal service role. When the specified RAM role is not the default Worker RAM role created by the cluster, the role name cannot start with KubernetesMasterRole- or KubernetesWorkerRole-.

The ECS instance metadata access configuration.

The system cloud disk snapshot policy.

The Kubelet parameter settings.

The container runtime name. ACK supports the following three container runtimes:

• containerd: Recommended. Supports all cluster versions.

• Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supports cluster versions 1.31 and earlier.

• docker: No longer maintained. Supports cluster versions 1.22 and earlier.

Default value: containerd.

The container runtime version.

The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later:

• static: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.

• none: Enables the existing default CPU affinity scheme.

Default value: none.

The instance user data. After the node joins the cluster, the specified instance user data script is executed. For more information, see User-Data scripts.

Specifies whether scaled-out nodes are unschedulable.

• true: Unschedulable.

• false: Schedulable.

Specifies whether to install the CloudMonitor agent on ECS nodes. After installation, you can view monitoring information for the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values:

• true: Installs the CloudMonitor agent on ECS nodes.

• false: Does not install the CloudMonitor agent on ECS nodes.

Default value: false.

The custom node name. After you customize the node name, the node name, ECS instance name, and ECS instance hostname are all changed.

The node name consists of a prefix, the node IP address, and a suffix:

• The total length is 2 to 64 characters. The node name must start and end with a lowercase letter or digit.

• The prefix and suffix can contain uppercase and lowercase letters, digits, hyphens (-), and periods (.). They must start with an uppercase or lowercase letter and cannot start or end with a hyphen (-) or period (.). Consecutive hyphens (-) or periods (.) are not allowed.

• The prefix is required (ECS restriction). The suffix is optional.

• The node IP is the full private IP address of the node.

Example: The node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test.

• For Linux nodes, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test.

• For Windows nodes, the ECS instance hostname is 192-XX-YY-55, and the node name and ECS instance name are both aliyun.com192.XX.YY.55test.

The instance pre-custom data. Before the node joins the cluster, the specified pre-custom data script is executed. For more information, see User-Data scripts.

Specifies whether to enable confidential computing for the cluster.

• true: Enables confidential computing.

• false: Does not enable confidential computing.

[This field is deprecated]

The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.

[This field is deprecated]

The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool.

[This field is deprecated]

The region of the Cloud Connect Network instance bound to the enhanced edge node pool.

[This field is deprecated]

The network bandwidth of the enhanced edge node pool. Unit: Mbit/s.

[This field is deprecated]

The subscription duration of the enhanced edge node pool. Unit: months.

The Lingjun cluster ID to associate when creating a Lingjun node pool.

The Lingjun group ID of the Lingjun cluster to associate when creating a Lingjun node pool.

Specifies whether to enable automatic node addition for the Lingjun node pool.

The Worker RAM role used by the Lingjun node pool.

Specifies whether to enable intelligent managed mode. Valid values:

• true: Enables intelligent managed mode. This can be enabled only when the cluster has intelligent managed mode enabled.

• false: Does not enable intelligent managed mode.