기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
에서 연결 엔드포인트 찾기 ElastiCache
애플리케이션은 엔드포인트를 사용하여 ElastiCache 클러스터에 연결됩니다. 엔드포인트는 노드나 클러스터의 고유한 주소입니다.
Valkey 또는 Redis와 함께 사용할 엔드포인트 OSS
-
독립형 노드 , 읽기 및 쓰기 작업 모두에 노드의 엔드포인트를 사용합니다.
-
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터 에서 모든 쓰기 작업에 기본 엔드포인트를 사용합니다. 리더 엔드포인트를 사용하여 모든 읽기 전용 복제본 사이에 수신 연결을 고르게 분할합니다. 읽기 작업에 개별 노드 엔드포인트를 사용합니다(API/CLI에서는 이러한 엔드포인트를 읽기 엔드포인트라고 함).
-
Valkey 또는 RedisOSS(클러스터 모드 활성화됨) 클러스터 , 클러스터 모드 활성화 명령을 지원하는 모든 작업에 대해 클러스터의 구성 엔드포인트를 사용합니다. Valkey 클러스터 또는 Redis OSS 클러스터(Redis OSS 3.2)를 지원하는 클라이언트를 사용해야 합니다. 개별 노드 엔드포인트에서 계속 읽을 수 있습니다(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 클러스터에서 Auto Discovery를 사용하는 경우 클러스터의 구성 엔드포인트를 사용하여 Memcached 클라이언트를 구성할 수 있습니다. Auto Discovery를 지원하는 클라이언트를 사용해야 합니다.
Auto Discovery를 사용하지 않으면 읽기 및 쓰기를 위해 개별 노드 엔드포인트를 사용하도록 클라이언트를 구성해야 합니다. 또한 노드를 추가 및 제거할 때 엔드포인트를 추적해야 합니다.
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터에 노드가 하나만 있는 경우 노드의 엔드포인트는 읽기 및 쓰기 모두에 사용됩니다. Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터에 여러 노드가 있는 경우 세 가지 유형의 엔드포인트가 있습니다. 즉, 기본 엔드포인트 , 리더 엔드포인트 및 노드 엔드포인트 입니다.
기본 엔드포인트는 항상 클러스터의 기본 노드로 확인되는 DNS 이름입니다. 기본 엔드포인트는 읽기 전용 복제본을 기본 역할로 승격하는 것과 같은 클러스터 변경의 영향을 받지 않습니다. 쓰기 활동의 경우 애플리케이션을 기본 엔드포인트에 연결하는 것이 좋습니다.
리더 엔드포인트는 ElastiCache (Redis OSS) 클러스터의 모든 읽기 전용 복제본 간에 엔드포인트에 대한 수신 연결을 균등하게 분할합니다. 애플리케이션이 연결을 생성하는 시기 또는 애플리케이션에서 연결을 다시 사용하는 방법과 같은 추가 요소가 트래픽 분산을 결정합니다. 리더 엔드포인트는 복제본이 추가 또는 제거되는 클러스터의 변경 사항을 실시간으로 반영합니다. ElastiCache (Redis OSS) 클러스터의 여러 읽기 전용 복제본을 서로 다른 AWS 가용 영역(AZ)에 배치하여 리더 엔드포인트의 고가용성을 보장할 수 있습니다.
참고
리더 엔드포인트는 로드 밸런서가 아닙니다. 라운드 로빈 방식으로 복제본 노드 중 하나의 IP 주소로 확인되는 DNS 레코드입니다.
읽기 활동의 경우 애플리케이션은 클러스터의 어떤 노드에도 연결할 수 있습니다. 기본 엔드포인트와 달리, 노드 엔드포인트는 특정 엔드포인트로 확인됩니다. 복제본을 추가하거나 삭제하는 것과 같이 클러스터를 변경하면 애플리케이션에서 노드 엔드포인트를 업데이트해야 합니다.
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터의 엔드포인트를 찾으려면
-
에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/elasticache/
에서 ElastiCache 콘솔을 엽니다. -
탐색 창에서 Valkey 클러스터 또는 Redis OSS 클러스터를 선택합니다.
클러스터 화면에 Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 및 Valkey 또는 RedisOSS(클러스터 모드 활성화됨) 클러스터 목록이 표시됩니다.
-
클러스터의 기본 엔드포인트 및/또는 리더 엔드포인트를 찾으려면 클러스터 이름(왼쪽에 있는 버튼 아님)을 선택합니다.
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터의 프라이머리 및 리더 엔드포인트
클러스터에 노드가 하나 뿐이면 기본 엔드포인트가 없으며 다음 단계에서 계속할 수 있습니다.
-
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터에 복제본 노드가 있는 경우 클러스터의 이름을 선택한 다음 노드 탭을 선택하여 클러스터의 복제본 노드 엔드포인트를 찾을 수 있습니다.
노드 화면에 클러스터의 각 노드, 기본 및 복제본이 엔드포인트와 함께 나열됩니다.
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터의 노드 엔드포인트
-
엔드포인트를 클립보드에 복사하려면
-
한 번에 엔드포인트 하나씩, 복사할 엔드포인트를 찾습니다.
-
엔드포인트 바로 앞에 있는 복사 아이콘을 선택합니다.
엔드포인트가 클립보드에 복사됩니다. 엔드포인트를 사용하여 노드에 연결하는 방법에 대한 자세한 내용은 Memcached 노드에 연결 섹션을 참조하세요.
-
Valkery 또는 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 기본 엔드포인트는 다음과 같습니다. 전송 중 데이터 암호화가 활성화되어 있는지 여부에 따라 차이가 있습니다.
전송 중 데이터 암호화가 비활성화된 경우
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 또는 RedisOSS(클러스터 모드 활성화됨) 클러스터에는 단일 구성 엔드포인트가 있습니다. 구성 엔드포인트에 연결되면 애플리케이션이 클러스터의 각 샤드에 대한 기본 및 읽기 엔드포인트를 찾을 수 있습니다.
Valkey 또는 RedisOSS(클러스터 모드 활성화됨) 클러스터의 엔드포인트를 찾으려면
-
에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/elasticache/
에서 ElastiCache 콘솔을 엽니다. -
탐색 창에서 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의 경우 AWS CLI for Amazon ElastiCache 을 사용하여 노드 및 클러스터의 엔드포인트를 검색할 수 있습니다.
Redis의 경우 AWS CLI for Amazon을 사용하여 노드, 클러스터 및 복제 그룹의 엔드포인트를 ElastiCache 검색할 수 있습니다.
노드 및 클러스터의 엔드포인트 찾기(AWS CLI)
AWS CLI 를 사용하여 describe-cache-clusters 명령을 사용하여 클러스터 및 해당 노드의 엔드포인트를 검색할 수 있습니다. 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 에 대한 클러스터 정보를 검색합니다.
중요
파라미터는 단일 노드 Valkey 또는 RedisOSS(클러스터 모드 비활성화됨) 클러스터 ID 또는 복제 그룹의 특정 노드 ID와 함께 사용할 --cache-cluster-id 수 있습니다. --cache-cluster-id 복제 그룹의 는 와 같은 4자리 값입니다0001. --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)
AWS CLI 를 사용하여 describe-replication-groups 명령을 사용하여 복제 그룹 및 해당 클러스터의 엔드포인트를 검색할 수 있습니다. 이 명령은 리더 엔드포인트와 함께, 복제 그룹의 기본 엔드포인트와 복제 그룹에 있는 모든 클러스터(노드)의 목록 및 해당 엔드포인트를 반환합니다.
다음 작업은 복제 그룹 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": {}
}
]
}자세한 내용은 명령 참조describe-replication-groups의 섹션을 참조하세요. AWS CLI
Memcached의 경우 Amazon ElastiCache API을 사용하여 노드 및 클러스터의 엔드포인트를 검색할 수 있습니다.
Redis의 경우 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 작업과 함께 복제 그룹 및 해당 클러스터의 엔드포인트를 검색할 수 있습니다. 이 작업은 리더 엔드포인트와 함께, 복제 그룹의 기본 엔드포인트와 복제 그룹에 있는 모든 클러스터의 목록 및 해당 엔드포인트를 반환합니다.
다음 작업은 복제 그룹 에 대한 기본 엔드포인트(PrimaryEndpoint), 리더 엔드포인트(ReaderEndpoint) 및 개별 노드 엔드포인트(ReadEndpoint)를 검색합니다myreplgroup. 모든 쓰기 작업에 기본 엔드포인트를 사용합니다.
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를 참조하세요.
