調用ALIYUN::CS::ManagedEdgeKubernetesCluster建立Kubernetes邊緣託管版叢集執行個體 -

ALIYUN::CS::ManagedEdgeKubernetesCluster類型用於建立Kubernetes邊緣託管版叢集執行個體。

文法

{ 
  "Type": "ALIYUN::CS::ManagedEdgeKubernetesCluster",
  "Properties": {
    "Profile": String,
    "VpcId": String,
    "ServiceCidr": String,
    "Name": String,
    "Tags": List,
    "ProxyMode": String,
    "SnatEntry": Boolean,
    "LoginPassword": String,
    "KeyPair": String,
    "Addons": List,
    "EndpointPublicAccess": Boolean,
    "TimeoutMins": Number,
    "ClusterSpec": String,
    "ContainerCidr": String,
    "CloudMonitorFlags": Boolean,
    "IsEnterpriseSecurityGroup": Boolean,
    "NodeCidrMask": String,
    "DeletionProtection": Boolean,
    "ResourceGroupId": String
  }
}

屬性

屬性名稱	類型	必須	允許更新	描述	約束
Name	String	是	否	叢集名稱。	以英文字母或數字開頭，可包含英文字母、漢字、數字和短劃線（-）。
Addons	List	否	否	叢集安裝的組件列表。	取值：網路組件支援Flannel和Terway兩種網路類型，建立叢集時需二選一： Flannel網路：`[{"Name":"flannel","Config":""}]`。 Terway網路：`[{"Name": "terway-eniip","Config": ""}]`。儲存群組件支援CSI和FlexVolume兩種類型： csi：`[{"Name":"csi-plugin","Config": ""},{"Name": "csi-provisioner","Config": ""}]`。 flexvolume：`[{"Name": "flexvolume","Config": ""}]`。日誌組件（可選）說明如果不開啟Log Service，將無法使用叢集審計功能。使用已有SLS Project：`[{"Name": "logtail-ds","Config": "{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}]`。建立新的SLS Project：`[{"Name": "logtail-ds","Config": "{\"IngressDashboardEnabled\":\"true\"}"}]`。 Ingress組件（可選） Kubernetes專有版叢集預設安裝Ingress組件nginx-ingress-controller。安裝Ingress並且開啟公網：`[{"Name":"nginx-ingress-controller","Config":"{\"IngressSlbNetworkType\":\"internet\"}"}]`。不安裝Ingress：`[{"Name": "nginx-ingress-controller","Config": "","Disabled": true}]`。事件中心（可選，預設開啟）事件中心提供對Kubernetes事件的儲存、查詢、警示等能力。Kubernetes事件中心關聯的Logstore在90天內免費。更多資訊，請參見建立並使用Kubernetes事件中心。開啟事件中心：`[{"Name":"ack-node-problem-detector","Config":"{\"sls_project_name\":\"your_sls_project_name\"}"}]`。更多資訊，請參見Addons屬性。
CloudMonitorFlags	Boolean	否	否	是否安裝CloudMonitor外掛程式。	取值： true：安裝。 false（預設值）：不安裝。
ClusterSpec	String	否	否	託管版叢集類型。	取值： ack.pro.small：專業託管叢集，即：ACK@Edge Pro版叢集。 ack.standard（預設值）：標準託管叢集，即ACK@Edge標準版叢集。
ContainerCidr	String	否	否	Pod網路位址區段。	當建立Flannel網路類型的叢集時，ContainerCidr為必填。ContainerCidr必須是有效私人網段，即以下網段及其子網： 10.0.0.0/8 172.16-31.0.0/12-16 192.168.0.0/16 不能與專用網路及專用網路內已有Kubernetes叢集使用的網段重複，且建立成功後不能修改。關於叢集網路規劃，請參見Kubernetes叢集網路規劃。
DeletionProtection	Boolean	否	是	是否啟用刪除保護功能。	啟用刪除保護後，叢集不能被直接刪除。取值： true：啟用。 false（預設值）：禁用。
EndpointPublicAccess	Boolean	否	否	是否開啟公網API Server。	取值： true（預設值）：開啟公網API Server。 false：僅開啟私網API Server。
IsEnterpriseSecurityGroup	Boolean	否	否	是否建立進階安全性群組。	當SecurityGroupId為空白時，該參數生效。取值： true：建立。安裝了Terway的叢集，必須建立進階安全性群組。 false（預設值）：不建立。
KeyPair	String	否	否	金鑰組名稱。	LoginPassword和KeyPair二者只能指定一個參數。
LoginPassword	String	否	否	登入密碼。	長度為8~30個字元。必須同時包含大寫英文字母、小寫英文字母，數字和特殊字元中至少三項，支援的特殊字元為：( ) ` ~ ! @ # $ % ^ & * - + = \| { } [ ] : ; ‘ < > , . ? /。 LoginPassword和KeyPair二者只能指定一個參數。
NodeCidrMask	String	否	否	可分配給節點的最大CIDR地址塊數量。	數量由指定的pod CIDR決定。該參數僅在叢集使用Flannel外掛程式時生效。預設值：25。
Profile	String	否	否	邊緣叢集標識。	預設值：Edge。
ProxyMode	String	否	否	kube-proxy代理模式。	取值： iptables（預設值） ipvs
ResourceGroupId	String	否	是	叢集所屬的資源群組ID。	無
ServiceCidr	String	否	否	服務網段。	不能與專用網路網段以及容器網段衝突。當選擇系統自動建立專用網路時，預設使用172.19.0.0/20網段。
SnatEntry	Boolean	否	否	是否為網路設定SNAT。	取值： true：配置。 false（預設值）：不配置。說明如果使用自動建立的專用網路，則必須設定為true。如果使用已有非系統自動建立的專用網路，則需要根據是否具備出網能力來設定。
Tags	List	否	是	標籤。	最多可以設定20個標籤。更多資訊，請參見Tags屬性。
TimeoutMins	Number	否	否	叢集資源棧建立逾時時間。	預設值：60。單位：分鐘。
VpcId	String	否	否	專用網路ID。	如果不設定，系統會自動建立專用網路，系統建立的專用網路網段為192.168.0.0/16。 VpcId和VSwitchIds只能同時為空白或者同時都設定對應的值。

Tags文法

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]

Tags屬性

屬性名稱	類型	必須	允許更新	描述	約束
Key	String	是	否	標籤鍵。	長度為1~64個字元，不能以`aliyun`、`acs:`、`https://`或`http://`開頭。
Value	String	否	否	標籤值。	長度為0~128個字元，不能以`aliyun`、`acs:`、`https://`或`http://`開頭。

Addons文法

"Addons": [
  {
    "Disabled": Boolean,
    "Config": String,
    "Name": String
  }
]

Addons屬性

屬性名稱	類型	必須	允許更新	描述	約束
Name	String	是	否	組件名稱。	無
Config	String	否	否	組件配置。	無
Disabled	Boolean	否	否	是否禁止預設安裝組件。	取值： true：禁止預設安裝組件。 false（預設值）：允許預設安裝組件。

傳回值

Fn::GetAtt

ClusterId：叢集ID。
TaskId：任務ID。系統自動分配，用於查詢任務狀態。
DefaultUserKubeConfig：使用者配置叢集憑據的預設Kubernetes配置。
ScalingRuleId：伸縮規則ID。
ScalingGroupId：伸縮組ID。
PrivateUserKubConfig：使用者配置叢集憑據的專有Kubernetes配置。
ScalingConfigurationId：伸縮配置ID。
Nodes：叢集節點列表。
APIServerSLBId：API伺服器負載平衡ID。
IngressSLBId：Ingress負載平衡ID。

樣本

`YAML`格式

ROSTemplateFormatVersion: '2015-09-01'
Description: Test ManagedEdgeKubernetesCluster
Parameters:
  VSwitchZoneId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
    Description: Availability ID for existing switches
    Label: VSwitch Zone ID
  VpcId:
    Type: String
    Default: Null
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
    Description: Please search the ID starts with (vpc-xxx)from console-Virtual Private Cloud
    Label: Existing VPC ID
  VSwitchId:
    Type: String
    Default: Null
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    Description: Please search the business VSwitch ID starts with(vsw-xxx)from console-Virtual Private Cloud-VSwitches
    Label: VSwitch ID
    AssociationPropertyMetadata:
      ZoneId: ${VSwitchZoneId}
      VpcId: ${VpcId}
  ClusterName:
    Type: String
    Default: mytest
  Password:
    Type: String
    Description: Server login password, Length 8-30, must contain three(Capital letters, lowercase letters, numbers, ()`~!@#$%^*_-+=|{}[]:;,.? Special symbol in).
    MinLength: 8
    Label: Instance Password
    NoEcho: true
    MaxLength: 30
    ConstraintDescription: Length 8-30, must contain three(Capital letters, lowercase letters, numbers, ()`~!@#$%^*_-+=|{}[]:;',.?/ Special symbol in).
  NumOfNodes:
    Type: Number
    Default: 1
    MinValue: 0
    MaxValue: 300
Resources:
  Cluster:
    Type: ALIYUN::CS::ManagedEdgeKubernetesCluster
    Properties:
      NumOfNodes:
        Ref: NumOfNodes
      Name:
        Ref: ClusterName
      LoginPassword:
        Ref: Password
      VpcId:
        Ref: VpcId
      VSwitchIds:
        - Ref: VSwitchId
      ServiceCidr: 172.19.0.0/20
Outputs:
  ClusterId:
    Value:
      Fn::GetAtt:
        - Cluster
        - ClusterId
  TaskId:
    Value:
      Fn::GetAtt:
        - Cluster
        - TaskId

`JSON`格式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test ManagedEdgeKubernetesCluster",
  "Parameters": {
    "VSwitchZoneId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId",
      "Description": "Availability ID for existing switches",
      "Label": "VSwitch Zone ID"
    },
    "VpcId": {
      "Type": "String",
      "Default": null,
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId",
      "Description": "Please search the ID starts with (vpc-xxx)from console-Virtual Private Cloud",
      "Label": "Existing VPC ID"
    },
    "VSwitchId": {
      "Type": "String",
      "Default": null,
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "Description": "Please search the business VSwitch ID starts with(vsw-xxx)from console-Virtual Private Cloud-VSwitches",
      "Label": "VSwitch ID",
      "AssociationPropertyMetadata": {
        "ZoneId": "${VSwitchZoneId}",
        "VpcId": "${VpcId}"
      }
    },
    "ClusterName": {
      "Type": "String",
      "Default": "mytest"
    },
    "Password": {
      "Type": "String",
      "Description": "Server login password, Length 8-30, must contain three(Capital letters, lowercase letters, numbers, ()`~!@#$%^*_-+=|{}[]:;,.? Special symbol in).",
      "MinLength": 8,
      "Label": "Instance Password",
      "NoEcho": true,
      "MaxLength": 30,
      "ConstraintDescription": "Length 8-30, must contain three(Capital letters, lowercase letters, numbers, ()`~!@#$%^*_-+=|{}[]:;',.?/ Special symbol in)."
    },
    "NumOfNodes": {
      "Type": "Number",
      "Default": 1,
      "MinValue": 0,
      "MaxValue": 300
    }
  },
  "Resources": {
    "Cluster": {
      "Type": "ALIYUN::CS::ManagedEdgeKubernetesCluster",
      "Properties": {
        "NumOfNodes": {
          "Ref": "NumOfNodes"
        },
        "Name": {
          "Ref": "ClusterName"
        },
        "LoginPassword": {
          "Ref": "Password"
        },
        "VpcId": {
          "Ref": "VpcId"
        },
        "VSwitchIds": [
          {
            "Ref": "VSwitchId"
          }
        ]
        "ServiceCidr": "172.19.0.0/20"
      }
    }
  },
  "Outputs": {
    "ClusterId": {
      "Value": {
        "Fn::GetAtt": [
          "Cluster",
          "ClusterId"
        ]
      }
    },
    "TaskId": {
      "Value": {
        "Fn::GetAtt": [
          "Cluster",
          "TaskId"
        ]
      }
    }
  }
}

文法

屬性

Tags文法

Tags屬性

Addons文法

Addons屬性

傳回值

樣本

YAML格式

JSON格式

`YAML`格式

`JSON`格式