alicloud_cs_managed_kubernetes_clusters

This data source provides a list Container Service Managed Kubernetes Clusters on Alibaba Cloud.

-> NOTE: Available since v1.35.0

-> NOTE: From version 1.177.0+, We supported batch export of clusters' kube config information by kube_config_file_prefix.

Example Usage

# Declare the data source
data "alicloud_cs_managed_kubernetes_clusters" "k8s_clusters" {
  name_regex              = "my-first-k8s"
  output_file             = "my-first-k8s-json"
  kube_config_file_prefix = "~/.kube/managed"
}

output "output" {
  value = "${data.alicloud_cs_managed_kubernetes_clusters.k8s_clusters.clusters}"
}

Argument Reference

The following arguments are supported:

• ids - (Optional) Cluster IDs to filter.
• name_regex - (Optional) A regex string to filter results by cluster name.
• output_file - (Optional) File name where to save data source results (after running terraform plan).
• enable_details - (Optional) Boolean, false by default, only id and name are exported. Set to true if more details are needed, e.g., master_disk_category, slb_internet_enabled, connections. See full list in attributes.
• kube_config_file_prefix - (Optional, Deprecated from v1.243.0) The path prefix of kube config. You could store kube config in a specified directory by specifying this field, like ~/.kube/managed, then it will be named with ~/.kube/managed-clusterID-kubeconfig. From version 1.243.0, kube_config will not export kube_config if this field is not set. Please use the attribute output_file of new DataSource alicloud_cs_cluster_credential to replace it

Attributes Reference

The following attributes are exported in addition to the arguments listed above:

• ids - A list of matched Kubernetes clusters' ids.
• names - A list of matched Kubernetes clusters' names.
• clusters - A list of matched Kubernetes clusters. Each element contains the following attributes:
  • id - The ID of the container cluster.
  • name - The name of the container cluster.
  • availability_zone - The ID of availability zone.
  • key_name - The keypair of ssh login cluster node, you have to create it first.
  • worker_numbers - The ECS instance node number in the current container cluster.
  • vswitch_ids - The ID of VSwitches where the current cluster is located.
  • vpc_id - The ID of VPC where the current cluster is located.
  • security_group_id - The ID of security group where the current cluster worker node is located.
  • nat_gateway_id - The ID of nat gateway used to launch kubernetes cluster.
  • worker_nodes - List of cluster worker nodes.
    • id - ID of the node.
    • name - Node name.
    • private_ip - The private IP address of node.
  • connections - Map of kubernetes cluster connection information.
    • api_server_internet - API Server Internet endpoint.
    • api_server_intranet - API Server Intranet endpoint.
    • master_public_ip - Master node SSH IP address.
    • service_domain - Service Access Domain.
  • log_config - A list of one element containing information about the associated log store. It contains the following attributes:
    • type - Type of collecting logs.
    • project - Log Service project name.
  • state - (Available since v1.245.0) The state of cluster.
  • rrsa_config - (Available since v1.245.0) Nested attribute containing RRSA related data for your cluster.
    • enabled - Whether the RRSA feature has been enabled.
    • rrsa_oidc_issuer_url - The issuer URL of RRSA OIDC Token.
    • ram_oidc_provider_name - The name of OIDC Provider that was registered in RAM.
    • ram_oidc_provider_arn - The arn of OIDC provider that was registered in RAM.