创建实例

本页介绍如何创建 Memorystore for Valkey 实例。

准备工作

完成“准备工作”中的说明:

  1. 在 Google Cloud 控制台的项目选择器页面上,选择或创建 Google Cloud 项目

    注意:如果您不打算保留在此过程中创建的资源,请创建新的项目,而不要选择现有项目。完成本教程介绍的步骤后,您可以删除所创建的项目,并移除与该项目关联的所有资源。


    前往“项目选择器”
  2. 确保您的项目已启用结算功能。 了解如何检查项目是否已启用结算功能
  3. 安装初始化 Google Cloud CLI。

    注意:如果您之前安装了 gcloud CLI,请运行 gcloud components update 以确保您拥有最新版本。您需要至少使用 gcloud CLI 版本 489.0.0 才能访问 Memorystore for Valkey gcloud CLI 命令。

  4. 启用 Memorystore for Valkey API
    Memorystore for Valkey
  5. 启用 Network Connectivity API
    Network Connectivity API
  6. 启用 Service Consumer Management API
    Service Consumer Management API

其他前提条件

  • 您必须在所使用的 Google Cloud 项目中拥有以下 IAM 角色之一:
    • roles/memorystore.admin(Memorystore Admin 预定义 IAM 角色)
    • roles/owner(Owner 基本 IAM 角色)
    • roles/editor(Editor 基本 IAM 角色)

设置网络

请参阅网络页面,确定是否需要设置服务连接政策。

如果您要创建 Valkey 实例的网络尚未创建服务连接政策,请按照网络指南创建该政策。

创建实例

控制台

  1. 前往 Google Cloud 控制台中的 Memorystore for Valkey 页面。

    Memorystore for Valkey

  2. 点击创建实例

  3. 创建 Valkey 实例页面上,为新实例选择所需配置。

    • 为实例命名下,输入实例 ID。实例 ID 只能使用小写字母、数字和连字符。还必须以字母开头,并在其区域中是唯一的。
      • 例如:my-instance-1
    • 选择区域下,为您的实例选择一个区域。
    • 节点类型下,选择您的节点类型
    • 模式下,选择已启用集群模式或已停用集群模式
    • 实例大小下,为您的实例定义分片数量。分片数决定了用于存储实例数据的总内存容量。已停用集群模式的实例仅支持一个分片。如需了解详情,请参阅实例和分片规范
    • 如果您想创建具有副本的实例,请在副本下输入所需的副本数(每个分片)。可接受的值为“无副本”“1 个副本”和“2 个副本”。使用 Google Cloud 控制台时,默认值为 1 个副本。
    • 设置连接下,选择所需的网络。如需详细了解 Memorystore for Valkey 的专用网络,请参阅网络
    • 如果要启用 IAM 身份验证,请选择启用 IAM AUTH
    • 如果要启用传输加密,请选择启用传输层安全协议 (TLS)
    • 选择版本下,选择您的 Valkey 版本。Valkey 版本 7.2 是默认版本。
  4. 点击创建实例按钮。

gcloud

如需创建 Memorystore for Valkey 实例,请运行 create 命令:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--mode=MODE

替换以下内容:

  • INSTANCE 是您要创建的 Memorystore for Valkey 实例的 ID。实例 ID 的长度必须介于 1 到 63 个字符之间,且只能使用小写字母、数字或连字符。并且必须以小写字母开头并以小写字母或数字结尾。

  • REGION_ID 是您要将实例放置在其中的区域。

  • PROJECT_ID 是您要在其中创建实例的项目的 ID。

  • NETWORK_ID 是您要用于创建实例的网络的 ID。

  • REPLICA_COUNT 是您所需的副本数量(每个分片)。 接受的值包括 012

  • NODE_TYPE 是您选择的节点类型。接受的值包括:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    如需详细了解节点类型和实例配置,请参阅实例和节点规范

  • ENGINE_VERSION 是您选择的 Valkey 引擎版本。可接受的值为 VALKEY_7_2VALKEY_8_0

  • SHARD_COUNT 用于确定实例中的分片数量。分片数决定了用于存储实例数据的总内存容量。已停用集群模式的实例仅支持一个分片。如需了解详情,请参阅实例和节点规范

  • MODE 用于确定实例是启用集群模式还是停用集群模式。如果省略此字段,则实例默认处于“集群模式已启用”状态。如需了解详情,请参阅启用和停用集群模式

例如:

已启用集群模式示例


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--mode=cluster

集群模式已停用示例


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--mode=cluster-disabled

默认情况下,传输加密处于停用状态,授权网络为 default

创建单区域实例

本部分介绍了如何创建单可用区实例

gcloud

如需创建单可用区实例,请运行 create 命令:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--mode=MODE

替换以下内容:

  • INSTANCE 是您要创建的 Memorystore for Valkey 实例的 ID。实例 ID 的长度必须为 1 到 63 个字符,且只能使用小写字母、数字或连字符。并且必须以小写字母开头并以小写字母或数字结尾。

  • REGION_ID 是您要将实例放置在其中的区域。

  • PROJECT_ID 是您要在其中创建实例的项目的 ID。

  • NETWORK_ID 是您要用于创建实例的网络的 ID。

  • REPLICA_COUNT 是您选择的副本数量(每个分片)。接受的值包括 012

  • NODE_TYPE 是您选择的节点类型。接受的值包括:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    如需详细了解节点类型和实例配置,请参阅实例和节点规范

  • ENGINE_VERSION 是您选择的 Valkey 引擎版本。可接受的值为 VALKEY_7_2VALKEY_8_0

  • SHARD_COUNT 用于确定实例中的分片数量。分片数决定了用于存储实例数据的总内存容量。如果您选择的模式为“已停用集群模式”,则只能为实例指定一个分片。如需了解详情,请参阅实例和节点规范

  • MODE 确定实例应启用集群模式还是停用集群模式。如果您省略此字段,则模式默认设为“集群模式已启用”。如需了解详情,请参阅启用和停用集群模式

  • ZONE_DISTRIBUTION_CONFIG_MODE 是一种模式,可让您选择是预配单可用区实例还是多可用区实例。默认值为多区域。可接受的值为 single-zonemulti-zone

  • ZONE 是您要预配节点的可用区。此标志仅在 --zone-distribution-config-mode= 设置为 single-zone 时适用。