共有 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 は、選択したノードタイプです。次の値が利用できます。

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

  • 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 はインスタンスが配置されているリージョンです。