

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

# 连接到节点


## 连接到 Valkey 或 Redis OSS 节点


在尝试与 Valkey 或 Redis OSS 集群中的节点连接之前，您必须拥有适用于这些节点的端点。要找到终端节点，请参阅：
+ [查找 Valkey 或 Redis OSS（已禁用集群模式）集群端点（控制台）](Endpoints.md#Endpoints.Find.Redis)
+ [查找 Valkey 或 Redis OSS（已启用集群模式）集群的端点（控制台）](Endpoints.md#Endpoints.Find.RedisCluster)
+ [查找端点（Amazon CLI）](Endpoints.md#Endpoints.Find.CLI)
+ [查找端点（ElastiCache API）](Endpoints.md#Endpoints.Find.API)

在以下示例中，您使用 *valkey-cli* 实用工具连接到运行 Valkey 或 Redis OSS 的集群。

**注意**  
有关可用命令的更多信息，请参阅[命令](http://valkey.io/commands)网页。

**使用 *valkey-cli* 连接到 Valkey 或 Redis OSS 集群**

1. 使用您选择的连接实用工具连接到 Amazon EC2 实例。
**注意**  
有关如何连接到 Amazon EC2 实例的说明，请参阅 [Amazon EC2 入门指南](https://docs.amazonaws.cn/AWSEC2/latest/GettingStartedGuide/)。

1. 要生成 `valkey-cli`，请下载并安装 GNU Compiler Collection (`gcc`)。在 EC2 实例的命令提示符下输入下面的命令，然后在确认提示符下输入 `y`。

   ```
   sudo yum install gcc
   ```

   此时会显示类似以下内容的输出。

   ```
   Loaded plugins: priorities, security, update-motd, upgrade-helper
   Setting up Install Process
   Resolving Dependencies
   --> Running transaction check
   
   ...(output omitted)...
   
   Total download size: 27 M
   Installed size: 53 M
   Is this ok [y/N]: y
   Downloading Packages:
   (1/11): binutils-2.22.52.0.1-10.36.amzn1.x86_64.rpm      | 5.2 MB     00:00     
   (2/11): cpp46-4.6.3-2.67.amzn1.x86_64.rpm                | 4.8 MB     00:00     
   (3/11): gcc-4.6.3-3.10.amzn1.noarch.rpm                  | 2.8 kB     00:00     
   
   ...(output omitted)...
   
   Complete!
   ```

1. 下载并编译 *valkey-cli* 实用工具。此实用工具包含在 Valkey 软件发布版中。在 EC2 实例的命令提示符处，键入以下命令：
**注意**  
对于 Ubuntu 系统，在运行 `make` 之前，先运行 `make distclean`。

   ```
   wget https://github.com/valkey-io/valkey/archive/refs/tags/8.0.0.tar.gz
   tar xvzf valkey-8.0.0.tar.gz
   cd valkey-8.0.0
   make distclean      # ubuntu systems only
   make
   ```

1. 在 EC2 实例的命令提示符处，键入以下命令。

   ```
   src/valkey-cli -c -h mycachecluster.eaogs8.0001.usw2.cache.amazonaws.com -p 6379
   ```

   此时会显示类似于以下内容的 Valkey 或 Redis OSS 命令提示符。

   ```
   redis mycachecluster.eaogs8.0001.usw2.cache.amazonaws.com 6379>
   ```

1. 运行 Valkey 或 Redis OSS 命令测试连接。

    您现已连接至集群并且可以运行 Valkey 或 Redis OSS 命令。以下是一些示例命令及其 Valkey 或 Redis OSS 响应。

   ```
   set a "hello"          // Set key "a" with a string value and no expiration
   OK
   get a                  // Get value for key "a"
   "hello"
   get b                  // Get value for key "b" results in miss
   (nil)				
   set b "Good-bye" EX 5  // Set key "b" with a string value and a 5 second expiration
   get b
   "Good-bye"
                      // wait 5 seconds
   get b
   (nil)                  // key has expired, nothing returned
   quit                   // Exit from valkey-cli
   ```

要连接到具有安全套接字层 (SSL) 加密（启用了传输中加密）的节点或集群，请参阅[ElastiCache 传输中加密 (TLS)](in-transit-encryption.md)。

## 连接到 Memcached 节点


在尝试与 Memcached 集群连接之前，您必须拥有适用于这些节点的终端节点。要找到终端节点，请参阅：
+ [查找集群的端点（控制台）（Memcached）](Endpoints.md#Endpoints.Find.Memcached)
+ [查找端点（Amazon CLI）](Endpoints.md#Endpoints.Find.CLI)
+ [查找端点（ElastiCache API）](Endpoints.md#Endpoints.Find.API)

在以下示例中，您使用 *telnet* 实用工具连接到运行 Memcached 的节点。

**注意**  
有关 Memcached 以及可用 Memcached 命令的更多信息，请参阅 [Memcached](http://memcached.org/) 网站。

**使用 *telnet* 连接到节点**

1. 使用您选择的连接实用工具连接到 Amazon EC2 实例。
**注意**  
 有关如何连接到 Amazon EC2 实例的说明，请参阅 [Amazon EC2 入门指南](https://docs.amazonaws.cn/AWSEC2/latest/GettingStartedGuide/)。

1. 在 Amazon EC2 实例下载并安装 *telnet* 实用工具。在 Amazon EC2 实例的命令提示符处，键入以下命令，然后键入 *y*。

   ```
   sudo yum install telnet
   ```

   此时会显示类似以下内容的输出。

   ```
   Loaded plugins: priorities, security, update-motd, upgrade-helper
   Setting up Install Process
   Resolving Dependencies
   --> Running transaction check
   
   ...(output omitted)...
   
   Total download size: 63 k
   Installed size: 109 k
   Is this ok [y/N]: y
   Downloading Packages:
   telnet-0.17-47.7.amzn1.x86_64.rpm                        |  63 kB     00:00  
   
   ...(output omitted)...
   
   Complete!
   ```

1. 在 Amazon EC2 实例的命令提示符处，键入以下命令，并使用节点的端点替换此示例中所示的相应节点端点。

   ```
   telnet mycachecluster.eaogs8.0001.usw2.cache.amazonaws.com 11211
   ```

   此时会显示类似以下内容的输出。

   ```
   Trying 128.0.0.1...
   Connected to mycachecluster.eaogs8.0001.usw2.cache.amazonaws.com.
   Escape character is '^]'.
   >
   ```

1. 运行 Memcached 命令测试连接。

    您现已连接到一个节点，可以运行 Memcached 命令了。示例如下：

   ```
   set a 0 0 5      // Set key "a" with no expiration and 5 byte value
   hello            // Set value as "hello"
   STORED
   get a            // Get value for key "a"
   VALUE a 0 5
   hello
   END
   get b            // Get value for key "b" results in miss
   END
   >
   ```