Global Cluster の管理

Plan availability

この機能は、Business Critical (SaaS) および BYOC デプロイメントでのみ利用できます。

Region availability

この機能は、すべての AWS リージョンと、次の Google Cloud リージョンで利用できます: gcp-us-central1 および gcp-us-east4。Microsoft Azure では利用できません。

このページでは、secondary cluster の追加と削除、global cluster の通常 cluster への変換、および global cluster 全体の削除について説明します。

開始する前に

Project Admin であることを確認してください。
primary cluster と secondary cluster はどちらも一時停止できないことに注意してください。

secondary cluster の追加

リージョンのカバレッジを向上させるために、既存の global cluster に異なるリージョンの追加の secondary clusters を追加できます。

📘注意

global cluster には最大 5 つまで secondary clusters を設定できます。

新しい secondary cluster を追加すると、Zilliz Cloud がそれをプロビジョニングし、primary からのデータレプリケーションを開始します。新しい secondary cluster は CREATING ステータスで表示され、初回のデータ同期が完了すると RUNNING に遷移します。

Web コンソールから

次のデモは、1 つ以上の secondary clusters を追加する方法を示しています。

RESTful API から

次の例では、AWS ap-southeast-1 にデプロイされた secondary-cluster-ap という名前の新しい secondary cluster を追加します。API の詳細については、Add Secondary Clusters を参照してください。

bash
curl --request POST \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/secondaryClusters" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "secondaryClusters": [
      {
        "clusterName": "secondary-cluster-ap",
        "regionId": "aws-ap-southeast-1"
      }
    ]
  }'

以下は出力例です。

bash
{
  "code": 0,
  "data": {
    "jobId": "job-xxxxxxxxxxxxxxxx"
  }
}

secondary cluster の削除

そのリージョンでのカバレッジが不要になった場合や、コストを削減したい場合は、secondary cluster を削除できます。

secondary cluster を削除すると、次のようになります。

削除された secondary cluster は global cluster のトポロジーから取り除かれます。
その cluster へのデータレプリケーションは直ちに停止します。

secondary cluster は、Web コンソールまたは RESTful API のいずれかで削除できます。

Web コンソールから

次のスクリーンショットは、secondary cluster を削除する方法を示しています。

RESTful API から

次の例では secondary cluster を削除します。API の詳細については、Delete Global Member Cluster を参照してください。

bash
curl --request DELETE \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/clusters/in01-xxxxxxxxxxxxxxx" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json"

以下は出力例です。

bash
{
  "code": 0,
  "data": {
    "globalClusterId": "glo-xxxxxxxxxxxxxxxx",
    "clusterId": "in01-xxxxxxxxxxxxxxx",
    "prompt": "The cluster has been deleted. If you consider this action to be an error, you have the option to restore the deleted cluster from the recycle bin within a 30-day period. Kindly note, this recovery feature does not apply to free clusters."
  }
}

global cluster を通常 cluster に変換する

マルチリージョン機能が不要になったものの、primary cluster とそのデータを保持したい場合は、global cluster を通常の Dedicated cluster に戻すことができます。

global cluster を通常 cluster に変換するには、次の操作が必要です。

すべての secondary clusters を削除します。

Global Cluster ページで、Actions ドロップダウンから Remove Global Endpoint をクリックします。

Qg0Mw7gCGh9vlfbMpxockJPVnUg

RESTful API を使用して global endpoint を削除することもできます。以下はその例です。詳細については、Remove Global Endpoint を参照してください。

bash
curl --request POST \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/removeGlobalEndpoint" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json"

global endpoint が削除されると、global endpoint 経由で接続しているアプリケーションは直ちに切断されます。アプリケーションコード内の接続 endpoint を必ず更新してください。次の表は、変換後に何が起こるかを示しています。

項目	動作
Global endpoint	直ちに削除されます。これを使用しているクライアントは切断されます。
Primary cluster	通常の Dedicated cluster になります。すべてのデータを保持したまま稼働を継続します。
Data replication	停止します。データレプリケーションのメトリクスは削除されます。
Global cluster metadata	クリアされます（global cluster ID、トポロジー）。
Backup policy	変更されず、以前の primary cluster に残ります。
Billing	Data transfer の料金は停止します。残りの cluster は通常の Dedicated cluster として課金されます。

global cluster の削除

global cluster 全体を削除するには、まずすべての secondary clusters を削除し、その後 primary cluster を削除します。primary cluster が削除されると、global cluster は自動的に削除されます。

開始する前に​

secondary cluster の追加​

secondary cluster の削除​

global cluster を通常 cluster に変換する​