GCPでのクイックデプロイ
このトピックでは、Google Cloudでクイックデプロイを実行する方法について説明します。本番環境用のクラスターを作成する場合は、代わりに手動デプロイの設定と実行が必要です。
クイックデプロイは、Terraformテンプレートを起動して、必要な認証情報の作成と、必要なGCPリソースのプロビジョニングおよび設定を支援します。
クイックデプロイは本番環境での使用には適しておらず、非本番環境での使用のみを推奨します。
クイックデプロイは、手動デプロイで使用できるすべての設定オプションをサポートしているわけではありません。以下が必要な場合は、手動デプロイの方法を使用してください：
- 既存のデータ認証情報を再利用する
- デプロイ認証情報を再利用する
- 新しいデータまたはデプロイ認証情報を作成する
- ネットワークアクセスを手動で設定する
前提条件
クイックデプロイを開始する前に、以下を行う必要があります：
- Google Cloudプロジェクトを作成し、必要なAPIを有効にする、プロジェクトIDからプロジェクト情報セクションの
- クイックデプロイ用のCloud StorageバケットとサービスアカウントをCreate するをコピーして、後でアクセスできる場所に保存してください。
デプロイウィザードを開始する
デプロイウィザードを開始するには、以下の手順に従ってください：
- PhoenixAI Cloud BYOCコンソールにサインインします。
- クラスターページで、クラスターを作成をクリックします。
- 表示されたダイアログボックスで、クラシッククラスターまたはエラスティッククラスターを選択し、クラウドプロバイダーとしてGCPを選択してから、次へをクリックします。
クイックデプロイの設定と実行
デプロイウィザードを開始したら、デプロイウィザードのステップ1を完了し、必要な情報を入力するだけです。PhoenixAIが残りのステップを完了します。
クラスターリソースの設定
ステップ1: クラスターリソースの設定で、ビジネス要件に基づいてクラスターを設定し、必要に応じてラベルを追加をクリックしてクラスターに1つ以上のラベルを追加します。次に、クイックデプロイをクリックして続行します。ここで追加したラベルは、クラスターに関連付けられたGCPクラウドリソースに付与されます。
- PhoenixAIは無料開発者ティアを提供しています。これを使用するには、4 CPUコアと16 GB RAMを提供するインスタンスタイプを選択する必要があります。
- 4 CPUコアと16 GB RAMは、PhoenixAIノードの最小構成パッケージでもあります。
以下の設定項目を構成してください。
| パラメーター | 必須 | 説明 |
|---|---|---|
| クラスター名 | はい | クラスターの名前を入力します。名前はクラスター作成後に変更できません。後で簡単にクラスターを識別できるよう、わかりやすい名前を入力することをお勧めします。 |
| GCPリージョン | はい | クラスターをホストするGCPリージョンを選択します。PhoenixAIがサポートするリージョンについては、サポートされているクラウドプラットフォームとリージョンを参照してください。 |
| PhoenixAIエンタープライズバージョン | はい | PhoenixAIエンタープライズソフトウェア（データベースカーネル）のバージョンを選択します。最新の安定版または最新のプレビュー版を選択できます。詳細については、 ベータおよび実験的機能を参照してください。 |
| コーディネーターHAモード | いいえ | コーディネーターHAモードを有効または無効にします。コーディネーターHAモードはデフォルトで無効になっています。
|
| コーディネーターノードサイズ | はい | クラスター内のコーディネーターノードのインスタンスタイプを選択します。PhoenixAIがサポートするインスタンスタイプについては、サポートされているインスタンスタイプを参照してください。 |
| コンピュートノードサイズ | はい | クラスター内のデフォルトウェアハウスのコンピュートノードのインスタンスタイプを選択します。PhoenixAIがサポートするインスタンスタイプについては、サポートされているインスタンスタイプを参照してください。 |
| コンピュートノード数 | はい | クラスター内のデフォルトウェアハウスのコンピュートノード数を指定します。処理するデータ量に基づいてコンピュートノード数を決定できます。デフォルト値は1です。 |
| コンピュートストレージサイズ | はい | デフォルトウェアハウスのコンピュートノードのストレージサイズを指定します。 |
| コンピュートディスクIOPS | いいえ | デフォルトウェアハウスのコンピュートノードのディスクIOPSを指定します。このフィールドはHyperdisk Balancedインスタンスタイプのみで使用可能です。範囲: [3000, 16000] |
| コンピュートディスクスループット | いいえ | デフォルトウェアハウスのコンピュートノードのディスクスループットを指定します。このフィールドはHyperdisk Balancedインスタンスタイプのみで使用可能です。範囲: [125, 1000] |
詳細設定では、以下のことができます：
-
削除保護を有効にする。
削除保護を有効にすることで、クラスターが誤って削除されるのを防ぎ、データ損失のリスクを排除できます。クラスターに削除保護が有効になると、クラスターを削除しようとする試みはすべて失敗し、エラーが返されます。クラスターを削除するには、まず手動で削除保護を無効にする必要があります。
クラスターの作成後、クラスター詳細ページのクラスター構成タブのクラスターパラメーターセクションでこの機能を有効または無効にできます。
-
コーディネーターノードのストレージ自動スケーリングポリシーを定義する。
ストレージの自動スケーリングはデフォルトで有効になっています。PhoenixAIは、プリセットのストレージ容量が不足していることを検出すると、ポリシーに基づいてストレージサイズを自動的にスケールアップします。
注記
クラスターのワークロードが予測不可能な場合、ストレージの自動スケーリングを有効のままにしておくことを強くお勧めします。予測不可能なワークロードはストレージをすぐに使い果たし、クラスターの重大な障害を引き起こす可能性があります。 :::
ストレージ自動スケーリングポリシーを定義するには、以下の手順に従ってください：
-
自動スケーリング操作をトリガーするストレージ使用率のしきい値（パーセンテージ）を設定します。このしきい値は80%から90%の間で設定できます。ノードのストレージ使用率がこのしきい値に達し、5分以上継続した場合、PhoenixAIは次の手順で定義したステップサイズでストレージをスケールアップします。
-
各自動スケーリング操作のステップサイズを設定します。ステップサイズは固定サイズ（GB）またはパーセンテージで設定できます。例えば、50 GBまたは15%（元のストレージサイズに対して）などです。
-
各ノードの最大ストレージサイズを設定します。ストレージサイズがこのしきい値に達すると、PhoenixAIはスケールアップを停止します。
- 2回のスケーリング操作（手動スケーリングおよび自動スケーリングを含む）の間隔として、最低4時間が必須です。
- 各ストレージの最大サイズは64 TBです。
- エラスティッククラスターのコンピュートノードはストレージの自動スケーリングをサポートしていません。
Google Cloudでリソースを起動する
クイックデプロイダイアログボックスで、以下の手順に従ってください：
-
先ほどコピーしたGoogle CloudのプロジェクトIDをGCPプロジェクトIDフィールドに貼り付けます。
-
ダウンロードをクリックしてスクリプトパッケージファイルを直接ダウンロードするか、URLを生成をクリックして後でファイルをダウンロードするための署名付きURLを生成します。パッケージ内のスクリプトは、Google Cloud Infrastructure Managerがクラスターに必要なリソースを起動・管理するためのテンプレートです。
-
Google Cloudコンソールでプロジェクトにサインインし、クイックデプロイ用に作成したCloud Storageバケットにパッケージファイルをアップロードしてください。パッケージを解凍する必要はありません。Cloud Storageバケットへのファイルアップロードの詳細な手順については、Google Cloud公式ドキュメント - バケットへのオブジェクトのアップロードを参照してください。
-
パッケージファイルのアップロードが完了したら、アップロードしたパッケージファイルのgsutil URIをコピーし、後でアクセスできる場所に保存してください。
注記gsutil URIは
gs://<BUCKET_NAME>/<FOLDER_NAME>/<FILE_NAME>の形式です。アップロードしたパッケージのgsutil URIが不明な場合は、以下の手順でGoogle CloudコンソールからURIを取得してください。
- プロジェクトにGoogle Cloudコンソールでサインインします。
- 左側のナビゲーションメニューを展開し、Cloud Storage > バケットを選択します。
- パッケージファイルをアップロードしたバケットをクリックします。
- バケットの詳細ページで、パッケージファイルのレコードを見つけます。
- レコードの右側にあるその他の操作（⋮）ボタンをクリックし、gsutil URIをコピーを選択してURIをコピーします。
-
クラスターの作成をクリックします。
その後、Google CloudコンソールのInfrastructure Managerページにリダイレクトされます。
リダイレクト後、PhoenixAI Cloud BYOCコンソールを閉じないでください。デプロイを完了するために、後でコンソールに戻る必要があります。
Infrastructure Managerページで、以下の手順を実行します。
-
新しいデプロイメントの作成をクリックして、新しいTerraformデプロイメントの作成ページに移動します。
-
デプロイメントの詳細ステップで、以下のように設定します。
a. デプロイメントIDフィールドにデプロイメントのIDを指定します。IDはGoogle Cloudプロジェクト内で一意である必要があります。
b. リージョンドロップダウンリストからデプロイメントのリージョンを選択します。クラスターをデプロイするリージョンに設定することをお勧めします。
c. クイックデプロイメント用に作成したサービスアカウントからサービスアカウントドロップダウンリストから。
d. 選択する GCS として Terraform構成のソース。
e. 先ほどコピーしたパッケージファイルのgsutil URIを ソース フィールドに貼り付けます。
-
クリック デプロイメントの作成。
作成したデプロイメントの詳細ページにリダイレクトされます。デプロイメントの作成には数分かかります。デプロイメントが正常に作成されると、デプロイメントの 状態 が 作成中 に変わります。その後、次のステップに進むことができます。アクティブ次のステップに進むことができます。
クラスターをデプロイする
デプロイメントを完了するには、次の手順に従ってください：
-
PhoenixAI Cloud BYOCコンソールに戻ります。
-
表示されたメッセージで、 完了 をクリックします。その後、コンソールの クラスター ページにリダイレクトされます。
-
作成したクラスターをクリックします。
上記の手順を完了すると、PhoenixAIが自動的にクラスターをデプロイします。これには数分かかります。
デプロイメントが完了すると、次の図に示すメッセージが表示されます。
メッセージ内の クラスタープレビュー をクリックしてクラスターを表示できます。また、 クラスター ページに戻ってクラスターを表示することもできます。クラスターは、デプロイメントが成功すると 実行中 状態になります。
クラスター認証情報とデプロイメントの詳細を取得する
以下の手順に従って、今後必要となるクラスター認証情報とデプロイメントの詳細を収集してください：
-
クラスター用に作成したデプロイメントの詳細ページに戻ります。出力 タブをクリックします。
-
出力 タブでは、以下の情報を確認できます：
celerdata_cluster_preview_address：PhoenixAI Cloud BYOCコンソールのクラスター詳細ページへのリンク。celerdata_cluster_storage_bucket：クラスタークエリプロファイルの保存に使用されるバケットのURI。celerdata_cluster_vm_service_account：ストレージバケットへのアクセス権限をクラスターに付与するために作成されたインスタンスサービスアカウントの名前。celerdata_cluster_network_tag：クラスターノード間、およびPhoenixAIのVPCとクラスターのVPC間のTLSによる接続を有効にするために使用されるファイアウォールルールのターゲットタグ。celerdata_cluster_network：クラスターがデプロイされているVPCネットワークのURI。celerdata_cluster_subnetwork：クラスターがデプロイされているサブネットのURI。celerdata_cluster_initial_admin_password：クラスター内のadmin アカウントの初期パスワード。
デフォルトストレージボリュームの設定 - Elasticクラスターのみ
Classicクラスターをデプロイした場合は、このステップをスキップしてください。
デフォルトでは、すべてのデータベースとテーブルはデフォルトストレージボリュームに作成されます。
GCP上のPhoenixAI BYOCの実験的リリース期間中は、クラスターの作成後、データベースやテーブルを作成する前に、デフォルトストレージボリュームを手動で作成する必要があります。
相互運用性のためのXML APIは、GCSストレージをS3であるかのように操作するために使用されます。一般的に、S3設定とGCS設定の違いは以下の点のみです：
- エンドポイント
https://storage.googleapis.comを使用する - 認証にHMACキーとシークレットを使用する
相互運用性XML APIまたはHMACキーに不慣れな場合は、このページの下部にリンクがあります。
GCSにストレージボリュームを作成する
以下が必要です：
- クラスターが配置されているGCSリージョン（STEP1で指定したもの）
- STEP2で指定したGCSバケット名
- バケット用のHMACアクセスキーとHMACシークレットキー
adminユーザーとしてSQLクライアントでクラスターに接続し、STORAGE VOLUME を作成します（バケットと認証の詳細を置き換えてください）：
CREATE STORAGE VOLUME def_volume
TYPE = S3
LOCATIONS = ("s3://<GCS bucket name collected from the Outputs tab of the deployment details page in Google Cloud Console>")
PROPERTIES
(
"enabled" = "true",
"aws.s3.region" = "us-central1",
"aws.s3.endpoint" = "https://storage.googleapis.com",
"aws.s3.access_key" = "<HMAC access key>",
"aws.s3.secret_key" = "<HMAC secret key>"
);
新しいボリュームをデフォルトとして設定する：
SET def_volume AS DEFAULT STORAGE VOLUME;
次のステップ
いつでも、JDBCドライバー、MySQLクライアント、またはPhoenixAI Studioを使用してクラスターに接続できます。詳細については、PhoenixAIクラスターへの接続を参照してください。
また、PhoenixAI Cloud BYOCコンソールでクラスターを表示・管理することもできます：
- PhoenixAIクラスターの表示。
- PhoenixAIクラスターをスケールする。
- PhoenixAIクラスターをリリースする.
- PhoenixAIクラスターを一時停止および再開する.
- PhoenixAIクラスターを開く.