新しいメジャー・バージョンへのアップグレード

データベースのメジャー・バージョンが寿命（EOL）になったら、現在のメジャー・バージョンにアップグレードする。 IBM Cloud® Databases for Elasticsearch デプロイメントをアップグレードすることで、最新バージョンの Elasticsearch を使用できるようになります。

Databases for Elasticsearchで利用可能なElasticsearchの最新バージョンにアップグレードしてください。カタログ、 Cloud Databases CLI プラグイン、または Cloud Databases APIを使用して、最新バージョンを見つけます。

アップグレードは、新しいデプロイメントへのデータの「バックアップの復元処理されます。バックアップからのリストアには、以下のようないくつかの利点があります。

元のデータベースが実行されたままなので、実動作業を中断せずに実行できる。
実動とは別に新規データベースをテストして、アプリケーションの非互換性がないかを確認できる。
任意の時点でプロセス全体をやり直すことができる。
フレッシュ・リストアなので、前のバージョンのデータベースの不要な成果物が新規データベースに引き継がれる可能性が低くなる。

アップグレードの前に

クラスタをバージョン8.xにアップグレードする前に、以下の操作を行ってください：

Databases for Elasticsearchで自動的に有効化され、IBM® Cloud Logs に送信される非推奨ログをチェックして、非推奨の機能を使用しているかどうかを確認し、コードを更新してください。
変更点を確認し、バージョン8.xのコードと設定に必要な変更を加えてください。
プラグインを使用する場合は、各プラグインのバージョンがElasticsearchのバージョン8.xと互換性があることを確認してください。

索引マッピング

Elasticsearch 7.x 以上では、マッピング・タイプは削除されます。 Elasticsearch 7.x 以降で作成される索引では、default マッピングを使用できなくなります。 7.x では、API でのタイプの使用も非推奨です。詳しくは、 Elasticsearch のマッピング・タイプの削除を参照してください。

再索引付けの指針

Databases for Elasticsearchインデックスは、作成されたリリースと同じバージョンまたはplusOneバージョンのみ互換性があります。明示的な再索引付け操作に限り、索引が現行のデータベース・バージョンに更新されます。

Kibana への接続

Kibana をデプロイして Databases for Elasticsearch インスタンスに接続する場合、デプロイする Kibana のバージョンが Elasticsearch インスタンスのバージョンと一致している必要があることに注意してください。アップグレードしたインスタンスとの接続を維持するために、新しいバージョンの Kibana をプロビジョンします。

UI でのアップグレード

配置の概要ページのバックアップとリストアタブからバックアップをリストアするときに、新しいバージョンにアップグレードします。選択したバックアップのオーバーフローメニューまたは展開されたテーブル行で、バックアップの復元をクリックします。復元プロビジョニング]ページが開き、新しい配置のオプションを選択できます。オプションの 1 つに「データベース・バージョン」があります。これには、使用可能なバージョンが自動的に取り込まれます。バージョンを選択し、バックアップの復元をクリックして、プロビジョニングと復元プロセスを開始します。

CLI を使用したアップグレード

IBM Cloudを使用してバックアップからアップグレードおよびリストアする場合は、リソースコントローラから次のプロビジョニングコマンドを使用します。CLIを使用する場合は、リソースコントローラから次のプロビジョニングコマンドを使用します。

ibmcloud resource service-instance-create <service-name> <service-id> <service-plan-id> <region>

パラメーターの service-name、service-id、service-plan-id、region はすべて必須です。また、-p に、バージョンとバックアップ ID のパラメーターを JSON オブジェクトで指定してください。新規デプロイメントは、バックアップ時のソース・デプロイメントと同じディスクおよびメモリーを適用して自動的にサイズ変更されます。

配置のバックアップとバックアップ ID のリストは、次のコマンドを使用して取得できます。

ibmcloud cdb deployment-backups-list <deployment name or CRN> --json

以下のように、選択したバックアップのIDをリソースコントローラーコマンドのパラメータとして使用します。

ibmcloud resource service-instance-create example-es-upgrade databases-for-elasticsearch standard us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":8.12
}'

API を使用したアップグレード

API を使用したプロビジョニングの場合と同様に、バックアップからのアップグレードにリソース・コントローラー API を使用するためには、リソース・コントローラー API を使用するために必要なステップを完了しておく必要があります。その後、API に POST 要求を送信します。パラメーターの name、target、resource_group、resource_plan_id はすべて必須です。バージョンとバックアップ ID も指定します。新規デプロイメントのメモリーとディスクの割り振りは、バックアップ時のソース・デプロイメントと同じになります。

配置のバックアップとバックアップ ID のリストは、次の API リクエストを使用して取得できます。

curl -X GET  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/backups  
-H 'Authorization: Bearer <>' \

以下の例のように、リソースコントローラAPIリクエストで選択したバックアップのIDを使用します。

curl -X POST \
  https://resource-controller.cloud.ibm/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-elasticsearch-standard",
    "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":8.12
  }'