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

このページでは、前提条件の設定、サービス プロジェクトでのインスタンスのプロビジョニング、インスタンスの説明、インスタンスの削除に必要な gcloud CLI コマンドを一覧表示します。これらのタスクを行う場合は、このページの各セクションの手順に沿って実施してください。

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

API を有効にする

サービス接続ポリシーの構成、共有 VPC の構成、Memorystore for Redis Cluster インスタンスの作成に必要な次の 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 redis.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 Redis Cluster インスタンスをプロビジョニングするサブネットのサービス接続ポリシーを作成します。通常、これはネットワーク管理者が行います。ただし、コマンドを実行するために必要なロールが割り当てられている場合は、これを行うこともできます。

このクイックスタートでは、default ネットワークと default サブネットを使用します。

gcloud

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

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

    以下を置き換えます。

    • POLICY_NAME は、目的のポリシー名です。
    • HOST_PROJECT_ID は、ホスト プロジェクト ID です。
    • REGION は、Memorystore for Redis Cluster インスタンスをプロビジョニングするリージョンと同じです。
  2. ポリシーが正常に作成されたかどうかを検証するには、list コマンドを実行します。

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

    以下を置き換えます。

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

インスタンスの作成

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

gcloud

gcloud redis clusters create INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--network=projects/HOST_PROJECT_ID/global/networks/default

以下を置き換えます。

  • INSTANCE_ID はインスタンス ID です。
  • SERVICE_PROJECT_ID は、サービス プロジェクト ID です。
  • REGION は、インスタンスをプロビジョニングするリージョンです。

  • NODE_TYPE は、選択したノードタイプです。次の値が利用できます。

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

  • REPLICA_COUNT は、必要なリードレプリカ数(シャードあたり)です。指定できる値は 012 です。

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

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

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

gcloud

gcloud redis clusters describe INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

以下を置き換えます。

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

インスタンスの削除

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

gcloud

gcloud redis clusters delete INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

以下を置き換えます。

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