全部产品
Search
文档中心

Resource Orchestration Service:DATASOURCE::CS::KubernetesClusters

更新时间:Jul 06, 2025

DATASOURCE::CS::KubernetesClusters digunakan untuk menanyakan klaster Container Service for Kubernetes (ACK).

Sintaksis

{
  "Type": "DATASOURCE::CS::KubernetesClusters",
  "Properties": {
    "ClusterSpec": String,
    "ClusterType": String,
    "Profile": String,
    "Name": String,
    "RefreshOptions": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

ClusterSpec

String

Tidak

Ya

Spesifikasi klaster.

Jika Anda mengatur ClusterType ke ManagedKubernetes, Anda dapat menggunakan ClusterSpec untuk membedakan tipe klaster ACK yang dikelola. Nilai valid:

  • ack.pro.small: Klaster ACK Pro

  • ack.standard: Klaster ACK Dasar

  • Null (default): tidak ada tipe

Catatan

Jika Anda mengatur properti ini ke Null, Anda tidak dapat menggunakan properti ini untuk membedakan tipe klaster ACK yang dikelola.

ClusterType

String

Tidak

Ya

Tipe klaster.

Nilai valid:

  • Kubernetes: klaster khusus ACK

  • ManagedKubernetes: klaster ACK yang dikelola. Klaster tersebut bisa menjadi salah satu dari kategori berikut:

    • Klaster ACK yang dikelola

    • Klaster ACK Serverless

    • Klaster ACK Edge

  • Ask: Klaster ACK Serverless

  • ExternalKubernetes: klaster terdaftar

Catatan

Saat Anda menanyakan klaster ACK Serverless, nilai properti ini ditentukan oleh tipe klaster yang Anda tentukan saat membuat klaster.

Profile

String

Tidak

Ya

Profil klaster.

Jika Anda mengatur ClusterType ke ManagedKubernetes, Anda dapat menggunakan Profile untuk membedakan kategori klaster ACK yang dikelola. Nilai valid:

  • Default: Klaster ACK yang dikelola

  • Serverless: Klaster ACK Serverless

  • Edge: Klaster ACK Edge

  • Null (default): tidak ada kategori

Catatan

Jika Anda mengatur properti ini ke Null, Anda tidak dapat menggunakan properti ini untuk membedakan kategori klaster ACK yang dikelola.

Name

String

Tidak

Ya

Nama klaster.

Nama dapat berisi angka, huruf, dan tanda hubung (-). Panjangnya harus antara 1 hingga 63 karakter, dan tidak boleh dimulai dengan tanda hubung (-).

RefreshOptions

String

Tidak

Ya

Kebijakan penyegaran untuk sumber daya sumber data ketika tumpukan diperbarui.

Nilai valid:

  • Never (default): tidak menyegarkan sumber daya sumber data ketika tumpukan diperbarui.

  • Always: menyegarkan sumber daya sumber data ketika tumpukan diperbarui.

Nilai pengembalian (Fn::GetAtt)

  • ClusterIds: ID klaster.

  • Clusters: detail klaster.

Properti

Tipe

Deskripsi

Kendala

ClusterIds

Daftar

ID klaster.

Tidak ada.

Clusters

Daftar

Detail klaster.

Tidak ada.

Name

String

Nama klaster.

Nama harus memiliki panjang 1 hingga 63 karakter, dan dapat berisi angka, huruf, dan tanda hubung (-). Tidak boleh dimulai dengan tanda hubung (-).

ClusterId

String

ID klaster.

Tidak ada.

RegionId

String

ID wilayah klaster.

Tidak ada.

State

String

Status klaster.

Nilai valid:

  • initial: Klaster sedang dibuat.

  • failed: Gagal membuat klaster.

  • running: Klaster sedang berjalan.

  • updating: Klaster sedang diperbarui.

  • updating_failed: Gagal memperbarui klaster.

  • scaling: Klaster sedang diskalakan.

  • stopped: Klaster dihentikan.

  • deleting: Klaster sedang dihapus.

  • deleted: Klaster telah dihapus.

  • delete_failed: Gagal menghapus klaster.

ClusterType

String

Tipe klaster.

Nilai valid:

  • Kubernetes: klaster khusus ACK

  • ManagedKubernetes: klaster ACK yang dikelola

  • Ask: Klaster ACK Serverless

  • ExternalKubernetes: klaster terdaftar

Created

String

Waktu pembuatan klaster.

Tidak ada.

Updated

String

Waktu pembaruan klaster.

Tidak ada.

InitVersion

String

Versi awal Kubernetes klaster.

ACK menyediakan klaster versi Kubernetes terbaru dua versi di konsol. Anda dapat membuat klaster versi Kubernetes lainnya dengan memanggil operasi API ACK tertentu. Untuk informasi lebih lanjut tentang versi Kubernetes yang didukung oleh ACK, lihat Ikhtisar versi Kubernetes yang didukung oleh ACK.

Catatan

ACK mendukung semua versi Kubernetes open source. Kami merekomendasikan Anda menggunakan versi Kubernetes terbaru. Jika properti ini kosong, versi Kubernetes terbaru akan digunakan secara default.

CurrentVersion

String

Versi Kubernetes saat ini dari klaster.

Tidak ada.

MetaData

String

Metadata klaster.

Tidak ada.

ResourceGroupId

String

ID grup sumber daya tempat klaster berada.

Tidak ada.

InstanceType

String

Tipe instans node dalam klaster.

Tidak ada.

VpcId

String

ID virtual private cloud (VPC) tempat klaster berada.

Tidak ada.

VSwitchId

String

ID vSwitch klaster.

Tidak ada.

VSwitchCidr

String

Blok CIDR vSwitch klaster.

Tidak ada.

DataDiskSize

String

Ukuran disk data klaster.

Tidak ada.

DataDiskCategory

String

Kategori disk data klaster.

Tidak ada.

SecurityGroupId

String

ID grup keamanan tempat klaster berada.

Tidak ada.

Tags

Daftar

Label klaster.

Untuk informasi lebih lanjut tentang label, lihat tag.

ZoneId

String

ID zona klaster.

Tidak ada.

NetworkMode

String

Mode jaringan klaster.

Nilai valid:

  • classic: jaringan klasik

  • vpc (default): VPC

  • overlay: jaringan overlay

  • calico: jaringan yang didukung oleh Calico

SubnetCidr

String

Blok CIDR pod.

Blok CIDR pod harus salah satu blok CIDR VPC atau subnet mereka:

  • 10.0.0.0/8

  • 172.16-31.0.0/12-16

  • 192.168.0.0/16

Catatan

Blok CIDR pod tidak boleh tumpang tindih dengan blok CIDR VPC tempat klaster diterapkan dan blok CIDR klaster ACK yang ada di VPC. Anda tidak dapat mengubah blok CIDR pod setelah membuat klaster.

MasterUrl

String

Titik akhir klaster.

Jenis titik akhir berikut didukung:

  • titik akhir internal

  • titik akhir publik

ExternalLoadbalancerId

String

ID instance Server Load Balancer (SLB) yang digunakan untuk Ingress klaster.

Tidak ada.

Port

String

Port node.

Tidak ada.

NodeStatus

String

Status yang menunjukkan apakah node siap.

Nilai valid:

  • Ready

  • NotReady

  • Unknown

  • Offline

ClusterHealthy

String

Status kesehatan klaster.

Tidak ada.

DockerVersion

String

Versi Docker klaster.

Tidak ada.

SwarmMode

Boolean

Menunjukkan apakah Swarm Mode diaktifkan.

Nilai valid:

  • true

  • false

GwBridge

String

Jembatan virtual docker_gwbridge yang menghubungkan jaringan overlay.

Tidak ada.

UpgradeComponents

Peta

Detail komponen yang dapat diperbarui dalam klaster.

Contoh: { "Kubernetes": { "ComponentName": "Kubernetes", "Version": "1.14.8-aliyun.1", "NextVersion": "", "Changed": "", "CanUpgrade": false, "Force": false, "Policy": "", "ExtraVars": null, "ReadyToUpgrade": "", "Message": "", "Exist": false, "Required": false }}.

NextVersion

String

Versi Kubernetes ke mana klaster dapat diperbarui.

Tidak ada.

PrivateZone

Boolean

Menunjukkan apakah Alibaba Cloud DNS PrivateZone diaktifkan untuk klaster.

Nilai valid:

  • true

  • false

ServiceDiscoveryTypes

Daftar

Jenis fitur penemuan layanan yang diimplementasikan dalam klaster ACK Serverless.

Secara default, properti ini kosong.

Nilai valid:

  • CoreDNS: CoreDNS, yang merupakan plug-in penemuan layanan standar yang disediakan oleh Kubernetes open source. Anda harus menyediakan pod untuk resolusi Domain Name System (DNS).

    Catatan

    Secara default, dua instance kontainer elastis digunakan. Spesifikasi setiap instance adalah 0,25 vCPU dan 512 MiB memori.

  • PrivateZone: Alibaba Cloud DNS PrivateZone. Anda harus mengaktifkan Alibaba Cloud DNS PrivateZone sebelum menggunakannya untuk mengimplementasikan penemuan layanan.

PrivateLink

String

Layanan PrivateLink yang terkait dengan klaster.

Tidak ada.

Profile

String

Profil yang ditentukan untuk klaster dalam skenario tertentu.

Nilai valid:

  • Default: Klaster bukan klaster ACK Edge.

  • Edge: Klaster adalah klaster ACK Edge.

DeletionProtection

Boolean

Menunjukkan apakah perlindungan penghapusan diaktifkan untuk klaster.

Jika perlindungan penghapusan diaktifkan untuk klaster, Anda tidak dapat menghapus klaster di konsol ACK atau dengan memanggil operasi API ACK tertentu. Nilai valid:

  • true

  • false

ClusterSpec

String

Tipe klaster ACK yang dikelola.

Properti ini berlaku untuk klaster ACK yang dikelola. Nilai valid:

  • ack.pro.small: Klaster ACK Pro

  • ack.standard: Klaster ACK Dasar

MaintenanceWindow

Peta

Konfigurasi jendela pemeliharaan klaster.

Properti ini hanya berlaku untuk klaster ACK Pro. Untuk informasi lebih lanjut, lihat maintenance_window.

Capabilities

Peta

Fitur versi Kubernetes.

Tidak ada.

EnabledMigration

Boolean

Menunjukkan apakah migrasi diaktifkan untuk klaster.

Nilai valid:

  • true

  • false

NeedUpdateAgent

Boolean

Menunjukkan apakah agen dapat diperbarui.

Nilai valid:

  • true

  • false

Outputs

Daftar

Informasi keluaran tentang klaster.

Contoh: [ { "Description": "Log Info Output", "OutputKey": "LastKnownError", "OutputValue": null }, { "Description": "Error msg of ess scaling instance", "OutputKey": "NodesScalingErrorInfo", "OutputValue": null }, { "Description": "The mode we use in kube-proxy.", "OutputKey": "ProxyMode", "OutputValue": "ipvs" }, { "Description": "ScalingGroup ID", "OutputKey": "ScalingGroupID", "OutputValue": "asg-2zebrr08gt5uluh7****" }, { "Description": "Ids of worker node", "OutputKey": "NodeInstanceIDs", "OutputValue": [ "i-2ze4ymrjuocpbc0c****", "i-2ze4ymrjuocpbc0c****", "i-2ze4ymrjuocpbc0c****" ] }, { "Description": "Count of ess scaling instance", "OutputKey": "NodesScalingAddedInstances", "OutputValue": 3 } ].

Parameters

Peta

Parameter masukan klaster.

Tidak ada.

WorkerRamRoleName

String

Nama peran Resource Access Management (RAM) untuk node pekerja.

Peran RAM ditetapkan ke node pekerja klaster untuk memungkinkan node pekerja mengelola instance Elastic Compute Service (ECS).

MaintenanceInfo

Peta

Konfigurasi pemeliharaan klaster.

Tidak ada.

Contoh

Format JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ClusterSpec": {
      "Type": "String",
      "Description": "Spesifikasi klaster. Jika Anda menetapkan tipe klaster ke ManagedKubernetes, Anda dapat menggunakan spesifikasi klaster untuk membedakan klaster. Nilai valid:\nack.pro.small: klaster Kubernetes terkelola profesional\nack.standard: klaster Kubernetes terkelola standar\nSecara default, parameter ini kosong. Ini menunjukkan bahwa parameter ini tidak digunakan untuk memfilter klaster."
    },
    "ClusterType": {
      "Type": "String",
      "Description": "Tipe klaster. Nilai valid:\nKubernetes: klaster Kubernetes khusus\nManagedKubernetes: klaster Kubernetes terkelola, klaster Kubernetes serverless (ASK), atau klaster Kubernetes edge\nAsk: klaster ASK\nExternalKubernetes: klaster eksternal terdaftar\nSaat Anda menanyakan klaster ASK, nilai yang ditentukan saat pembuatan klaster dikembalikan."
    },
    "Profile": {
      "Type": "String",
      "Description": "Pengenal klaster. Jika Anda menetapkan tipe klaster ke ManagedKubernetes, Anda dapat menggunakan pengenal klaster untuk membedakan klaster. Nilai valid:\nDefault: klaster Kubernetes terkelola\nServerless: klaster ASK\nEdge: klaster Kubernetes edge\nSecara default, parameter ini kosong. Ini menunjukkan bahwa parameter ini tidak digunakan untuk memfilter klaster."
    },
    "Name": {
      "Type": "String",
      "Description": "Nama klaster. Nama harus memiliki panjang 1 hingga 63 karakter, dan dapat berisi angka, huruf, dan tanda hubung (-). Tidak boleh dimulai dengan tanda hubung (-)."
    }
  },
  "Resources": {
    "KubernetesClusters": {
      "Type": "DATASOURCE::CS::KubernetesClusters",
      "Properties": {
        "ClusterSpec": {
          "Ref": "ClusterSpec"
        },
        "ClusterType": {
          "Ref": "ClusterType"
        },
        "Profile": {
          "Ref": "Profile"
        },
        "Name": {
          "Ref": "Name"
        }
      }
    }
  },
  "Outputs": {
    "Clusters": {
      "Description": "Daftar klaster.",
      "Value": {
        "Fn::GetAtt": [
          "KubernetesClusters",
          "Clusters"
        ]
      }
    },
    "ClusterIds": {
      "Description": "Daftar ID klaster.",
      "Value": {
        "Fn::GetAtt": [
          "KubernetesClusters",
          "ClusterIds"
        ]
      }
    }
  }
}

Format YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ClusterSpec:
    Type: String
    Description: |-
      Spesifikasi klaster. Jika Anda menetapkan tipe klaster ke ManagedKubernetes, Anda dapat menggunakan spesifikasi klaster untuk membedakan klaster. Nilai valid:
      ack.pro.small: klaster Kubernetes terkelola profesional
      ack.standard: klaster Kubernetes terkelola standar
      Secara default, parameter ini kosong. Ini menunjukkan bahwa parameter ini tidak digunakan untuk memfilter klaster.
  ClusterType:
    Type: String
    Description: |-
      Tipe klaster. Nilai valid:
      Kubernetes: klaster Kubernetes khusus
      ManagedKubernetes: klaster Kubernetes terkelola, klaster Kubernetes serverless (ASK), atau klaster Kubernetes edge
      Ask: klaster ASK
      ExternalKubernetes: klaster eksternal terdaftar
      Saat Anda menanyakan klaster ASK, nilai yang ditentukan saat pembuatan klaster dikembalikan.
  Profile:
    Type: String
    Description: |-
      Pengenal klaster. Jika Anda menetapkan tipe klaster ke ManagedKubernetes, Anda dapat menggunakan pengenal klaster untuk membedakan klaster. Nilai valid:
      Default: klaster Kubernetes terkelola
      Serverless: klaster ASK
      Edge: klaster Kubernetes edge
      Secara default, parameter ini kosong. Ini menunjukkan bahwa parameter ini tidak digunakan untuk memfilter klaster.
  Name:
    Type: String
    Description: Nama klaster. Nama harus memiliki panjang 1 hingga 63 karakter, dan dapat berisi angka, huruf, dan tanda hubung (-). Tidak boleh dimulai dengan tanda hubung (-).
Resources:
  KubernetesClusters:
    Type: DATASOURCE::CS::KubernetesClusters
    Properties:
      ClusterSpec:
        Ref: ClusterSpec
      ClusterType:
        Ref: ClusterType
      Profile:
        Ref: Profile
      Name:
        Ref: Name
Outputs:
  Clusters:
    Description: Daftar klaster.
    Value:
      Fn::GetAtt:
        - KubernetesClusters
        - Clusters
  ClusterIds:
    Description: Daftar ID klaster.
    Value:
      Fn::GetAtt:
        - KubernetesClusters
        - ClusterIds