创建实例

本页面介绍了如何在 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 实例的网络尚未创建服务连接政策，请按照网络指南创建该政策。

创建多可用区实例

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

重要提示：在按照此过程中的步骤操作之前，请先完成准备工作和设置网络部分中的步骤。

如果您创建的实例包含副本，并且您希望创建该实例的区域中的某个可用区不可用，则 Memorystore for Valkey 会在该区域的可用区中创建该实例。此区域分配是临时性的。在不可用的可用区恢复可用后，Memorystore for Valkey 会重新分配实例的节点，以便它们均匀分布在各个可用区中。

如果您创建的实例没有副本，并且单个地区不可用，则 Memorystore for Valkey 无法创建该实例。

控制台

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

   Memorystore for Valkey

2. 点击创建实例。

3. 在为实例命名部分，输入实例的 ID。实例 ID 只能使用小写字母、数字和连字符。还必须以字母开头，并在其区域中是唯一的。

4. 从区域菜单中，为您的实例选择一个区域。

5. 在可用区级可用性部分中，选择多可用区选项，因为您要创建多可用区实例。

6. 在节点类型部分中，选择以下节点类型之一：

   • 共享核心 (shared-core-nano)
   • 小 (standard-small)
   • 中等 (highmem-medium)
   • 超大 (highmem-xlarge)

7. 在集群模式部分中，指定您要创建启用集群模式的实例还是停用集群模式的实例。如需详细了解这些类型的实例，请参阅启用和停用集群模式。

   注意： 创建启用集群模式或停用集群模式的实例后，您无法将该实例更改为另一种模式。我们建议您选择已启用，因为此模式具有更好的横向伸缩特性。

8. 在实例大小部分中，输入实例的分片数量。分片数量决定了用于存储实例数据的总内存容量。如需详细了解实例规范，请参阅实例和节点规范。

9. 如果您想创建具有副本的实例，请在副本部分中选择副本数量（每个分片）。您可以选择 0-5 个副本。默认值为 1 个副本。

10. 在设置连接部分中，选择您的应用可用于连接到此实例的网络。如需详细了解 Memorystore for Valkey 的专用网络，请参阅网络。

11. 可选。如果您想提高实例的安全性，请在安全性部分中，选中启用 IAM AUTH 复选框，以启用 IAM 身份验证。

    注意： 如果您选中此复选框，Memorystore for Valkey 会自动选中启用传输加密 (TLS) 复选框。因此，Memorystore for Valkey 会加密您的凭据，以便在凭据从实例传输到应用时保持机密性。

12. 在数据持久性策略部分，指定您希望 Memorystore for Valkey 如何持久保留实例中的数据。可接受的值包括无持久性、仅附加文件 (AOF) 持久性和内存快照持久性。

13. 可选。如果您想为实例启用自动备份，请执行以下操作：

    1. 选中自动每日备份复选框。
    2. 在保留备份的天数字段中，输入您希望 Memorystore for Valkey 在自动删除备份之前保留备份的天数。您可以指定 1 到 365 天。默认值为 35 天。
    3. 从时间窗口菜单中，选择每日备份的时间。

14. 在选择版本部分中，选择您的 Valkey 版本。可用版本为 7.2、8.0 和 9.0（预览版）。默认版本为 8.0 版。

    重要提示： 如果您选择 9.0 作为实例的版本，则无法将实例降级到更早的版本。

15. 点击创建实例。

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 是您要将实例放置在其中的区域。

注意： 您只能在 Memorystore for Valkey 的支持区域中创建实例。

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

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

• REPLICA_COUNT 是副本数（每个分片）。可接受的值为 0-5。

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  注意：我们建议您仅出于开发或测试目的使用 shared-core-nano 节点类型，因为此节点类型没有 SLA。如果您在生产环境中运行 Memorystore for Valkey，建议使用 standard-small、highmem-medium 或 highmem-xlarge 节点类型。如需详细了解这些节点类型，请参阅选择节点类型。

• ENGINE_VERSION 是 Memorystore for Valkey 实例的版本。此参数接受的值为 VALKEY_7_2、VALKEY_8_0 和 VALKEY_9_0（预览版）。如果您未指定值，则默认值为 VALKEY_8_0。

  重要提示： 如果您将实例的版本指定为 VALKEY_9_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。

创建单可用区实例

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

重要提示： 在执行这些步骤之前，请先完成准备工作和设置网络部分中的步骤。

控制台

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

   Memorystore for Valkey

2. 点击创建实例。

3. 在为实例命名部分，输入实例的 ID。实例 ID 只能使用小写字母、数字和连字符。还必须以字母开头，并在其区域中是唯一的。

4. 从区域菜单中，为您的实例选择一个区域。

5. 在可用区级可用性部分，执行以下操作：

   1. 选择单个可用区选项。

   2. 在可用区菜单中，选择您希望 Memorystore for Valkey 在其中创建实例的可用区。

6. 在节点类型部分中，选择以下节点类型之一：

   • 共享核心 (shared-core-nano)
   • 小 (standard-small)
   • 中等 (highmem-medium)
   • 超大 (highmem-xlarge)

7. 在集群模式部分中，指定您要创建启用集群模式的实例还是停用集群模式的实例。如需详细了解这些类型的实例，请参阅启用和停用集群模式。

   注意： 创建启用集群模式或停用集群模式的实例后，您无法将该实例更改为另一种模式。我们建议您选择已启用，因为此模式具有更好的横向伸缩特性。

8. 在实例大小部分中，输入实例的分片数量。分片数量决定了用于存储实例数据的总内存容量。如需详细了解实例规范，请参阅实例和节点规范。

9. 如果您想创建具有副本的实例，请在副本部分中选择副本数量（每个分片）。您可以选择 0-5 个副本。默认值为 1 个副本。

10. 在设置连接部分中，选择您的应用可用于连接到此实例的网络。如需详细了解 Memorystore for Valkey 的专用网络，请参阅网络。

11. 可选。如果您想提高实例的安全性，请在安全性部分中，选中启用 IAM AUTH 复选框，以启用 IAM 身份验证。

    注意： 如果您选中此复选框，Memorystore for Valkey 会自动选中启用传输加密 (TLS) 复选框。因此，Memorystore for Valkey 会加密您的凭据，以便在凭据从实例传输到应用时保持机密性。

12. 在数据持久性策略部分，指定您希望 Memorystore for Valkey 如何持久保留实例中的数据。可接受的值包括无持久性、仅附加文件 (AOF) 持久性和内存快照持久性。

13. 可选。如果您想为实例启用自动备份，请执行以下操作：

    1. 选中自动每日备份复选框。
    2. 在保留备份的天数字段中，输入您希望 Memorystore for Valkey 在自动删除备份之前保留备份的天数。您可以指定 1 到 365 天。默认值为 35 天。
    3. 从时间窗口菜单中，选择每日备份的时间。

14. 在选择版本部分中，选择您的 Valkey 版本。可用版本为 7.2、8.0 和 9.0（预览版）。默认版本为 8.0 版。

    重要提示： 如果您选择 9.0 作为实例的版本，则无法将实例降级到更早的版本。

15. 点击创建实例。

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 是副本数（每个分片）。可接受的值为 0-5。

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  注意：我们建议您仅出于开发或测试目的使用 shared-core-nano 节点类型，因为此节点类型没有 SLA。如果您在生产环境中运行 Memorystore for Valkey，建议使用 standard-small、highmem-medium 或 highmem-xlarge 节点类型。如需详细了解这些节点类型，请参阅选择节点类型。

• ENGINE_VERSION 是 Memorystore for Valkey 实例的版本。此参数接受的值为 VALKEY_7_2、VALKEY_8_0 和 VALKEY_9_0（预览版）。如果您未指定值，则默认值为 VALKEY_8_0。

  重要提示： 如果您将实例的版本指定为 VALKEY_9_0，则无法将实例降级到更早的版本。

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

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

  注意： 创建启用集群模式或停用集群模式的实例后，您无法将该实例更改为另一种模式。我们建议您创建启用集群模式的实例，因为此类实例具有更好的伸缩特性。

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

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