From edc42876156de3f00cf08ddaad44817f99b3c527 Mon Sep 17 00:00:00 2001 From: wangzepeng666 Date: Thu, 7 Sep 2023 20:01:31 +0800 Subject: [PATCH] docs(cce): fix docs issues. --- docs/data-sources/cce_addon_template.md | 15 +++- docs/data-sources/cce_cluster_v3.md | 19 ++-- docs/data-sources/cce_clusters.md | 18 ++-- docs/data-sources/cce_node_ids_v3.md | 7 +- docs/data-sources/cce_node_v3.md | 20 +++-- docs/resources/cce_addon_v3.md | 13 ++- docs/resources/cce_cluster_v3.md | 85 +++++++++++------- docs/resources/cce_node_pool_v3.md | 35 +++++--- docs/resources/cce_node_v3.md | 110 ++++++++++++++---------- 9 files changed, 207 insertions(+), 115 deletions(-) diff --git a/docs/data-sources/cce_addon_template.md b/docs/data-sources/cce_addon_template.md index 963eade6b..9bb5b688f 100644 --- a/docs/data-sources/cce_addon_template.md +++ b/docs/data-sources/cce_addon_template.md @@ -24,6 +24,9 @@ data "flexibleengine_cce_addon_template" "test" { The following arguments are supported: +* `region` - (Optional, String) The region in which to query the data source. If omitted, the provider-level region + will be used. + * `cluster_id` - (Required, String) Specifies the ID of CCE cluster. * `name` - (Required, String) Specifies the add-on name. The supported addons are as follows: @@ -42,7 +45,7 @@ The following arguments are supported: * `version` - (Required, String) Specifies the add-on version. -## Attributes Reference +## Attribute Reference In addition to all arguments above, the following attributes are exported: @@ -54,6 +57,12 @@ In addition to all arguments above, the following attributes are exported: * `stable` - Whether the add-on template is a stable version. -* `support_version/virtual_machine` - The cluster (Virtual Machine) version that the add-on template supported. +* `support_version` - The cluster information. +The [support_version](#cce_support_version) object structure is documented below. + + +The `support_version` block supports: + +* `virtual_machine` - The cluster (Virtual Machine) version that the add-on template supported. -* `support_version/bare_metal` - The cluster (Bare Metal) version that the add-on template supported. +* `bare_metal` - The cluster (Bare Metal) version that the add-on template supported. diff --git a/docs/data-sources/cce_cluster_v3.md b/docs/data-sources/cce_cluster_v3.md index 2904a83b4..e38e02611 100644 --- a/docs/data-sources/cce_cluster_v3.md +++ b/docs/data-sources/cce_cluster_v3.md @@ -21,15 +21,20 @@ data "flexibleengine_cce_cluster_v3" "cluster" { The following arguments are supported: -* `name` - (Optional)The Name of the cluster resource. +* `region` - (Optional, String) The region in which to query the data source. If omitted, the provider-level region + will be used. -* `id` - (Optional) The ID of container cluster. +* `name` - (Optional, String)The Name of the cluster resource. -* `status` - (Optional) The state of the cluster. +* `id` - (Optional, String) The ID of container cluster. -* `cluster_type` - (Optional) Type of the cluster. Possible values: VirtualMachine, BareMetal or Windows +* `status` - (Optional, String) The state of the cluster. -## Attributes Reference +* `cluster_type` - (Optional, String) Type of the cluster. Possible values: VirtualMachine, BareMetal or Windows + +* `vpc_id` - (Optional, String) The ID of the VPC used to create the node. + +## Attribute Reference All above argument parameters can be exported as attribute parameters along with attribute reference: @@ -69,8 +74,10 @@ All above argument parameters can be exported as attribute parameters along with * `authentication_mode` - Authentication mode of the cluster, possible values are x509 and rbac. -* `masters` - Advanced configuration of master nodes. Structure is documented below. +* `masters` - Advanced configuration of master nodes. + The [masters](#cce_masters) object structure is documented below. + The `masters` block supports: * `availability_zone` - The availability zone (AZ) of the master node. diff --git a/docs/data-sources/cce_clusters.md b/docs/data-sources/cce_clusters.md index 582728bce..668246166 100644 --- a/docs/data-sources/cce_clusters.md +++ b/docs/data-sources/cce_clusters.md @@ -36,7 +36,7 @@ The following arguments are supported: * `status` - (Optional, String) Specifies the status of the cluster. -## Attributes Reference +## Attribute Reference In addition to all arguments above, the following attributes are exported: @@ -44,8 +44,10 @@ In addition to all arguments above, the following attributes are exported: * `ids` - Indicates a list of IDs of all CCE clusters found. -* `clusters` - Indicates a list of CCE clusters found. Structure is documented below. +* `clusters` - Indicates a list of CCE clusters found. + The [clusters](#cce_clusters) object structure is documented below. + The `clusters` block supports: * `name` - The name of the cluster. @@ -88,14 +90,18 @@ The `clusters` block supports: * `enterprise_project_id` - The enterprise project ID of the CCE cluster. -* `endpoints` - The access addresses of kube-apiserver in the cluster. Structure is documented below. +* `endpoints` - The access addresses of kube-apiserver in the cluster. + The [endpoints](#cce_endpoints) object structure is documented below. -* `certificate_clusters` - The certificate clusters. Structure is documented below. +* `certificate_clusters` - The certificate clusters. + The [certificate_clusters](#cce_certificate_clusters) object structure is documented below. -* `certificate_users` - The certificate users. Structure is documented below. +* `certificate_users` - The certificate users + The [certificate_users](#cce_certificate_users) object structure is documented below. * `kube_config_raw` - The raw Kubernetes config to be used by kubectl and other compatible tools. + The `endpoints` block supports: * `url` - The URL of the cluster access address. @@ -104,6 +110,7 @@ The `endpoints` block supports: + **Internal**: The user's subnet access address. + **External**: The public network access address. + The `certificate_clusters` block supports: * `name` - The cluster name. @@ -112,6 +119,7 @@ The `certificate_clusters` block supports: * `certificate_authority_data` - The certificate data. + The `certificate_users` block supports: * `name` - The user name. diff --git a/docs/data-sources/cce_node_ids_v3.md b/docs/data-sources/cce_node_ids_v3.md index e56d41922..f5963b268 100644 --- a/docs/data-sources/cce_node_ids_v3.md +++ b/docs/data-sources/cce_node_ids_v3.md @@ -21,9 +21,12 @@ data "flexibleengine_cce_node_ids_v3" "node_ids" { The following arguments are supported: -* `cluster_id` (Required) - Specifies the CCE cluster ID used as the query filter. +* `region` - (Optional, String) The region in which to query the data source. If omitted, the provider-level region + will be used. -## Attributes Reference +* `cluster_id` (Required, String) - Specifies the CCE cluster ID used as the query filter. + +## Attribute Reference The following attributes are exported: diff --git a/docs/data-sources/cce_node_v3.md b/docs/data-sources/cce_node_v3.md index 061281645..3b3698385 100644 --- a/docs/data-sources/cce_node_v3.md +++ b/docs/data-sources/cce_node_v3.md @@ -22,15 +22,18 @@ data "flexibleengine_cce_node_v3" "node" { The following arguments are supported: -* `cluster_id` - (Required) The id of container cluster. +* `region` - (Optional, String) The region in which to query the data source. If omitted, the provider-level region + will be used. -* `name` - (Optional) - Name of the node. +* `cluster_id` - (Required, String) The id of container cluster. -* `node_id` - (Optional) - The id of the node. +* `name` - (Optional, String) - Name of the node. -* `status` - (Optional) - The state of the node. +* `node_id` - (Optional, String) - The id of the node. -## Attributes Reference +* `status` - (Optional, String) - The state of the node. + +## Attribute Reference All above argument parameters can be exported as attribute parameters along with attribute reference: @@ -53,13 +56,14 @@ All above argument parameters can be exported as attribute parameters along with * `ip_type` - Elastic IP address type. * `share_type` - Bandwidth sharing type. + * `bandwidth_size` - Bandwidth (Mbit/s), in the range of [1, 2000]. + * `charge_mode` - Bandwidth billing type. -* `root_volume` - It corresponds to the system disk related configuration. +* `disk_size` - Disk size in GB. - + `disk_size` - Disk size in GB. - + `volume_type` - Disk type. +* `volume_type` - Disk type. * `data_volumes` - Represents the data disk to be created. diff --git a/docs/resources/cce_addon_v3.md b/docs/resources/cce_addon_v3.md index a893a3d87..44b3ee15e 100644 --- a/docs/resources/cce_addon_v3.md +++ b/docs/resources/cce_addon_v3.md @@ -59,6 +59,9 @@ resource "flexibleengine_cce_addon_v3" "autoscaler" { The following arguments are supported: +* `region` - (Optional, String, ForceNew) Specifies the region in which to create the CCE addon resource. + If omitted, the provider-level region will be used. Changing this will create a new CCE addon resource. + * `cluster_id` - (Required, String, ForceNew) ID of the cluster. Changing this parameter will create a new resource. * `template_name` - (Required, String, ForceNew) Name of the addon template. @@ -68,8 +71,10 @@ The following arguments are supported: * `values` - (Optional, List, ForceNew) Add-on template installation parameters. These parameters vary depending on the add-on. Changing this parameter will create a new resource. + The [values](#cce_values) object structure is documented below. -* The `values` block supports: + +The `values` block supports: * `basic` - (Required, String, ForceNew) The basic parameters in json string format. Changing this will create a new resource. @@ -80,7 +85,7 @@ The following arguments are supported: * `flavor` - (Optional, String, ForceNew) The flavor parameters in json string format. Changing this will create a new resource. -## Attributes Reference +## Attribute Reference In addition to all arguments above, the following attributes are exported: @@ -92,8 +97,8 @@ In addition to all arguments above, the following attributes are exported: This resource provides the following timeouts configuration options: -* `create` - Default is 10 minute. -* `delete` - Default is 3 minute. +* `create` - Default is 10 minutes. +* `delete` - Default is 3 minutes. ## Import diff --git a/docs/resources/cce_cluster_v3.md b/docs/resources/cce_cluster_v3.md index 82a624fa7..5d1982ebb 100644 --- a/docs/resources/cce_cluster_v3.md +++ b/docs/resources/cce_cluster_v3.md @@ -41,14 +41,18 @@ resource "flexibleengine_cce_cluster_v3" "cluster_1" { The following arguments are supported: -* `name` - (Required) Cluster name. Changing this parameter will create a new cluster resource. +* `region` - (Optional, String, ForceNew) Specifies the region in which to create the CCE cluster resource. + If omitted, the provider-level region will be used. Changing this will create a new CCE cluster resource. -* `labels` - (Optional) Cluster tag, key/value pair format. Changing this parameter will create a new cluster resource. +* `name` - (Required, String, ForceNew) Cluster name. Changing this parameter will create a new cluster resource. -* `annotations` - (Optional) Cluster annotation, key/value pair format. +* `labels` - (Optional, Map, ForceNew) Cluster tag, key/value pair format. Changing this parameter will create a new + cluster resource. + +* `annotations` - (Optional, Map, ForceNew) Cluster annotation, key/value pair format. Changing this parameter will create a new cluster resource. -* `flavor_id` - (Required) Cluster specifications. Changing this parameter will create a new cluster resource. +* `flavor_id` - (Required, String, ForceNew) Cluster specifications. Changing this parameter will create a new cluster resource. + `cce.s1.small` - small-scale single cluster (up to 50 nodes). + `cce.s1.medium` - medium-scale single cluster (up to 200 nodes). @@ -63,47 +67,47 @@ The following arguments are supported: + `cce.t2.medium` - medium-scale HA physical machine cluster (up to 100 nodes). + `cce.t2.large` - large-scale HA physical machine cluster (up to 500 nodes). -* `cluster_version` - (Optional) For the cluster version, possible values are listed on the +* `cluster_version` - (Optional, String, ForceNew) For the cluster version, possible values are listed on the [CCE Cluster Version Release Notes](https://docs.prod-cloud-ocb.orange-business.com/usermanual2/cce/cce_01_0068.html). If this parameter is not set, the latest available version will be used. -* `cluster_type` - (Required) Cluster Type, possible values are VirtualMachine and BareMetal. +* `cluster_type` - (Required, String, ForceNew) Cluster Type, possible values are VirtualMachine and BareMetal. Changing this parameter will create a new cluster resource. -* `description` - (Optional) Cluster description. - -* `billing_mode` - (Optional) Charging mode of the cluster, which is 0 (on demand). - Changing this parameter will create a new cluster resource. +* `description` - (Optional, String) Cluster description. -* `extend_param` - (Optional) Extended parameter. Changing this parameter will create a new cluster resource. +* `extend_param` - (Optional, Map, ForceNew) Extended parameter. Changing this parameter will create a new cluster resource. -* `vpc_id` - (Required) The ID of the VPC used to create the node. Changing this parameter will create a new cluster resource. +* `vpc_id` - (Required, String, ForceNew) The ID of the VPC used to create the node. + Changing this parameter will create a new cluster resource. -* `subnet_id` - (Required) The ID of the VPC Subnet used to create the node. +* `subnet_id` - (Required, String, ForceNew) The ID of the VPC Subnet used to create the node. Changing this parameter will create a new cluster resource. -* `highway_subnet_id` - (Optional) The ID of the high speed network used to create bare metal nodes. +* `highway_subnet_id` - (Optional, String, ForceNew) The ID of the high speed network used to create bare metal nodes. Changing this parameter will create a new cluster resource. -* `container_network_type` - (Required) Container network parameters. Possible values: +* `container_network_type` - (Required, String, ForceNew) Container network parameters. Possible values: + `overlay_l2` - An overlay_l2 network built for containers by using Open vSwitch(OVS) + `underlay_ipvlan` - An underlay_ipvlan network built for bare metal servers by using ipvlan. + `vpc-router` - An vpc-router network built for containers by using ipvlan and custom VPC routes. -* `container_network_cidr` - (Optional) Container network segment. Changing this parameter will create a new cluster resource. +* `container_network_cidr` - (Optional, String, ForceNew) Container network segment. + Changing this parameter will create a new cluster resource. -* `service_network_cidr` - (Optional) Service network segment. Changing this parameter will create a new cluster resource. +* `service_network_cidr` - (Optional, String, ForceNew) Service network segment. Changing this parameter will create + a new cluster resource. -* `custom_san` - (Optional) Custom san to add to certificate. (array of string) +* `custom_san` - (Optional, List) Custom san to add to certificate. (array of string) -* `authentication_mode` - (Optional) Authentication mode of the cluster, possible values are x509 and rbac. Defaults to *rbac*. - Changing this parameter will create a new cluster resource. +* `authentication_mode` - (Optional, String, ForceNew) Authentication mode of the cluster, possible values are x509 + and rbac. Defaults to *rbac*. Changing this parameter will create a new cluster resource. -* `authenticating_proxy_ca` - (Optional) CA root certificate provided in the authenticating_proxy mode. The CA root certificate - is encoded to the Base64 format. Changing this parameter will create a new cluster resource. +* `authenticating_proxy_ca` - (Optional, String, ForceNew) CA root certificate provided in the authenticating_proxy mode. + The CA root certificate is encoded to the Base64 format. Changing this parameter will create a new cluster resource. -* `eip` - (Optional) EIP address of the cluster. +* `eip` - (Optional, String) EIP address of the cluster. * `kube_proxy_mode` - (Optional, String, ForceNew) Service forwarding mode. Two modes are available: @@ -114,13 +118,15 @@ The following arguments are supported: can keep connections uninterrupted during service updates. It is suitable for large-sized clusters. * `masters` - (Optional, List, ForceNew) Advanced configuration of master nodes. Changing this creates a new cluster. + The [masters](#cce_masters) object structure is documented below. + The `masters` block supports: * `availability_zone` - (Optional, String, ForceNew) Specifies the availability zone of the master node. Changing this creates a new cluster. -## Attributes Reference +## Attribute Reference All above argument parameters can be exported as attribute parameters along with attribute reference. @@ -136,17 +142,36 @@ All above argument parameters can be exported as attribute parameters along with * `security_group_id` - Security group ID of the cluster. -* `certificate_clusters.name` - The cluster name. +* `certificate_clusters` - Security group ID of the cluster. + The [certificate_clusters](#cce_certificate_clusters) object structure is documented below. + +* `certificate_users` - Security group ID of the cluster. + The [certificate_users](#cce_certificate_users) object structure is documented below. + + +The `certificate_clusters` block supports: + +* `name` - The cluster name. + +* `server` - The server IP address. + +* `certificate_authority_data` - The certificate data. + + +The `certificate_users` block supports: + +* `name` - The user name. -* `certificate_clusters.server` - The server IP address. +* `client_certificate_data` - The client certificate data. -* `certificate_clusters.certificate_authority_data` - The certificate data. +* `client_key_data` - The client key data. -* `certificate_users.name` - The user name. +## Timeouts -* `certificate_users.client_certificate_data` - The client certificate data. +This resource provides the following timeouts configuration options: -* `certificate_users.client_key_data` - The client key data. +* `create` - Default is 30 minutes. +* `delete` - Default is 30 minutes. ## Import diff --git a/docs/resources/cce_node_pool_v3.md b/docs/resources/cce_node_pool_v3.md index 9f5c8b5a8..e85875d7e 100644 --- a/docs/resources/cce_node_pool_v3.md +++ b/docs/resources/cce_node_pool_v3.md @@ -45,6 +45,9 @@ resource "flexibleengine_cce_node_pool_v3" "node_pool" { The following arguments are supported: +* `region` - (Optional, String, ForceNew) Specifies the region in which to create the CCE node pool resource. + If omitted, the provider-level region will be used. Changing this will create a new CCE node pool resource. + * `cluster_id` - (Required, String, ForceNew) ID of the cluster. Changing this parameter will create a new resource. * `name` - (Required, String) Node Pool Name. @@ -59,7 +62,7 @@ The following arguments are supported: Default value is random to create nodes in a random AZ in the node pool. Changing this parameter will create a new resource. -* `os` - (Optional, String) Operating System of the node. The value can be EulerOS 2.5 and CentOS 7.6. +* `os` - (Optional, String, ForceNew) Operating System of the node. The value can be EulerOS 2.5 and CentOS 7.6. Changing this parameter will create a new resource. * `key_pair` - (Optional, String, ForceNew) Key pair name when logging in to select the key pair mode. @@ -109,29 +112,37 @@ The following arguments are supported: The `root_volume` block supports: -* `size` - (Required, Int) Specifies the disk size in GB. +* `size` - (Required, Int, ForceNew) Specifies the disk size in GB. + Changing this will create a new CCE node pool resource. -* `volumetype` - (Required, String) Specifies the disk type. +* `volumetype` - (Required, String, ForceNew) Specifies the disk type. + Changing this will create a new CCE node pool resource. -* `kms_key_id` - (Optional, String) Specifies the KMS key ID. This is used to encrypt the volume. +* `kms_key_id` - (Optional, String, ForceNew) Specifies the KMS key ID. This is used to encrypt the volume. + Changing this will create a new CCE node pool resource. -> You need to create an agency (EVSAccessKMS) when disk encryption is used in the current project for the first time ever. The account and permission of the created agency are `op_svc_evs` and **KMS Administrator**, respectively. -* `extend_params` - (Optional, Map) Specifies the disk expansion parameters in key/value pair format. +* `extend_params` - (Optional, Map, ForceNew) Specifies the disk expansion parameters in key/value pair format. + Changing this will create a new CCE node pool resource. The `data_volumes` block supports: -* `size` - (Required, Int) Specifies the disk size in GB. +* `size` - (Required, Int, ForceNew) Specifies the disk size in GB. + Changing this will create a new CCE node pool resource. -* `volumetype` - (Required, String) Specifies the disk type. +* `volumetype` - (Required, String, ForceNew) Specifies the disk type. + Changing this will create a new CCE node pool resource. -* `kms_key_id` - (Optional, String) Specifies the KMS key ID. This is used to encrypt the volume. +* `kms_key_id` - (Optional, String, ForceNew) Specifies the KMS key ID. This is used to encrypt the volume. + Changing this will create a new CCE node pool resource. -> You need to create an agency (EVSAccessKMS) when disk encryption is used in the current project for the first time ever. The account and permission of the created agency are `op_svc_evs` and **KMS Administrator**, respectively. -* `extend_params` - (Optional, Map) Specifies the disk expansion parameters in key/value pair format. +* `extend_params` - (Optional, Map, ForceNew) Specifies the disk expansion parameters in key/value pair format. + Changing this will create a new CCE node pool resource. The `taints` block supports: @@ -144,7 +155,7 @@ The `taints` block supports: * `effect` - (Required, String) Available options are *NoSchedule*, *PreferNoSchedule* and *NoExecute*. -## Attributes Reference +## Attribute Reference In addition to all arguments above, the following attributes are exported: @@ -158,8 +169,8 @@ In addition to all arguments above, the following attributes are exported: This resource provides the following timeouts configuration options: -* `create` - Default is 20 minute. -* `delete` - Default is 20 minute. +* `create` - Default is 20 minutes. +* `delete` - Default is 20 minutes. ## Import diff --git a/docs/resources/cce_node_v3.md b/docs/resources/cce_node_v3.md index 00bc7ba99..5a25e11fa 100644 --- a/docs/resources/cce_node_v3.md +++ b/docs/resources/cce_node_v3.md @@ -40,63 +40,71 @@ resource "flexibleengine_cce_node_v3" "node_1" { The following arguments are supported: -* `cluster_id` - (Required) ID of the cluster. Changing this parameter will create a new resource. +* `region` - (Optional, String, ForceNew) Specifies the region in which to create the CCE node resource. + If omitted, the provider-level region will be used. Changing this will create a new CCE node resource. -* `name` - (Optional) Node Name. +* `cluster_id` - (Required, String, ForceNew) ID of the cluster. Changing this parameter will create a new resource. -* `flavor_id` - (Required) Specifies the flavor id. Changing this parameter will create a new resource. +* `name` - (Optional, String, ForceNew) Node Name. Changing this parameter will create a new resource. -* `availability_zone` - (Required) specify the name of the available partition (AZ). +* `flavor_id` - (Required, String, ForceNew) Specifies the flavor id.Changing this parameter will create a new resource. + +* `availability_zone` - (Required, String, ForceNew) specify the name of the available partition (AZ). Changing this parameter will create a new resource. -* `key_pair` - (Required) Key pair name when logging in to select the key pair mode. +* `key_pair` - (Required, String, ForceNew) Key pair name when logging in to select the key pair mode. Changing this parameter will create a new resource. -* `os` - (Optional) Operating System of the node, possible values are EulerOS 2.2 and CentOS 7.6. Defaults to EulerOS 2.2. - Changing this parameter will create a new resource. +* `os` - (Optional, String, ForceNew) Operating System of the node, possible values are EulerOS 2.2 and CentOS 7.6. + Defaults to EulerOS 2.2. Changing this parameter will create a new resource. -* `labels` - (Optional) Tags of a Kubernetes node, key/value pair format. Changing this parameter will create a new resource. +* `labels` - (Optional, Map, ForceNew) Tags of a Kubernetes node, key/value pair format. Changing this parameter will + create a new resource. -* `tags` - (Optional) VM tag, key/value pair format. +* `tags` - (Optional, Map) VM tag, key/value pair format. -* `annotations` - (Optional) Node annotation, key/value pair format. Changing this parameter will create a new resource. +* `annotations` - (Optional, Map, ForceNew) Node annotation, key/value pair format. Changing this parameter will + create a new resource. -* `eip_ids` - (Optional) List of existing elastic IP IDs. Changing this parameter will create a new resource. +* `eip_ids` - (Optional, Set, ForceNew) List of existing elastic IP IDs. Changing this parameter will create a new + resource. -> If the `eip_ids` parameter is configured, you do not need to configure the `eip_count` and bandwidth parameters: `iptype`, `bandwidth_charge_mode`, `bandwidth_size` and `share_type`. -* `eip_count` - (Optional) Number of elastic IPs to be dynamically created. Changing this parameter will create a new resource. +* `eip_count` - (Optional, Int, ForceNew) Number of elastic IPs to be dynamically created. Changing this parameter + will create a new resource. -* `iptype` - (Optional) Elastic IP type. +* `iptype` - (Optional, String, ForceNew) Elastic IP type. -* `bandwidth_charge_mode` - (Optional) Bandwidth billing type. Changing this parameter will create a new resource. +* `bandwidth_charge_mode` - (Optional, String, ForceNew) Bandwidth billing type. Changing this parameter will create a + new resource. -* `sharetype` - (Optional) Bandwidth sharing type. Changing this parameter will create a new resource. +* `sharetype` - (Optional, String, ForceNew) Bandwidth sharing type. Changing this parameter will create a new resource. -* `bandwidth_size` - (Optional) Bandwidth size. Changing this parameter will create a new resource. +* `bandwidth_size` - (Optional, Int, ForceNew) Bandwidth size. Changing this parameter will create a new resource. -* `ecs_performance_type` - (Optional) Classification of cloud server specifications. +* `ecs_performance_type` - (Optional, String, ForceNew) Classification of cloud server specifications. Changing this parameter will create a new resource. -* `ecs_group_id` - (Optional) Specifies the ECS group ID. If specified, the node will be created under +* `ecs_group_id` - (Optional, String, ForceNew) Specifies the ECS group ID. If specified, the node will be created under the cloud server group. Changing this parameter will create a new resource. -* `subnet_id` - (Optional) Specifies the ID of the VPC Subnet to which the NIC belongs. +* `subnet_id` - (Optional, String, ForceNew) Specifies the ID of the VPC Subnet to which the NIC belongs. Changing this parameter will create a new resource. -* `product_id` - (Optional) The Product ID. Changing this parameter will create a new resource. +* `product_id` - (Optional, String, ForceNew) The Product ID. Changing this parameter will create a new resource. -* `max_pods` - (Optional) The maximum number of instances a node is allowed to create. +* `max_pods` - (Optional, Int, ForceNew) The maximum number of instances a node is allowed to create. Changing this parameter will create a new resource. -* `public_key` - (Optional) The Public key. Changing this parameter will create a new resource. +* `public_key` - (Optional, String, ForceNew) The Public key. Changing this parameter will create a new resource. -* `preinstall` - (Optional) Script required before installation. The input value can be a Base64 encoded string or not. - Changing this parameter will create a new resource. +* `preinstall` - (Optional, String, ForceNew) Script required before installation. The input value can be a Base64 + encoded string or not. Changing this parameter will create a new resource. -* `postinstall` - (Optional) Script required after installation. The input value can be a Base64 encoded string or not. - Changing this parameter will create a new resource. +* `postinstall` - (Optional, String, ForceNew) Script required after installation. The input value can be a Base64 + encoded string or not. Changing this parameter will create a new resource. * `extend_param` - (Optional, Map, ForceNew) Extended parameter. Changing this parameter will create a new resource. Availiable keys: @@ -111,39 +119,44 @@ The following arguments are supported: } ``` -* `root_volume` - (Required) It corresponds to the system disk related configuration. +* `root_volume` - (Required, List, ForceNew) It corresponds to the system disk related configuration. Changing this parameter will create a new resource. - + `size` - (Required) Specifies the disk size in GB. - + `volumetype` - (Required) Specifies the disk type. - + `extend_params` - (Optional) Specifies the disk expansion parameters in key/value pair format. - + `kms_key_id` - (Optional) Specifies the ID of a KMS key. This is used to encrypt the volume. + + `size` - (Required, Int, ForceNew) Specifies the disk size in GB. + + `volumetype` - (Required, String, ForceNew) Specifies the disk type. + + `extend_params` - (Optional, Map, ForceNew) Specifies the disk expansion parameters in key/value pair format. + + `kms_key_id` - (Optional, String, ForceNew) Specifies the ID of a KMS key. This is used to encrypt the volume. -> You need to create an agency (EVSAccessKMS) when disk encryption is used in the current project for the first time ever. The account and permission of the created agency are `op_svc_evs` and **KMS Administrator**, respectively. -* `data_volumes` - (Required) Represents the data disk to be created. +* `data_volumes` - (Required, List, ForceNew) Represents the data disk to be created. Changing this parameter will create a new resource. - + `size` - (Required) Specifies the disk size in GB. - + `volumetype` - (Required) Specifies the disk type. - + `extend_params` - (Optional) Specifies the disk expansion parameters in key/value pair format. - + `kms_key_id` - (Optional) Specifies the ID of a KMS key. This is used to encrypt the volume. + + `size` - (Required, Int, ForceNew) Specifies the disk size in GB.Changing this will create a new resource. + + `volumetype` - (Required, String, ForceNew) Specifies the disk type.Changing this will create a new resource. + + `extend_params` - (Optional, Map, ForceNew) Specifies the disk expansion parameters in key/value pair format. + Changing this will create a new resource. + + `kms_key_id` - (Optional, String, ForceNew) Specifies the ID of a KMS key. This is used to encrypt the volume. + Changing this will create a new resource. - -> You need to create an agency (EVSAccessKMS) when disk encryption is used in the current project for the first time ever. - The account and permission of the created agency are `op_svc_evs` and **KMS Administrator**, respectively. + -> You need to create an agency (EVSAccessKMS) when disk encryption is used in the current project for the first + time ever. The account and permission of the created agency are `op_svc_evs` and **KMS Administrator**, respectively. -* `taints` - (Optional) You can add taints to created nodes to configure anti-affinity. +* `taints` - (Optional, List, ForceNew) You can add taints to created nodes to configure anti-affinity. Changing this parameter will create a new resource. Each taint contains the following parameters: - + `key` - (Required) A key must contain 1 to 63 characters starting with a letter or digit. Only letters, digits, - hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain name can be used as the prefix of a key. - + `value` - (Required) A value must start with a letter or digit and can contain a maximum of 63 characters, - including letters, digits, hyphens (-), underscores (_), and periods (.). - + `effect` - (Required) Available options are NoSchedule, PreferNoSchedule, and NoExecute. + + `key` - (Required, String, ForceNew) A key must contain 1 to 63 characters starting with a letter or digit. Only + letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain name can be used as + the prefix of a key. Changing this parameter will create a new resource. + + `value` - (Required, String, ForceNew) A value must start with a letter or digit and can contain a maximum of 63 + characters, including letters, digits, hyphens (-), underscores (_), and periods (.).Changing this parameter will + create a new resource. + + `effect` - (Required, String, ForceNew) Available options are NoSchedule, PreferNoSchedule, and NoExecute. + Changing this parameter will create a new resource. -## Attributes Reference +## Attribute Reference All above argument parameters can be exported as attribute parameters along with attribute reference. @@ -153,6 +166,13 @@ All above argument parameters can be exported as attribute parameters along with * `private_ip` - Private IP of the CCE node. * `public_ip` - Public IP of the CCE node. +## Timeouts + +This resource provides the following timeouts configuration options: + +* `create` - Default is 20 minutes. +* `delete` - Default is 20 minutes. + ## Import CCE node can be imported using the `cluster_id` and the `id` of the node separated by `/`, e.g.