共有 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 に置き換えます。

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

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

このガイドでは、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 は、クラスタに使用する ノードタイプです。

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

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

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