View a markdown version of this page

使用公共端点创建 Valkey 无服务器缓存 - 亚马逊 ElastiCache
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用公共端点创建 Valkey 无服务器缓存

使用公共终端节点,您无需使用 VPC 即可直接通过互联网连接到 ElastiCache 无服务器缓存。Valkey 9.0 或更高版本的 ElastiCache Serverless 上提供公共端点。

先决条件

  • 具有创建 ElastiCache 资源权限的 Amazon 账户。

  • 要么是AdministratorAccess,要么是 IAM 权限,其中包括elasticache:CreateServerlessCache。如果您计划创建自定义用户组而不是使用默认用户组,则还需要elasticache:CreateUser和elasticache:CreateUserGroup。

  • 您的 IAM 身份必须有权使用公有终端节点创建缓存。可以使用elasticache:ConnectionType条件键限制此权限。有关更多信息,请参阅 策略示例:使用条件 Fine-Grained 参数控制。

  • 已安装并配置 Amazon CLI 版本 2,用于 CLI 步骤。

使用 ElastiCache,您可以使用系统管理的 IAM 用户 (default.iam-user) 和用户组 (default.iam-user-group) 开始使用,而无需创建自定义用户。要使用自定义用户组,请先创建一个所有用户都使用 IAM 身份验证的用户组,然后创建缓存。

Amazon Web Services 管理控制台
  1. 打开 ElastiCache 控制台,网址为https://console.aws.amazon.com/elasticache/。如果出现提示,请登录。

  2. 选择 “开始” 以打开 “创建缓存” 页面。

    带有 “入门” 按钮的主 ElastiCache 机主页。
  3. 在 “引擎” 下,选择 Valkey。

    选择了 Valkey 的 “创建缓存” 页面的 “引擎” 部分。
  4. 在 “部署” 选项下,选择无服务器。

    选择无服务器的 “部署” 选项部分。
  5. 在 “设置” 下,输入缓存的名称。(可选)输入描述。

    “设置” 部分显示了 “名称” 和 “描述” 字段。
  6. 在 “引擎版本” 下,保持选中默认值或选择 9 或更高版本。

    选择版本 9 的引擎版本控制。
  7. 对于 “连接类型”,选择 “公用”。

    已选择 “公用” 的 “连接类型” 部分。
  8. 默认情况下, ElastiCache 使用适用于大多数工作负载的推荐设置。如果您需要更改网络类型、调整缓存使用限制或选择其他用户组,请选择自定义默认设置。默认用户组是default.iam-user-group。群组中的所有用户都必须使用 IAM 身份验证。

    “自定义默认设置” 区域显示网络类型、安全设置和用户组。
  9. (可选)在 “标签” 下,选择 “添加新标签并添加标签”,以搜索和筛选您的缓存,或者跟踪您的 Amazon 成本。

    带有 “添加新标签” 按钮的 “标签” 部分。
  10. 选择创建。提交后,您将被重定向到缓存详细信息页面,其中缓存状态显示为正在创建。

    缓存详细信息页面将缓存状态显示为 “正在创建”。
  11. 等待 “缓存” 详细信息页面上的状态从 “正在创建” 变为 “可用”,然后再连接到缓存。缓存准备就绪后,页面会自动刷新。

    显示缓存状态的缓存详细信息页面已更改为 “可用”。
Amazon CLI

运行以下命令,使用系统管理的默认 IAM 用户组创建带有公有终端节点的缓存:

aws elasticache create-serverless-cache \ --serverless-cache-name my-public-cache \ --engine valkey \ --major-engine-version 9 \ --connection-type public \ --user-group-id default.iam-user-group

该命令返回包含缓存端点的响应:

{ "ServerlessCache": { "ServerlessCacheName": "my-public-cache", "Status": "creating", "Engine": "valkey", "MajorEngineVersion": "9", "ConnectionType": "public", "Endpoint": { "Address": "my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com", "Port": 6379 }, "UserGroupId": "default.iam-user-group" } }

记下 Endpoint.Address 的值。您可以使用此值连接到缓存。

要使用自定义用户组而不是默认用户组,请default.iam-user-group替换为您的用户组 ID。用户组中的所有用户都必须使用 IAM 身份验证。

Amazon SDK

以下示例使用公共端点创建缓存。

Python (boto3)

import boto3 client = boto3.client("elasticache", region_name="us-east-1") response = client.create_serverless_cache( ServerlessCacheName="my-public-cache", Engine="valkey", MajorEngineVersion="9", ConnectionType="public", UserGroupId="default.iam-user-group", ) print(response["ServerlessCache"]["Endpoint"]["Address"])

JavaScript (Amazon SDK v3)

import { ElastiCacheClient, CreateServerlessCacheCommand } from "@aws-sdk/client-elasticache"; const client = new ElastiCacheClient({ region: "us-east-1" }); const response = await client.send(new CreateServerlessCacheCommand({ ServerlessCacheName: "my-public-cache", Engine: "valkey", MajorEngineVersion: "9", ConnectionType: "public", UserGroupId: "default.iam-user-group", })); console.log(response.ServerlessCache?.Endpoint?.Address);

Java (Amazon SDK v2)

import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.elasticache.ElastiCacheClient; import software.amazon.awssdk.services.elasticache.model.CreateServerlessCacheRequest; import software.amazon.awssdk.services.elasticache.model.CreateServerlessCacheResponse; try (ElastiCacheClient client = ElastiCacheClient.builder() .region(Region.US_EAST_1) .build()) { CreateServerlessCacheResponse response = client.createServerlessCache( CreateServerlessCacheRequest.builder() .serverlessCacheName("my-public-cache") .engine("valkey") .majorEngineVersion("9") .connectionType("public") .userGroupId("default.iam-user-group") .build()); System.out.println(response.serverlessCache().endpoint().address()); }

缓存可用后,请参阅使用公共端点连接到缓存。