すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::CS::ClusterHelmApplication

最終更新日:Oct 18, 2025

ALIYUN::CS::ClusterHelmApplication タイプは、Helm を使用してアプリケーションをデプロイするために使用されます。

構文

{
  "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
  }
}

プロパティ

プロパティ

タイプ

必須

更新を許可

説明

制約

ChartUrl

String

はい

はい

チャートの URL です。

なし。

ClusterId

String

はい

いいえ

クラスター ID です。

なし。

Name

String

はい

いいえ

チャートの名前。

なし。

ChartValues

Map

いいえ

はい

チャートのカスタム値。

なし。

Credential

Map

いいえ

いいえ

アクセス資格情報です。

なし。

Namespace

String

いいえ

いいえ

Helm の名前空間。

なし。

RolePolicy

String

いいえ

はい

現在のユーザーのロールに関連付けられているポリシーです。

アプリケーションをデプロイする前に、現在のユーザーのロールにアタッチされているポリシーを確認してください。

有効な値:

  • EnsureAdminRoleAndBinding (デフォルト): ros:application-admin:${user-id}\ という名前の管理者ロールが自動的に作成され、現在のユーザーにアタッチされます。 

  • None: 操作は実行されません。

ValidationMode

String

いいえ

いいえ

検証モード。

有効な値:

  • Basic: 基本的な検証が実行されます。たとえば、システムはクラスターが存在するかどうかをチェックします。

  • Strict: 基本的な検証に加えて、システムは WaitUntil プロパティが有効かどうかをチェックします。

WaitUntil

List

いいえ

はい

アプリケーションの作成または更新を開始した後、指定されたすべての条件が満たされるまでシステムは待機します。

詳細については、「WaitUntil プロパティ」をご参照ください。

NamespaceDeletion

Boolean

いいえ

はい

DefaultNamespace で指定された名前空間を削除するかどうかを指定します。

DefaultNamespace が `default`、`kube-node-lease`、`kube-public`、`kube-system`、または `arms-prom` に設定されている場合、NamespaceDeletion の値に関係なく、名前空間は削除されません。

IgnoreExisting

String

いいえ

いいえ

既存の Helm アプリケーションの処理方法を指定します。

有効な値:

  • Disabled (デフォルト): 同じ名前の Helm アプリケーションが存在する場合、作成中にエラーが報告されます。

  • SkipInstallifExisting: 同じ名前の Helm アプリケーションが存在する場合、作成プロセスはスキップされます。

  • SkipAlloperationsIfExisting: 同じ名前の Helm アプリケーションが存在する場合、作成プロセスはスキップされます。Helm アプリケーションがこのリソースによって作成されなかった場合、アプリケーションは更新および削除ステージで無視されます。

Credential 構文

"Credential": [
  {
    "Password": String, // ログインパスワード
    "UserName": String // ログインユーザー名
  }
]

Credential プロパティ

プロパティ

タイプ

必須

更新を許可

説明

制約

Password

String

はい

いいえ

パスワードです。

なし。

UserName

String

はい

いいえ

ユーザー名です。

なし。

WaitUntil 構文

"WaitUntil": [
  {
   "ApiVersion": String, // API バージョン
   "FirstMatch": Boolean, // JSONPath 式でフィルタリングされた結果で最初に一致した結果のみを返すかどうかを指定します。
   "Timeout": Integer, // 条件が満たされるまで待機するタイムアウト期間。単位: 秒。
   "JsonPath": String, // 結果をフィルタリングするために使用する JSONPath 式。
   "Namespace": String, // リソースの Kubernetes 名前空間。デフォルト値: DefaultNamespace。
   "Stage": String, // システムが待機する 1 つ以上のステージ。有効な値: Create/Update (デフォルト): 作成および更新ステージ。Delete: 削除ステージ。
   "Name": String, // クエリする Kubernetes リソースの名前。
   "ValueType": String, // 値のタイプ。デフォルト値: String
   "Kind": String, // クエリする Kubernetes リソースのタイプ。
   "Value": String, // JSONPath 式の結果と比較する値。
   "Operator": String // 値と JSONPath 式の結果を比較するために使用する演算子。
  }
]

WaitUntil プロパティ

プロパティ

タイプ

必須

更新の有効化

説明

制約

Kind

String

はい

はい

クエリする Kubernetes リソースのタイプです。

なし。

Name

String

はい

はい

クエリする Kubernetes リソースの名前です。

なし。

Operator

String

はい

はい

値を JSONPath 式の結果と比較するためのオペレーターです。

なし。

ApiVersion

String

いいえ

はい

API バージョンです。

なし。

FirstMatch

Boolean

いいえ

はい

JSONPath 式でフィルターされた結果から、最初に一致した結果のみを返すかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

JsonPath

String

いいえ

はい

結果をフィルターするための JSONPath 式です。

なし。

Namespace

String

いいえ

はい

リソースが存在する Kubernetes 名前空間です。

デフォルト値: DefaultNamespace。

Stage

String

いいえ

いいえ

システムが待機するステージです。

有効な値:

  • Create/Update (デフォルト): 作成および更新ステージ。

  • Delete: 削除ステージ。

Timeout

Integer

いいえ

はい

条件が満たされるまでのタイムアウト期間です。

単位: 秒。

Value

String

いいえ

はい

JSONPath 式の結果と比較する値です。

なし。

ValueType

String

いいえ

はい

値のタイプです。

デフォルト値: String。

戻り値

Fn::GetAtt

  • ClusterId: クラスター ID。

  • WaitUntilData: WaitUntil の JSONPath 式に対して返される値のリスト。

以下のテンプレートを使用して、Resource Orchestration Service (ROS) を使用してワンクリックで Knative、Kourier サービスゲートウェイ、および KServe コンポーネントをデプロイします。Container Service for Kubernetes (ACK) でのワンクリックデプロイの詳細については、「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": "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"
    }
  }
}