기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Valkey 및 Redis OSS 클러스터의 노드에 연결
<a name="ClientConfig.ReplicationGroup"></a>

**참고**  
이때, 복제를 지원하는 클러스터(API/CLI: 복제 그룹) 및 읽기 전용 복제본은 Valkey 및 Redis OSS를 실행하는 클러스터에 대해서만 지원됩니다.

클러스터의 경우 ElastiCache는 콘솔, CLI 및 API 인터페이스를 제공하여 개별 노드에 대한 연결 정보를 얻습니다.

읽기 전용 활동의 경우 애플리케이션은 클러스터의 모든 노드에 연결할 수 있습니다. 그러나 쓰기 활동의 경우 애플리케이션은 직접 노드에 연결하는 대신 클러스터에 대한 기본 엔드포인트(Valkey 및 Redis OSS(클러스터 모드 비활성화됨)) 또는 구성 엔드포인트(Valkey 및 Redis OSS(클러스터 모드 활성화됨))에 연결하는 것이 좋습니다. 이렇게 하면 읽기 전용 복제본을 기본 역할로 승격하여 클러스터를 재구성할 경우에도 애플리케이션이 항상 올바른 노드를 찾을 수 있습니다.

## 복제 그룹의 클러스터에 연결(콘솔)
<a name="ClientConfig.ReplicationGroup.CON"></a>

**Endpoint 및 포트 번호를 확인하려면**
+ [Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터의 엔드포인트 찾기(콘솔)](Endpoints.md#Endpoints.Find.Redis) 항목을 참조하세요.

## 복제 그룹의 클러스터에 연결(AWS CLI)
<a name="ClientConfig.ReplicationGroup.CLI"></a>

 **캐시 노드 Endpoint 및 포트 번호를 확인하려면**

`describe-replication-groups` 명령을 복제 그룹 이름과 함께 사용합니다.

```
aws elasticache describe-replication-groups redis2x2
```

이 명령은 다음과 유사한 출력을 생성합니다.

```
{
    "ReplicationGroups": [
        {
            "Status": "available", 
            "Description": "2 shards, 2 nodes (1 + 1 replica)", 
            "NodeGroups": [
                {
                    "Status": "available", 
                    "Slots": "0-8191", 
                    "NodeGroupId": "0001", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2c", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0001-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0001-002"
                        }
                    ]
                }, 
                {
                    "Status": "available", 
                    "Slots": "8192-16383", 
                    "NodeGroupId": "0002", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2b", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0002-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0002-002"
                        }
                    ]
                }
            ], 
            "ConfigurationEndpoint": {
                "Port": 6379, 
                "Address": "redis2x2.9dcv5r.clustercfg.usw2.cache.amazonaws.com"
            }, 
            "ClusterEnabled": true, 
            "ReplicationGroupId": "redis2x2", 
            "SnapshotRetentionLimit": 1, 
            "AutomaticFailover": "enabled", 
            "SnapshotWindow": "13:00-14:00", 
            "MemberClusters": [
                "redis2x2-0001-001", 
                "redis2x2-0001-002", 
                "redis2x2-0002-001", 
                "redis2x2-0002-002"
            ], 
            "CacheNodeType": "cache.m3.medium", 
            "PendingModifiedValues": {}
        }
    ]
}
```

## 복제 그룹의 클러스터에 연결(ElastiCache API)
<a name="ClientConfig.ReplicationGroup.API"></a>

 **캐시 노드 Endpoint 및 포트 번호를 확인하려면** 

`DescribeReplicationGroups`를 다음 파라미터를 사용하여 호출합니다.

`ReplicationGroupId` = 복제 그룹 이름

**Example**  

```
 1. https://elasticache.us-west-2.amazonaws.com /
 2.     ?Action=DescribeCacheClusters
 3.     &ReplicationGroupId=repgroup01
 4.     &Version=2014-09-30   
 5.     &SignatureVersion=4
 6.     &SignatureMethod=HmacSHA256
 7.     &Timestamp=20140421T220302Z
 8.     &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
 9.     &X-Amz-Date=20140421T220302Z
10.     &X-Amz-SignedHeaders=Host
11.     &X-Amz-Expires=20140421T220302Z
12.     &X-Amz-Credential=<credential>
13.     &X-Amz-Signature=<signature>
```