gcloud CLI を使用して Memorystore for Redis インスタンスを作成する

Memorystore for Redis インスタンスを作成、接続、削除する方法を学習します。


このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示


始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Memorystore for Redis API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Memorystore for Redis API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  10. まだインストールしていない場合は、Google Cloud CLI をインストールします。

    プロンプトが表示されたら、上記で作成または選択したプロジェクトを選択します。

  11. Google Cloud CLI がすでにインストールされている場合は、更新します。

    gcloud components update
  12. 必要なロール

    Memorystore for Redis インスタンスの作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

    ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

    必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Memorystore for Redis インスタンスを作成する

このセクションでは、us-central1 リージョンに配置され、ベーシック ティアの 2 GB の Memorystore for Redis インスタンスを作成します。階層の詳細については、Redis の階層の機能をご覧ください。

  1. ターミナル ウィンドウを開きます。
  2. インスタンスを作成するプロジェクトをデフォルト プロジェクトとして設定するには、次のコマンドを入力します。

    gcloud config set core/project PROJECT_ID
    
  3. us-central1 リージョンに 2 GiB の基本階層 Redis インスタンスを作成するには、次のコマンドを入力します。

    gcloud redis instances create myinstance --size=2 --region=us-central1 \
    --redis-version=redis_6_x
    
  4. インスタンスを作成したら、次のコマンドを入力して、インスタンスの IP アドレスとポート番号を取得します。

    gcloud redis instances describe myinstance --region=us-central1
    

    インスタンスにアクセスできる場合、コマンドは次の結果を返します。

    authorizedNetwork: projects/my-project/global/networks/default
    createTime: '2018-04-09T21:47:56.824081Z'
    currentLocationId: us-central1-a
    host: 10.0.0.27
    locationId: us-central1-a
    memorySizeGb: 2
    name: projects/my-project/locations/us-central1/instances/myinstance
    networkThroughputGbps: 2
    port: 6379
    redisVersion: REDIS_6_X
    reservedIpRange: 10.0.0.24/29
    state: READY
    tier: BASIC

  5. インスタンスの host 値と port 値をメモします。インスタンスに接続するには、これらの値が必要です。

Compute Engine VM から Memorystore for Redis インスタンスに接続する

Memorystore for Redis インスタンスには、インスタンスの承認済みネットワークを使用する任意の Compute Engine VM からサポートされている RFC 1918 IP アドレス]をクリックします。

  1. インスタンスと同じ承認済みネットワークを使用する Compute Engine VM がない場合は、作成して SSH を使用して VM に接続します。これを行うには、Compute Engine で Linux VM インスタンスを作成するの手順に沿って操作します。

  2. apt-get を使用して telnet をインストールします。

    sudo apt-get install telnet
    
  3. ターミナルから、インスタンスの IP アドレスに telnet で接続します。VARIABLES は適切な値に置き換えます。

    telnet INSTANCE_IP_ADDRESS 6379
    

    インスタンスに接続できる場合、コマンドは次の結果を返します。

    Trying INSTANCE_IP_ADDRESS…
    Connected to INSTANCE_IP_ADDRESS
    
  4. telnet セッションで、次のようにいくつかの Redis コマンドを入力します。

    次のように入力します。

    PING
    

    結果:

    PONG
    

    入力

    SET HELLO WORLD
    

    結果:

    +OK
    

    次のように入力します。

    GET HELLO
    

    結果:

    $5
    WORLD
    

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、次の手順を実施します。

  1. インスタンスを削除するには、次のコマンドを入力します。

    gcloud redis instances delete myinstance --region=us-central1
  2. 削除を確定するには、「Y」と入力します。

    You are about to delete instance [myinstance] in [us-central1].
    Any associated data will be lost.
    Do you want to continue (Y/n)? Y
    Delete request issued for: [myinstance]

    インスタンスを削除できる場合、コマンドは次の結果を返します。

    Deleted instance [myinstance].

  3. (省略可)このクイックスタート用に Compute Engine VM を作成した場合は、それを削除します。

次のステップ