设置客户端库

本页介绍了如何为 Memorystore for Redis API 安装客户端库，以便您可以使用自己选择的语言连接到 API。

安装客户端库

C#

在 Visual Studio 中安装 Google.Cloud.Redis.V1 软件包

Go

go get cloud.google.com/go/redis/apiv1

Java

如果您使用的是 Maven，请将以下内容添加到您的 pom.xml 文件中：

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-redis</artifactId>
    <version>0.62.0-alpha</version>
</dependency>

如果您使用的是 Gradle，请将以下内容添加到您的依赖项中：

compile 'com.google.cloud:google-cloud-redis:0.62.0-alpha'

如果您使用的是 SBT，请将以下内容添加到您的依赖项中：

libraryDependencies += "com.google.cloud" % "google-cloud-redis" % "0.62.0-alpha"

如果您使用的是 VS Code、IntelliJ 或 Eclipse，则可使用以下 IDE 插件将客户端库添加到您的项目中：

上述插件还提供其他功能，例如服务帐号密钥管理。详情请参阅各个插件相应的文档。

Node.js

npm install --save @google-cloud/redis

PHP

composer require google/cloud-redis

Python

要详细了解如何设置 Python 开发环境，请参阅 Python 开发环境设置指南。 
pip install --upgrade google-cloud-redis

Ruby

gem install google-cloud-redis

设置身份验证

要运行客户端库，必须先创建服务帐号并设置环境变量来设置身份验证。

控制台

创建服务帐号：

  1. 在 Cloud Console 中，转到创建服务帐号页面。

    转到“创建服务帐号”
  2. 选择您的项目。

  3. 在服务帐号名称字段中，输入一个名称。Cloud Console 会根据此名称填充服务帐号 ID 字段。

    在服务帐号说明字段中，输入说明。例如，Service account for quickstart。

  4. 点击创建并继续。

  5. 如需提供对项目的访问权限，请向服务帐号授予以下角色：Project > Owner。

    在选择角色列表中，选择一个角色。

    如需添加其他角色，请点击 添加其他角色，然后添加其他各个角色。

  6. 点击继续。

  7. 点击完成以完成服务帐号的创建过程。

    不要关闭浏览器窗口。您将在下一步骤中用到它。

创建服务帐号密钥：

  1. 在 Cloud Console 中，点击您创建的服务帐号的电子邮件地址。
  2. 点击密钥。
  3. 点击添加密钥，然后点击创建新密钥。
  4. 点击创建。JSON 密钥文件将下载到您的计算机上。
  5. 点击关闭。

gcloud

设置身份验证：

  1. 创建服务帐号。将 NAME 替换为服务帐号的名称：

    gcloud iam service-accounts create NAME

  2. 向服务帐号授予角色。对以下每个 IAM 角色运行以下命令一次：roles/owner

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE

    替换以下内容：

    • NAME：服务帐号的名称
    • PROJECT_ID：您在其中创建服务帐号的项目的 ID
    • ROLE：要授予的角色

  3. 生成密钥文件：

    gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com

    替换以下内容：

    • FILE_NAME：密钥文件的名称
    • NAME：服务帐号的名称
    • PROJECT_ID：您在其中创建服务帐号的项目的 ID

通过设置环境变量 GOOGLE_APPLICATION_CREDENTIALS 向应用代码提供身份验证凭据。此变量仅适用于当前的 Shell 会话。如果您希望变量应用于未来的 Shell 会话，请在 shell 启动文件中设置变量，例如在 ~/.bashrc 或 ~/.profile 文件中。

Linux 或 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

将 KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

例如：

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

对于 PowerShell：

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

将 KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

例如：

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

对于命令提示符：

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

将 KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

其他资源