Alibaba Cloud Container Compute Service (ACS) は、Kubernetes ネイティブ API を備えたサーバーレスのコンテナコンピューティングを提供します。ACS クラスターは数秒で Pod をスケールでき、設定した CPU とメモリに基づいて従量課金されるため、変動の大きいワークロードに最適です。コンソールまたは OpenAPI を使用して ACS クラスターを作成できます。
コンソール
ステップ 1:クラスター作成ページを開く
ACS コンソール にログインします。左側のナビゲーションペインで、クラスター をクリックします。
クラスター ページの左上隅にある クラスターの作成 をクリックします。
ステップ 2:クラスターの構成
Kubernetes クラスターの作成 ページで、クラスター、ネットワーク、コンポーネント、詳細設定を構成します。
クラスター設定
|
パラメーター |
説明 |
|
[クラスター名] |
クラスターの名前を入力します。 |
|
[リージョン] |
クラスターのリージョンを選択します。Supported regions。 |
|
[Kubernetes バージョン] |
ACS がサポートする Kubernetes バージョンを選択します。 |
|
[Maintenance Window] |
クラスターのメンテナンスウィンドウ。 |
ネットワーク設定
|
パラメーター |
説明 |
|
[IPv6 デュアルスタック] |
デュアルスタックの Kubernetes クラスターを有効にします。 説明
既存を使用 を選択する場合は、事前に VPC と vSwitch で IPv6 を有効にしてください。Enable IPv6 for a VPC および Enable IPv6 for a vSwitch。 |
|
[Select VPC] |
クラスターのネットワークを構成します。Plan networks for ACS clusters。 ACS クラスターは VPC のみを使用します。新しい VPC を作成するか、既存の VPC を使用できます。
高可用性のために、複数のアベイラビリティーゾーンまたは vSwitch を選択してください。リソース設定の推奨 機能は、選択したコンピュートタイプに基づいて、十分なコンピュートリソースを備えたアベイラビリティーゾーンを推奨します。 説明
ACS クラスターでは、Node オブジェクトは仮想ノードとして提供されます。ACS クラスターを作成すると、選択した各アベイラビリティーゾーンに対応する仮想ノードを ACS が作成します。 |
|
[SNAT の設定] |
VPC 用に NAT Gateway を作成し、SNAT ルールを構成するかどうかを指定します。コンテナイメージのプルなど、パブリックインターネットへアクセスするために必要です。 説明
|
|
[セキュリティグループ] |
基本セキュリティグループまたはエンタープライズセキュリティグループを作成するかどうかを選択します。Security group overview。 |
|
[API Server Access Settings] |
デフォルトでは、API server 用に従量課金のプライベートなクラシックロードバランサー (CLB) インスタンスが作成されます。CLB インスタンスの課金については、「Pay-as-you-go」をご参照ください。 重要
デフォルトの CLB インスタンスを削除すると、API server にアクセスできなくなります。 EIP で API サーバーの公開 を構成するかどうかを指定できます。API server は、Pod や Service などの各種リソースオブジェクトに対する作成、読み取り、更新、削除 (CRUD)、および watch 操作のための HTTP RESTful インターフェイスを提供します。
|
|
Service CIDR |
Service CIDR ブロックは、VPC CIDR ブロックまたは VPC 内の他の Kubernetes クラスターの CIDR ブロックと重複できません。クラスター作成後は変更できません。また、Service と Pod のアドレス範囲も重複できません。 |
コンポーネント設定
|
パラメーター |
説明 |
|
[サービスディスカバリー] |
サービスディスカバリを有効にするかどうかを指定します。ACS クラスターは CoreDNS をサポートします。 CoreDNS は、クラスター内サービスのドメイン名を解決する標準の Kubernetes DNS サーバーです。 |
|
Ingress |
オプションです。Ingress コンポーネントをインストールして、Service を外部トラフィックに公開します。 ACS は次の Ingress コンポーネントをサポートします:
|
|
[コンテナーモニタリング] |
次のモニタリング機能はデフォルトで有効になります:
|
|
[Log Service] |
Simple Log Service を使用するかどうかを指定します。新しいプロジェクトを作成するか、既存のプロジェクトを使用できます。 この機能を有効にすると、cluster auditing とコントロールプレーンのログ収集が自動的に有効になります。 |
詳細設定
事前設定の表示 をクリックし、必要に応じて詳細設定を構成します。
|
パラメーター |
説明 |
|
[削除保護] |
削除保護を有効にして、誤ってクラスターを削除するのを防ぎます。 |
|
[リソースグループ] |
ACS はクラスターを選択した resource group に追加します。リソースは 1 つのリソースグループに属します。ビジネス要件に基づき、リソースグループをプロジェクト、アプリケーション、または組織にマッピングします。 |
|
[ラベル] |
クラスターにタグを追加します。キーは必須かつ一意で、最大 64 文字です。値は任意で、最大 128 文字です。
|
|
[タイムゾーン] |
クラスターのタイムゾーン。デフォルトでは、クラスターはブラウザーのタイムゾーンを使用します。 |
|
[クラスタードメイン] |
クラスターのローカルドメイン名。デフォルト: クラスターのドメインは、すべての Service で使用されるトップレベルのサフィックスです。たとえば、default 名前空間の |
ステップ 3:構成の確認
-
クラスターを構成したら、注文の確認 をクリックします。
-
表示されるダイアログボックスで、選択した構成を確認し、すべての依存関係チェックに合格していることを確認します。
-
利用規約をよく読み、同意してから、クラスターの作成 をクリックします。
クラスターの作成後、クラスター ページで確認できます。
説明クラスターの作成には通常約 10 分かかります。
関連操作
-
クラスターの基本情報の表示
クラスターリスト ページで、作成したクラスターを見つけ、[Actions] 列の 詳細 をクリックします。基本情報 タブと 接続情報 タブをクリックして、クラスターの基本情報と接続情報を確認します。これには次の内容が含まれます:
-
API server [インターネットエンドポイント]:Kubernetes API server のパブリックエンドポイントです。kubectl を使用してクラスターを管理する際に使用します。
インターネット IP アドレスの関連付け と 関連付けの解除 機能は、ACK マネージドクラスターでのみ使用できます。
-
Associate EIP:既存の EIP を選択するか、新しい EIP を作成してクラスターに関連付けることができます。
EIP を関連付けると、API server が短時間再起動します。この間はクラスターに対する操作を避けてください。
-
Disassociate EIP:EIP の関連付けを解除すると、パブリックインターネットから API server にアクセスできなくなります。
EIP の関連付けを解除すると、API server が短時間再起動します。この間はクラスターに対する操作を避けてください。
-
-
API server [イントラネットエンドポイント]:Kubernetes API server の内部エンドポイントです。クラスター VPC 内からアクセスできます。この IP アドレスはロードバランサーのアドレスです。
-
-
クラスターのログ情報の表示
クラスターログ タブをクリックして、クラスターのログを確認できます。
OpenAPI
API
ACS クラスターは、Alibaba Cloud Container Service for Kubernetes (ACK) のクラスターの一種です。ACK CreateCluster API 操作を呼び出すことで、ACS クラスターを作成できます。
デバッグ
認可
次の表に、この API の認可情報を示します。RAM ポリシーの Action 要素にこれらの値を使用して、権限を付与します。
-
Action:特定の権限です。
-
Access level:各 Action のアクセスレベルです。有効な値:Write、Read、List。
-
Resource type:認可をサポートするリソースタイプです。詳細は次のとおりです:
-
必須のリソースタイプの前にはアスタリスク (*) が付きます。
-
リソースレベルの認可をサポートしない操作の場合は、
All Resourcesを使用します。
-
-
Condition keys:クラウドサービスで定義された条件キーです。
-
Dependent actions:Action を正常に実行するために必要なその他の権限です。呼び出し元は、これらの依存権限も持っている必要があります。
|
Actions |
Access level |
Resource type |
Condition keys |
Dependent actions |
|
cs:CreateCluster |
Write |
*cluster
|
|
None |
リクエスト構文
POST /clusters HTTP/1.1
主要パラメーター
CreateCluster API 操作を呼び出して ACS クラスターを作成する場合、次のパラメーターがACK マネージドクラスターのものとは異なります。
|
パラメーター |
説明 |
必須 |
パラメーターの組み合わせ |
|
region_id |
クラスターのリージョン。Supported regions。 |
Yes |
ACS クラスターの作成
|
|
cluster_type |
クラスタータイプ。ACS クラスターの場合は |
Yes |
|
|
profile |
クラスターのサブタイプ。ACS クラスターの場合は |
Yes |
|
|
cluster_spec |
クラスター仕様。ACS クラスターの場合は |
Yes |
|
|
service_cidr |
クラスターの Service CIDR ブロック。有効な CIDR ブロックは次のとおりです: VPC CIDR ブロック、または VPC 内の既存の Kubernetes クラスターの CIDR ブロックと重複できません。クラスター作成後は変更できません。Plan networks for ACS clusters。 |
Yes |
|
|
kubernetes_version |
Kubernetes バージョン。指定しない場合は最新バージョンがデフォルトになります。 ACS コンソールでは、最新 3 バージョンでのクラスター作成がサポートされています。Kubernetes version overview and mechanism。 |
No |
|
|
vpcid |
クラスターの VPC。指定しない場合、システムは推奨されるアベイラビリティーゾーンに VPC と 3 つの vSwitch を作成します。リージョンの VPC quota が十分であることを確認してください。 |
No |
|
|
vswitch_ids |
クラスターの vSwitch。Pod アドレスは vSwitch から割り当てられます。高可用性のために、異なるアベイラビリティーゾーンの vSwitch を選択してください。VPC を指定しない場合、システムはデフォルトで vSwitch を作成します。 |
No |
|
|
addons |
|
No |
サンプルリクエスト
ACS クラスターを作成するためのサンプルリクエストです。完全なパラメーター一覧については、「CreateCluster」をご参照ください。
POST /clusters HTTP/1.1
<Common request headers>
{
"name": "ACS-cluster", // 必須。クラスター名。
"cluster_type": "ManagedKubernetes", // 必須。クラスタータイプ。
"profile": "Acs", // 必須。クラスターのサブタイプ。
"cluster_spec": "ack.pro.small", // 必須。クラスター仕様。
"kubernetes_version": "1.31.1-aliyun.1", // クラスターバージョン。最新バージョンの使用を推奨します。
"region_id": "cn-hangzhou", // 必須。クラスターのリージョン。この例では China (Hangzhou) を使用します。
"vpcid": "vpc-j6cc1ddlp4rzs7v******", // VPC ID。クラスター作成後は変更できません。
"service_cidr": "192.168.xx.xx/16", // 必須。クラスターの Service CIDR ブロック。
"vswitch_ids": [ // 高可用性を確保するために複数の vSwitch を選択します。
"vsw-j6cht66iul7h61x******",
"vsw-j6c5ne6mxgnx3g5******"
],
"addons": [ // インストールするアドオン。
{
"name": "alb-ingress-controller"
}
}
サンプルレスポンス
成功レスポンス
{
"cluster_id": "c54c8e4c703834c48bda53ae7841*****",
"request_id": "08CCB494-7A82-5D51-907C-A6BF658*****",
"task_id": "T-68007b2164acba01060*****",
"instanceId": "c54c8e4c703834c48bda53ae7841*****"
}
エラーレスポンス
誤った cluster_type パラメーターにより返されたエラー:
{
"code": "400",
"message": "no ros component exists. clusterType: Kubernetes, version: ",
"requestId": "7D99D268-F1E1-5ED8-B757-E5D38A0*****",
"status": 400
}
エラーコード
Error Center にアクセスして、その他のエラーコードを確認してください。
関連ドキュメント
クラスター関連のその他の API については、「Cluster API reference」をご参照ください。