全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::CS::ClusterHelmApplication

更新时间:Oct 18, 2025

Tipe ALIYUN::CS::ClusterHelmApplication digunakan untuk menerapkan aplikasi menggunakan Helm.

Sintaksis

{
  "Type": "ALIYUN::CS::ClusterHelmApplication",
  "Properties": {
    "ChartValues": Map,
    "ClusterId": String,
    "ChartUrl": String,
    "Namespace": String,
    "Name": String,
    "Credential": Map,
    "RolePolicy": String,
    "WaitUntil": List,
    "ValidationMode": String,
    "NamespaceDeletion": Boolean,
    "IgnoreExisting": String
  }
}

Properti

Properti

Tipe

Diperlukan

Izin pembaruan

Deskripsi

Kendala

ChartUrl

String

Ya

Ya

URL dari chart.

Tidak ada.

ClusterId

String

Ya

Tidak

ID kluster.

Tidak ada.

Name

String

Ya

Tidak

Nama chart.

Tidak ada.

ChartValues

Map

Tidak

Ya

Nilai kustom dari chart.

Tidak ada.

Credential

Map

Tidak

Tidak

Kredensial akses.

Tidak ada.

Namespace

String

Tidak

Tidak

Namespace Helm.

Tidak ada.

RolePolicy

String

Tidak

Ya

Kebijakan yang terkait dengan peran pengguna saat ini.

Sebelum Anda menerapkan aplikasi, periksa kebijakan yang dilampirkan pada peran pengguna saat ini. 

Nilai valid:

  • EnsureAdminRoleAndBinding (default): Peran administrator bernama ros:application-admin:${user-id}\ secara otomatis dibuat dan dilampirkan ke pengguna saat ini. 

  • None: Tidak ada operasi yang dilakukan.

ValidationMode

String

Tidak

Tidak

Mode validasi.

Nilai valid:

  • Basic: Validasi dasar dilakukan. Misalnya, sistem memeriksa apakah kluster ada.

  • Ketat: Selain validasi dasar, sistem memeriksa apakah properti WaitUntil valid. 

WaitUntil

List

Tidak

Ya

Setelah Anda mulai membuat atau memperbarui aplikasi, sistem menunggu hingga semua kondisi yang ditentukan terpenuhi. 

Untuk informasi lebih lanjut, lihat Properti WaitUntil.

NamespaceDeletion

Boolean

Tidak

Ya

Menentukan apakah akan menghapus namespace yang ditentukan oleh DefaultNamespace.

Jika DefaultNamespace diatur ke `default`, `kube-node-lease`, `kube-public`, `kube-system`, atau `arms-prom`, namespace tidak dihapus, terlepas dari nilai NamespaceDeletion.

IgnoreExisting

String

Tidak

Tidak

Menentukan cara menangani aplikasi Helm yang sudah ada.

Nilai valid:

  • Disabled (default): Kesalahan dilaporkan selama pembuatan jika aplikasi Helm dengan nama yang sama sudah ada.

  • SkipInstallifExisting: Proses pembuatan dilewati jika aplikasi Helm dengan nama yang sama sudah ada.

  • SkipAlloperationsIfExisting: Proses pembuatan dilewati jika aplikasi Helm dengan nama yang sama sudah ada. Jika aplikasi Helm tidak dibuat oleh sumber daya ini, aplikasi diabaikan selama tahap pembaruan dan penghapusan.

Sintaksis Credential

"Credential": [
  {
    "Password": String,
    "UserName": String
  }
]

Properti Credential

Properti

Tipe

Diperlukan

Izin pembaruan

Deskripsi

Kendala

Password

String

Ya

Tidak

Kata sandi.

Tidak ada.

UserName

String

Ya

Tidak

Nama pengguna.

Tidak ada.

Sintaksis WaitUntil

"WaitUntil": [
  {
   "ApiVersion": String,
   "FirstMatch": Boolean,
   "Timeout": Integer,
   "JsonPath": String,
   "Namespace": String,
   "Stage": String,
   "Name": String,
   "ValueType": String,
   "Kind": String,
   "Value": String,
   "Operator": String
  }
]

Properti WaitUntil

Properti

Tipe

Diperlukan

Mengaktifkan pembaruan

Deskripsi

Kendala

Kind

String

Ya

Ya

Tipe sumber daya Kubernetes yang akan dikueri.

Tidak ada.

Name

String

Ya

Ya

Nama sumber daya Kubernetes yang akan dikueri.

Tidak ada.

Operator

String

Ya

Ya

Operator untuk membandingkan nilai dengan hasil ekspresi JSONPath. 

Tidak ada.

ApiVersion

String

Tidak

Ya

Versi API.

Tidak ada.

FirstMatch

Boolean

Tidak

Ya

Menentukan apakah hanya hasil pertama yang cocok dari hasil yang difilter oleh ekspresi JSONPath yang dikembalikan. 

Nilai valid:

  • true

  • false (default)

JsonPath

String

Tidak

Ya

Ekspresi JSONPath untuk menyaring hasil.

Tidak ada.

Namespace

String

Tidak

Ya

Namespace Kubernetes tempat sumber daya berada.

Nilai default: DefaultNamespace.  

Stage

String

Tidak

Tidak

Tahap di mana sistem menunggu.  

Nilai valid:

  • Create/Update (default): Tahap pembuatan dan pembaruan.

  • Delete: Tahap penghapusan. 

Timeout

Integer

Tidak

Ya

Periode waktu habis untuk kondisi yang harus dipenuhi.

Satuan: detik.

Value

String

Tidak

Ya

Nilai untuk dibandingkan dengan hasil ekspresi JSONPath. 

Tidak ada.

ValueType

String

Tidak

Ya

Tipe nilai.

Nilai default: String.

Nilai kembali

Fn::GetAtt

  • ClusterId: ID kluster.

  • WaitUntilData: Daftar nilai yang dikembalikan untuk ekspresi JSONPath dalam WaitUntil.

Contoh

Gunakan template berikut untuk menerapkan Knative, gerbang layanan Kourier, dan komponen KServe dengan satu klik menggunakan Resource Orchestration Service (ROS). Untuk informasi lebih lanjut tentang penyebaran satu klik di Container Service for Kubernetes (ACK), lihat Menerapkan dan mengelola komponen Knative.

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DBClusterId:
    Type: String
    Label:
      en: Cluster ID
    AssociationProperty: ALIYUN::CS::Cluster::ClusterId
Resources:
  HelmOfKnativeKourier:
    Type: ALIYUN::CS::ClusterHelmApplication
    Properties:
      ClusterId:
        Ref: DBClusterId
      ChartUrl: https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-kourier-1.4.0.tgz
      Name: knative-kourier
      Namespace: knative-serving
      ChartValues:
        version: v1.10.9-aliyun.1
        regionID:
          Ref: ALIYUN::Region
  HelmOfKnativeServing:
    Type: ALIYUN::CS::ClusterHelmApplication
    Properties:
      ClusterId:
        Ref: DBClusterId
      ChartUrl: https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-serving-v1.10.9-aliyun.1.tgz
      Name: knative-serving
      Namespace: knative-serving
      ChartValues:
        version: v1.10.9-aliyun.1
        regionID:
          Ref: ALIYUN::Region
    DependsOn: HelmOfKnativeKourier
  HelmOfKnativeKserve:
    Type: ALIYUN::CS::ClusterHelmApplication
    Properties:
      ClusterId:
        Ref: DBClusterId
      ChartUrl: https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-kserve-v0.10.1.tgz
      Name: knative-kserve
      Namespace: kserve
      ChartValues:
        version: v1.10.9-aliyun.1
        regionID:
          Ref: ALIYUN::Region
    DependsOn: HelmOfKnativeServing
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DBClusterId": {
      "Type": "String",
      "Label": {
        "en": "ID Kluster"
      },
      "AssociationProperty": "ALIYUN::CS::Cluster::ClusterId"
    }
  },
  "Resources": {
    "HelmOfKnativeKourier": {
      "Type": "ALIYUN::CS::ClusterHelmApplication",
      "Properties": {
        "ClusterId": {
          "Ref": "DBClusterId"
        },
        "ChartUrl": "https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-kourier-1.4.0.tgz",
        "Name": "knative-kourier",
        "Namespace": "knative-serving",
        "ChartValues": {
          "version": "v1.10.9-aliyun.1",
          "regionID": {
            "Ref": "ALIYUN::Region"
          }
        }
      }
    },
    "HelmOfKnativeServing": {
      "Type": "ALIYUN::CS::ClusterHelmApplication",
      "Properties": {
        "ClusterId": {
          "Ref": "DBClusterId"
        },
        "ChartUrl": "https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-serving-v1.10.9-aliyun.1.tgz",
        "Name": "knative-serving",
        "Namespace": "knative-serving",
        "ChartValues": {
          "version": "v1.10.9-aliyun.1",
          "regionID": {
            "Ref": "ALIYUN::Region"
          }
        }
      },
      "DependsOn": "HelmOfKnativeKourier"
    },
    "HelmOfKnativeKserve": {
      "Type": "ALIYUN::CS::ClusterHelmApplication",
      "Properties": {
        "ClusterId": {
          "Ref": "DBClusterId"
        },
        "ChartUrl": "https://aliacs-app-catalog.oss-cn-hangzhou.aliyuncs.com/charts-incubator/ack-knative-kserve-v0.10.1.tgz",
        "Name": "knative-kserve",
        "Namespace": "kserve",
        "ChartValues": {
          "version": "v1.10.9-aliyun.1",
          "regionID": {
            "Ref": "ALIYUN::Region"
          }
        }
      },
      "DependsOn": "HelmOfKnativeServing"
    }
  }
}