Amazon ElastiCache
ElastiCache for Memcached 用户指南 (API 版本 2015-02-02)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

查找连接终端节点

您的应用程序使用终端节点连接到集群。终端节点是节点或集群的唯一的地址。

该使用哪些终端节点

  • Memcached 集群:如果您使用 Automatic Discovery,则可以使用该集群的配置终端节点 来配置 Memcached 客户端。这意味着您必须使用支持 Automatic Discovery 的客户端。

    如果您不使用 Automatic Discovery,则必须对客户端进行配置,以便针对读取和写入使用不同的节点终端节点。此外,在添加或删除节点时,您还必须跟踪它们的情况。

     

以下部分将引导您发现正在运行的引擎所需的终端节点。

查找集群的终端节点(控制台)

所有 Memcached 终端节点都是读写终端节点。要连接到 Memcached 集群中的节点,您的应用程序可以使用每个节点的终端节点或将集群的配置终端节点与 Automatic Discovery 结合使用。要使用 Automatic Discovery,您必须使用支持 Automatic Discovery 的客户端。

在使用 Automatic Discovery 时,您的客户端应用程序将使用配置终端节点连接到 Memcached 集群。当您通过添加或移除节点来扩展集群,应用程序将自动“获知”集群中的所有节点并能够连接到其中任一节点。如果没有 Automatic Discovery,应用程序将必须执行此操作,否则,您在每次添加或移除节点时,必须手动更新应用程序中的终端节点。有关 Automatic Discovery 的其他信息,请参阅自动识别 Memcached 集群中的节点

以下过程演示如何使用 ElastiCache 控制台查找和复制集群的配置终端节点或任意节点终端节点。

查找和复制 Memcached 集群的终端节点(控制台)

  1. 登录 AWS 管理控制台 并通过以下网址打开 ElastiCache 控制台:https://console.amazonaws.cn/elasticache/

  2. 从导航窗格中,选择 Memcached

    此时将出现缓存集群屏幕,其中显示 Memcached 集群的列表。

  3. 查找需要其终端节点的 Memcached 集群。

    如果您仅需要配置终端节点,您便已实现目标。配置终端节点位于 Configuration Endpoint 列,内容如下所示: clusterName.xxxxxx.cfg.usw2.cache.amazonaws.com:port

    如果您还想查看单个节点终端节点或将任意终端节点复制到剪贴板,请选择 Copy Node Endpoint

    
						图像:显示 Memcached 集群的终端节点的屏幕

    Memcached 集群的终端节点

  4. 将终端节点复制到剪贴板:

    1. Copy Node Endpoint 屏幕上,突出显示要复制的终端节点。

    2. 右键单击突出显示的终端节点,然后从上下文菜单中选择 Copy (复制)

    突出显示的终端节点现已复制到剪贴板。

配置终端节点和节点终端节点看上非常相似。不同之处以粗体 形式突出显示。

myclustername.xxxxxx.cfg.usw2.cache.amazonaws.com:port # configuration endpoint contains "cfg" myclustername.xxxxxx.0001.usw2.cache.amazonaws.com:port # node endpoint for node 0001

重要

如果您选择为 Memcached 配置终端节点创建别名记录,以使自动发现客户端可以识别别名记录作为配置终端节点,则必须在别名记录中包含 .cfg.

(AWS CLI) 查找终端节点

您可以使用 AWS CLI for Amazon ElastiCache 来搜索节点和集群的终端节点。

(AWS CLI) 查找节点和集群的终端节点

您可以使用 AWS CLI,通过 describe-cache-clusters 命令查找集群及其节点的终端节点。 对于 Memcached 集群,此命令将返回配置终端节点。 如果包含可选参数 --show-cache-node-info,则此命令还将返回集群中的单个节点的终端节点。

以下命令检索 Memcached 集群 mycluster 的配置终端节点 (ConfigurationEndpoint) 和各个节点终端节点 (Endpoint)。

对于 Linux, OS X, or Unix:

aws elasticache describe-cache-clusters \ --cache-cluster-id mycluster \ --show-cache-node-info

对于 Windows:

aws elasticache describe-cache-clusters ^ --cache-cluster-id mycluster ^ --show-cache-node-info

上面的操作输出类似以下的内容(JSON 格式)。

{ "CacheClusters": [ { "Engine": "memcached", "CacheNodes": [ { "CacheNodeId": "0001", "Endpoint": { "Port": 11211, "Address": "mycluster.1abc4d.0001.usw2.cache.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" }, { "CacheNodeId": "0002", "Endpoint": { "Port": 11211, "Address": "mycluster.1abc4d.0002.usw2.cache.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" }, { "CacheNodeId": "0003", "Endpoint": { "Port": 11211, "Address": "mycluster.1abc4d.0003.usw2.cache.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" } ], "CacheParameterGroup": { "CacheNodeIdsToReboot": [], "CacheParameterGroupName": "default.memcached1.4", "ParameterApplyStatus": "in-sync" }, "CacheClusterId": "mycluster", "PreferredAvailabilityZone": "us-west-2b", "ConfigurationEndpoint": { "Port": 11211, "Address": "mycluster.1abc4d.cfg.usw2.cache.amazonaws.com" }, "CacheSecurityGroups": [], "CacheClusterCreateTime": "2016-09-22T21:30:29.967Z", "AutoMinorVersionUpgrade": true, "CacheClusterStatus": "available", "NumCacheNodes": 3, "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheSubnetGroupName": "default", "EngineVersion": "1.4.24", "PendingModifiedValues": {}, "PreferredMaintenanceWindow": "mon:09:00-mon:10:00", "CacheNodeType": "cache.m4.large" } ] }

重要

如果您选择为 Memcached 配置终端节点创建别名记录,以使 PHP 客户端可以识别别名记录作为配置终端节点,则必须在别名记录中包含 .cfg.。例如,php.ini 文件中的 session.save_path 参数的 mycluster.cfg.local

有关更多信息,请参阅主题 describe-cache-clusters

(ElastiCache API) 查找终端节点

您可以使用 Amazon ElastiCache API 来搜索节点和集群的终端节点。

(ElastiCache API) 查找节点和集群的终端节点

您可以使用 ElastiCache API,通过 DescribeCacheClusters 操作查找集群及其节点的终端节点。 对于 Memcached 集群,此命令将返回配置终端节点。 如果包含可选参数 ShowCacheNodeInfo,则此操作还将返回集群中的各个节点的终端节点。

以下命令检索 Memcached 集群 mycluster 的配置终端节点 (ConfigurationEndpoint) 和各个节点终端节点 (Endpoint)。

https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeCacheClusters &CacheClusterId=mycluster &ShowCacheNodeInfo=true &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

重要

如果您选择为 Memcached 配置终端节点创建别名记录,以使 PHP 客户端可以识别别名记录作为配置终端节点,则必须在别名记录中包含 .cfg.。例如,php.ini 文件中的 session.save_path 参数的 mycluster.cfg.local