共有 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 beta memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=HOST_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、1、2 です。

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

インスタンスの説明

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

gcloud

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

次のように置き換えます。

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

インスタンスの削除

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

gcloud

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

次のように置き換えます。

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