共有 VPC ネットワークでのインスタンスのプロビジョニング

このページでは、前提条件の設定、サービス プロジェクトでのインスタンスのプロビジョニング、インスタンスの説明、インスタンスの削除に必要な gcloud CLI コマンドについて説明します。 これらのタスクを行うには、このページの各セクションの手順に沿って操作する必要があります。

これらのタスクの詳細なガイダンスについては、次のページをご覧ください。

API を有効にする

サービス接続 ポリシーの構成、共有 VPC の構成、 Memorystore for Valkey インスタンスの作成に必要な次の API を有効にします。

gcloud

  1. サービス プロジェクトで次の API を有効にします。

    gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com

    SERVICE_PROJECT_ID を実際のサービス　プロジェクト ID に置き換えます。

  2. ホスト プロジェクトで次の API を有効にします。

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    HOST_PROJECT_ID をホスト プロジェクトの ID に置き換えます。

サービス接続ポリシーを作成する

次に、ポリシーが定義されている共有 VPC のホスト プロジェクト、ネットワーク、リージョン、Memorystore for Valkey インスタンスをプロビジョニングするサブネットにサービス接続ポリシー を作成する必要があります。通常、これはネットワーク管理者が行いますが、 必要なロールが付与されている場合は、 コマンドを実行する権限が付与されている可能性があります。

このガイドでは、default ネットワークと default サブネットを使用します。インスタンスの IP アドレスは、リージョン内のこのデフォルト サブネットで割り振られます。

gcloud

  1. サービス接続ポリシーを作成するには、create コマンドを実行します。

    gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=HOST_PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default

    以下を置き換えます。

    • POLICY_NAME は、必要なポリシー名です。
    • HOST_PROJECT_ID は、ホスト プロジェクト ID です。
    • REGION は、 Memorystore for Valkey インスタンスをプロビジョニングするリージョンと同じリージョンです。

  2. ポリシーが正常に作成されたかどうかを確認するには、list コマンドを実行します。

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    以下を置き換えます。

    • HOST_PROJECT_ID は、ホスト プロジェクト ID です。
    • REGION は、サービス接続ポリシーが 定義されているリージョンです。

インスタンスの作成

共有 VPC に接続されたサービス プロジェクトにインスタンスを作成するには、次のコマンドを実行します。

gcloud

gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/HOST_PROJECT_ID/global/networks/default", "projectId": "SERVICE_PROJECT_ID"}}]}]'

以下を置き換えます。

  • INSTANCE は、インスタンス ID です。
  • SERVICE_PROJECT_ID は、サービス プロジェクトの ID です。

  • REGION は、インスタンスをプロビジョニングするリージョンです。

  • NODE_TYPE は、インスタンスに使用する ノードタイプ です。

  • SHARD_COUNT によってインスタンス内のシャードの数が決定されます。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンス仕様の詳細については、インスタンスとノードの仕様をご覧ください。

  • REPLICA_COUNT は、リードレプリカの数（シャードあたり）です。 利用できる値は 0～5 です。

  • HOST_PROJECT_ID は、ホスト プロジェクト ID です。

インスタンスの説明を取得する

インスタンスの詳細を表示するには、次のコマンドを実行します。

gcloud

gcloud memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

以下を置き換えます。

  • INSTANCE は、インスタンス ID です。
  • SERVICE_PROJECT_ID は、サービス プロジェクトの ID です。
  • REGION はインスタンスが配置されているリージョンです。

インスタンスの削除

インスタンスを削除するには、次のコマンドを実行します。

gcloud

gcloud memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

以下を置き換えます。

  • INSTANCE は、インスタンス ID です。
  • SERVICE_PROJECT_ID は、サービス プロジェクトの ID です。
  • REGION はインスタンスが配置されているリージョンです。