기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ElastiCache에서 연결 엔드포인트 찾기
애플리케이션에서 엔드포인트를 사용하여 ElastiCache 클러스터에 연결합니다. 엔드포인트는 노드나 클러스터의 고유한 주소입니다.
를 통해 인터페이스 VPC 엔드포인트를 생성하여 VPC와 ElastiCache API 엔드포인트 간에 프라이빗 연결을 설정할 수도 있습니다 AWS PrivateLink. 자세한 내용은 ElastiCache API 및 인터페이스 VPC 엔드포인트(AWS PrivateLink) 단원을 참조하십시오.
Valkey 또는 Redis OSS와 함께 사용할 엔드포인트입니다.
-
독립 실행형 노드의 경우 읽기 및 쓰기 작업 모두에 노드의 엔드포인트를 사용합니다.
-
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터의 경우 모든 쓰기 작업에 기본 엔드포인트를 사용합니다. 리더 엔드포인트를 사용하여 모든 읽기 전용 복제본 사이에 수신 연결을 고르게 분할합니다. 읽기 작업에는 개별 노드 엔드포인트(API/CLI에서는 읽기 엔드포인트라고 함)를 사용하세요.
-
Valkey 또는 Redis OSS(클러스터 모드 활성화됨) 클러스터의 경우 클러스터 모드 활성화 명령을 지원하는 모든 작업에 대해 클러스터의 구성 엔드포인트를 사용합니다. Valkey 클러스터 또는 Redis OSS 3.2 이상의 Redis OSS 클러스터를 지원하는 클라이언트를 사용해야 합니다. 개별 노드 엔드포인트(API/CLI에서는 읽기 엔드포인트라고 함)에서 계속 읽을 수 있습니다.
다음 섹션에서는 실행 중인 엔진에 필요한 엔드포인트를 찾는 방법을 안내합니다.
Memcached와 함께 사용할 엔드포인트입니다.
Memcached용 ElastiCache 서버리스 캐시의 경우 콘솔에서 클러스터 엔드포인트 DNS 및 포트를 획득하기만 하면 됩니다.
에서 describe-serverless-caches 명령을 AWS CLI사용하여 엔드포인트 정보를 가져옵니다.
Linux
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
Windows
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
위 작업의 출력은 다음과 유사해야 합니다(JSON 형식).
{ "ServerlessCaches": [ { "ServerlessCacheName": "serverless-memcached", "Description": "test", "CreateTime": 1697659642.136, "Status": "available", "Engine": "memcached", "MajorEngineVersion": "1.6", "FullEngineVersion": "21", "SecurityGroupIds": [ "sg-083eda453e1e51310" ], "Endpoint": { "Address": "serverless-memcached-01.amazonaws.com", "Port":11211 }, "ARN": "<the ARN>", "SubnetIds": [ "subnet-0cf759df15bd4dc65", "subnet-09e1307e8f1560d17" ], "SnapshotRetentionLimit": 0, "DailySnapshotTime": "03:00" } ] }
인스턴스 기반 Memcached 클러스터의 경우 자동 검색을 사용하는 경우 클러스터의 구성 엔드포인트를 사용하여 Memcached 클라이언트를 구성할 수 있습니다. Auto Discovery를 지원하는 클라이언트를 사용해야 합니다.
Auto Discovery를 사용하지 않으면 읽기 및 쓰기를 위해 개별 노드 엔드포인트를 사용하도록 클라이언트를 구성해야 합니다. 또한 노드를 추가 및 제거할 때 엔드포인트를 추적해야 합니다.
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터에 노드가 하나만 있는 경우 노드의 엔드포인트는 읽기 및 쓰기 모두에 사용됩니다. Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터에 여러 노드가 있는 경우 기본 엔드포인트, 리더 엔드포인트 및 노드 엔드포인트의 세 가지 유형의 엔드포인트가 있습니다.
기본 엔드포인트는 항상 클러스터의 기본 노드로 확인되는 DNS 이름입니다. 기본 엔드포인트는 읽기 전용 복제본을 기본 역할로 승격하는 것과 같은 클러스터 변경의 영향을 받지 않습니다. 쓰기 활동의 경우 애플리케이션을 기본 엔드포인트에 연결하는 것이 좋습니다.
리더 엔드포인트는 ElastiCache for Redis OSS 클러스터의 모든 읽기 전용 복제본 간에 엔드포인트에 대한 수신 연결을 균등하게 분할합니다. 애플리케이션이 연결을 생성하는 시기 또는 애플리케이션에서 연결을 다시 사용하는 방법과 같은 추가 요소가 트래픽 분산을 결정합니다. 리더 엔드포인트는 복제본이 추가 또는 제거되는 클러스터의 변경 사항을 실시간으로 반영합니다. ElastiCache for Redis OSS 클러스터의 여러 읽기 전용 복제본을 서로 다른 AWS 가용 영역(AZ)에 배치하여 리더 엔드포인트의 고가용성을 보장할 수 있습니다.
참고
리더 엔드포인트는 로드 밸런서가 아닙니다. 라운드 로빈 방식으로 복제본 노드 중 하나의 IP 주소로 확인되는 DNS 레코드입니다.
읽기 활동의 경우 애플리케이션은 클러스터의 어떤 노드에도 연결할 수 있습니다. 기본 엔드포인트와 달리, 노드 엔드포인트는 특정 엔드포인트로 확인됩니다. 복제본을 추가하거나 삭제하는 것과 같이 클러스터를 변경하면 애플리케이션에서 노드 엔드포인트를 업데이트해야 합니다.
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터의 엔드포인트를 찾으려면
-
에 로그인 AWS Management Console 하고 ElastiCache 콘솔을 https://console.aws.amazon.com/elasticache/
://https://https://https://://https://://https://://https://://https://https://://https://https://://https:// -
탐색 창에서 Valkey 클러스터 또는 Redis OSS 클러스터를 선택합니다.
클러스터 화면에 Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 및 Valkey 또는 Redis OSS(클러스터 모드 활성화됨) 클러스터 목록이 표시됩니다.
-
클러스터의 기본 엔드포인트 및/또는 리더 엔드포인트를 찾으려면 클러스터 이름(왼쪽에 있는 버튼 아님)을 선택합니다.
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터의 기본 및 리더 엔드포인트
클러스터에 노드가 하나 뿐이면 기본 엔드포인트가 없으며 다음 단계에서 계속할 수 있습니다.
-
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터에 복제본 노드가 있는 경우 클러스터의 이름을 선택한 다음 노드 탭을 선택하여 클러스터의 복제본 노드 엔드포인트를 찾을 수 있습니다.
노드 화면에 클러스터의 각 노드, 기본 및 복제본이 엔드포인트와 함께 나열됩니다.
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터의 노드 엔드포인트
-
엔드포인트를 클립보드에 복사하려면
-
한 번에 엔드포인트 하나씩, 복사할 엔드포인트를 찾습니다.
-
엔드포인트 바로 앞에 있는 복사 아이콘을 선택합니다.
엔드포인트가 클립보드에 복사됩니다. 엔드포인트를 사용하여 노드에 연결하는 방법에 대한 자세한 내용은 Memcached 노드에 연결 섹션을 참조하세요.
-
Valkey 또는 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 기본 엔드포인트는 다음과 같습니다. 전송 중 데이터 암호화가 활성화되어 있는지 여부에 따라 차이가 있습니다.
전송 중 데이터 암호화가 비활성화된 경우
clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379전송 중 데이터 암호화가 활성화된 경우
master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port
master.ncit.ameaqx.use1.cache.amazonaws.com:6379Valkey 또는 Redis OSS(클러스터 모드 활성화됨) 클러스터에는 단일 구성 엔드포인트가 있습니다. 구성 엔드포인트에 연결되면 애플리케이션이 클러스터의 각 샤드에 대한 기본 및 읽기 엔드포인트를 찾을 수 있습니다.
Valkey 또는 Redis OSS(클러스터 모드 활성화됨) 클러스터의 엔드포인트를 찾으려면
-
에 로그인 AWS Management Console 하고 ElastiCache 콘솔을 https://console.aws.amazon.com/elasticache/
://https://https://https://https://://https://://https://://https://https://://https://://https://://://https -
탐색 창에서 Valkey 클러스터 또는 Redis OSS 클러스터를 선택합니다.
클러스터 목록이 포함된 클러스터 화면이 나타납니다. 연결하려는 클러스터를 선택합니다.
-
클러스터의 구성 엔드포인트를 찾으려면 클러스터 이름(라디오 버튼 아님)을 선택합니다.
-
Configuration endpoint(구성 엔드포인트)는 Cluster details(클러스터 세부 정보) 아래 표시됩니다. 이를 복사하려면 엔드포인트 왼쪽에 있는 복사 아이콘을 선택합니다.
모든 Memcached 엔드포인트는 읽기/쓰기 엔드포인트입니다. Memcached 클러스터에 있는 노드에 연결하기 위해 애플리케이션은 각 노드의 엔드포인트를 사용하거나 Auto Discovery와 함께 클러스터의 구성 엔드포인트를 사용할 수 있습니다. Auto Discovery를 사용하려면 Auto Discovery를 지원하는 클라이언트를 사용해야 합니다.
Auto Discovery를 사용하면 클라이언트 애플리케이션이 구성 엔드포인트를 사용하여 Memcached 클러스터에 연결합니다. 노드를 추가하거나 제거하여 클러스터를 조정할 때는 애플리케이션에서 클러스터의 모든 노드를 자동으로 "인식"하고 그 중에서 어디에나 연결할 수 있습니다. Auto Discovery를 사용하지 않으면 애플리케이션에서 이 작업을 수행하거나, 사용자가 노드를 추가하거나 제거할 때마다 애플리케이션의 엔드포인트를 수동으로 업데이트해야 합니다.
엔드포인트를 복사하려면 엔드포인트 주소 바로 앞에 있는 복사 아이콘을 선택합니다. 엔드포인트를 사용하여 노드에 연결하는 방법에 대한 자세한 내용은 Memcached 노드에 연결 섹션을 참조하세요.
구성 엔드포인트와 노드 엔드포인트는 매우 비슷합니다. 두 엔드포인트의 차이는 다음과 같이 굵게 표시됩니다.
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 구성 엔드포인트의 CNAME을 만들기로 선택하면 CNAME에 .cfg.를 포함해야 자동 검색 클라이언트가 CNAME을 구성 엔드포인트로 인식합니다.
Memcached의 경우 Amazon ElastiCache AWS CLI 용를 사용하여 노드 및 클러스터의 엔드포인트를 검색할 수 있습니다.
Redis OSS의 경우 Amazon ElastiCache AWS CLI 용를 사용하여 노드, 클러스터 및 복제 그룹의 엔드포인트를 검색할 수 있습니다.
노드 및 클러스터의 엔드포인트 찾기(AWS CLI)
를 사용하여 describe-cache-clusters 명령을 AWS CLI 사용하여 클러스터 및 해당 노드의 엔드포인트를 검색할 수 있습니다. Valkey 또는 Redis OSS 클러스터의 경우 명령이 클러스터 엔드포인트를 반환합니다. Memcached 클러스터의 경우 명령이 구성 엔드포인트를 반환합니다. 또한 선택적 파라미터 --show-cache-node-info를 포함할 경우 명령이 클러스터에 있는 개별 노드의 엔드포인트를 반환합니다.
다음 명령은 Memcached 클러스터 mycluster의 구성 엔드포인트(ConfigurationEndpoint) 및 개별 노드 엔드포인트(Endpoint)를 검색합니다.
Linux, macOS, Unix의 경우:
aws elasticache describe-cache-clusters \ --cache-cluster-idmycluster\ --show-cache-node-info
Windows의 경우:
aws elasticache describe-cache-clusters ^ --cache-cluster-idmycluster^ --show-cache-node-info
위 작업의 출력은 다음과 같습니다(JSON 형식).
{
"CacheClusters": [
{
"Engine": "memcached",
"CacheNodes": [
{
"CacheNodeId": "0001",
"Endpoint": {
"Port": 11211,
"Address": "mycluster.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.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.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.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",
"DataTiering": "disabled"
}
]
}중요
Memcached 구성 엔드포인트의 CNAME을 만들기로 선택하면 CNAME에 .cfg.를 포함해야 자동 검색 클라이언트가 CNAME을 구성 엔드포인트로 인식합니다. 예를 들어, mycluster가 .cfg.localsession.save_path 파라미터의 php.ini 파일에 있습니다.
Valkey 및 Redis OSS의 경우, 다음 명령을 통해 단일 노드 클러스터인 mycluster의 클러스터 정보를 검색할 수 있습니다.
중요
파라미터 --cache-cluster-id는 복제 그룹에서 단일 노드 Valkey 또는 Redis OSS(클러스터 모드 비활성화됨) 클러스터 ID 또는 특정 노드와 함께 사용할 수 있습니다. 복제 그룹의 --cache-cluster-id는 0001와 같은 4자리 값입니다. --cache-cluster-id가 복제 그룹에 있는 클러스터(노드)의 ID인 경우 replication-group-id가 출력에 포함됩니다.
Linux, macOS, Unix의 경우:
aws elasticache describe-cache-clusters \ --cache-cluster-idredis-cluster\ --show-cache-node-info
Windows의 경우:
aws elasticache describe-cache-clusters ^ --cache-cluster-idredis-cluster^ --show-cache-node-info
위 작업의 출력은 다음과 같습니다(JSON 형식).
{
"CacheClusters": [
{
"CacheClusterStatus": "available",
"SecurityGroups": [
{
"SecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"CacheNodes": [
{
"CustomerAvailabilityZone": "us-east-1b",
"CacheNodeCreateTime": "2018-04-25T18:19:28.241Z",
"CacheNodeStatus": "available",
"CacheNodeId": "0001",
"Endpoint": {
"Address": "redis-cluster.amazonaws.com",
"Port": 6379
},
"ParameterGroupStatus": "in-sync"
}
],
"AtRestEncryptionEnabled": false,
"CacheClusterId": "redis-cluster",
"TransitEncryptionEnabled": false,
"CacheParameterGroup": {
"ParameterApplyStatus": "in-sync",
"CacheNodeIdsToReboot": [],
"CacheParameterGroupName": "default.redis3.2"
},
"NumCacheNodes": 1,
"PreferredAvailabilityZone": "us-east-1b",
"AutoMinorVersionUpgrade": true,
"Engine": "redis",
"AuthTokenEnabled": false,
"PendingModifiedValues": {},
"PreferredMaintenanceWindow": "tue:08:30-tue:09:30",
"CacheSecurityGroups": [],
"CacheSubnetGroupName": "default",
"CacheNodeType": "cache.t2.small",
"DataTiering": "disabled"
"EngineVersion": "3.2.10",
"ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
"CacheClusterCreateTime": "2018-04-25T18:19:28.241Z"
}
]
}자세한 내용은 describe-cache-clusters 섹션을 참조하세요.
Valkey 또는 Redis OSS 복제 그룹의 엔드포인트 찾기(AWS CLI)
를 사용하여 describe-replication-groups 명령을 AWS CLI 사용하여 복제 그룹 및 해당 클러스터의 엔드포인트를 검색할 수 있습니다. 이 명령은 리더 엔드포인트와 함께, 복제 그룹의 기본 엔드포인트와 복제 그룹에 있는 모든 클러스터(노드)의 목록 및 해당 엔드포인트를 반환합니다.
다음 작업은 복제 그룹 myreplgroup의 기본 엔드포인트 및 리더 엔드포인트를 검색합니다. 모든 쓰기 작업에 기본 엔드포인트를 사용합니다.
aws elasticache describe-replication-groups \ --replication-group-idmyreplgroup
Windows의 경우:
aws elasticache describe-replication-groups ^ --replication-group-idmyreplgroup
이 작업의 출력은 다음과 같습니다(JSON 형식).
{
"ReplicationGroups": [
{
"Status": "available",
"Description": "test",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-001.amazonaws.com"
},
"CacheClusterId": "myreplgroup-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-002.amazonaws.com"
},
"CacheClusterId": "myreplgroup-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-003.amazonaws.com"
},
"CacheClusterId": "myreplgroup-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "myreplgroup.amazonaws.com"
},
"ReaderEndpoint": {
"Port": 6379,
"Address": "myreplgroup-ro.amazonaws.com"
}
}
],
"ReplicationGroupId": "myreplgroup",
"AutomaticFailover": "enabled",
"SnapshottingClusterId": "myreplgroup-002",
"MemberClusters": [
"myreplgroup-001",
"myreplgroup-002",
"myreplgroup-003"
],
"PendingModifiedValues": {}
}
]
}자세한 내용은 AWS CLI 명령 참조에서 describe-replication-groups를 참조하세요.
Memcached의 경우, Amazon ElastiCache API를 사용하여 노드 및 클러스터의 엔드포인트를 찾을 수 있습니다.
Redis OSS의 경우 Amazon ElastiCache API를 사용하여 노드, 클러스터 및 복제 그룹의 엔드포인트를 검색할 수 있습니다.
노드 및 클러스터의 엔드포인트 찾기(ElastiCache API)
ElastiCache API를 사용하여 DescribeCacheClusters 작업으로 클러스터 및 해당 노드의 엔드포인트를 찾을 수 있습니다. Valkey 또는 Redis OSS 클러스터의 경우 명령이 클러스터 엔드포인트를 반환합니다. Memcached 클러스터의 경우 명령이 구성 엔드포인트를 반환합니다. 또한 선택적 파라미터 ShowCacheNodeInfo를 포함할 경우 작업이 클러스터에 있는 개별 노드의 엔드포인트를 반환합니다.
Memcached의 경우, 다음 명령은 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 구성 엔드포인트의 CNAME을 만들기로 선택하면 CNAME에 .cfg.를 포함해야 자동 검색 클라이언트가 CNAME을 구성 엔드포인트로 인식합니다. 예를 들어, mycluster가 .cfg.localsession.save_path 파라미터의 php.ini 파일에 있습니다.
Valkey 또는 Redis OSS 복제 그룹의 엔드포인트 찾기(ElastiCache API)
ElastiCache API를 사용하여 DescribeReplicationGroups 작업으로 복제 그룹 및 해당 클러스터의 엔드포인트를 찾을 수 있습니다. 이 작업은 리더 엔드포인트와 함께, 복제 그룹의 기본 엔드포인트와 복제 그룹에 있는 모든 클러스터의 목록 및 해당 엔드포인트를 반환합니다.
다음 작업은 복제 그룹 myreplgroup의 기본 엔드포인트(PrimaryEndpoint), 리더 엔드포인트(ReaderEndpoint) 및 개별 노드 엔드포인트(ReadEndpoint)를 검색합니다. 모든 쓰기 작업에 기본 엔드포인트를 사용합니다.
https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeReplicationGroups &ReplicationGroupId=myreplgroup &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>
자세한 정보는 DescribeReplicationGroups를 참조하세요.
