Memorystore for Valkey 인스턴스에 연결

이 페이지에서는 Memorystore for Valkey 인스턴스에 연결하는 방법을 설명합니다.

고객 지원

사용할 연결 클라이언트에 관한 예시와 안내는 클라이언트 라이브러리 코드 샘플을 참조하세요 .

리전 간 액세스

인스턴스가 있는 리전과 다른 리전에 있는 클라이언트에서 Memorystore for Valkey 인스턴스에 액세스할 수 있습니다.

인스턴스의 검색 엔드포인트 보기

인스턴스의 검색 엔드포인트를 보려면 다음 안내를 따르세요.

gcloud

인스턴스의 검색 엔드포인트를 보려면 인스턴스 정보 보기에 설명된 대로 describe gcloud CLI를 실행합니다.

출력은 다음과 비슷하게 표시됩니다.

--location=us-central1 \
authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
discoveryEndpoints:
- address: 10.128.0.58
  network: projects/my-project/global/networks/default
  port: 6379
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
pscAutoConnections:
- forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
  ipAddress: 10.128.0.58
  network: projects/my-project/global/networks/default
  projectId: my-project
  pscConnectionId: '38876592440606778'
- forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
  ipAddress: 10.128.0.59
  network: projects/my-project/global/networks/default
  projectId: my-project
  pscConnectionId: '38876592440606779'
replicaCount: 2
shardCount: 5
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

discovery_endpoints: 섹션에 나열된 엔드포인트 주소와 포트 번호를 기록해 둡니다. 이 두 값을 함께 사용하면 인스턴스의 검색 엔드포인트가 됩니다.

valkey-cli를 사용하여 Compute Engine VM에서 연결

Memorystore 인스턴스의 승인된 네트워크를 사용하는 모든 Compute Engine VM에서 Memorystore for Valkey 클러스터 인스턴스에 연결할 수 있습니다.

인스턴스에 연결하려면 다음 안내를 따르세요.

Memorystore for Valkey 인스턴스에 승인된 네트워크를 사용하는 Linux Compute Engine VM이 아직 없으면 VM을 만들고 빠른 시작: Linux VM 만들기를 따라 연결합니다.
Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli를 설치합니다.
인스턴스의 검색 엔드포인트를 보고 기록해 둡니다.
다음 명령어를 실행하여 인스턴스의 검색 엔드포인트에 연결합니다.
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
각 항목의 의미는 다음과 같습니다.
- DISCOVERY_ENDPOINT_ADDRESS 및 PORT_NUMBER는 이전 단계에서 기록한 값입니다.
참고: -c 스위치는 valkey-cli 클러스터 지원 모드를 사용 설정하는 데 사용됩니다. -c 스위치가 제공되지 않으면 연결된 샤드와 다른 샤드의 키에 액세스하려고 하면 MOVED 오류가 발생합니다. 클러스터 지원 모드에서 클라이언트는 오류 응답에서 반환된 주소에 자동으로 다시 연결됩니다.
CLUSTER SHARDS 명령어를 실행하여 노드 토폴로지를 확인합니다. 노드의 IP 주소와 포트 번호 중 하나를 기록해 둡니다.
다음 명령어를 실행하여 원하는 노드에 연결합니다.
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
다음을 바꿉니다.
- NODE_IP_ADDRESS는 이전 단계에서 찾은 노드의 IP 주소입니다.
- NODE_PORT는 이전 단계에서 찾은 노드의 포트 번호입니다.
노드에 연결되면 몇 가지 Valkey 명령어를 입력합니다.

입력:
```
PING
```
결과:
```
PONG
```
입력
```
SET HELLO WORLD
```
결과:
```
OK
```
입력:
```
GET HELLO
```
결과:
```
"WORLD"
```
Valkey 노드에 대한 연결 테스트를 완료한 후 Valkey 인스턴스에 연결하는 데 사용한 Compute Engine VM을 삭제하는 것을 고려해야 합니다. 이렇게 하면 Cloud Billing 계정에 비용이 청구되지 않습니다.

전송 중인 데이터 암호화가 사용 설정된 인스턴스에 연결

이 섹션에서는 전송 중인 데이터 암호화가 사용 설정된 Memorystore for Valkey 인스턴스에 연결하는 방법의 예시를 제공합니다.

이전 단계의 Valkey 인스턴스와 동일한 승인된 네트워크를 사용하는 Compute Engine VM이 아직 없으면 Linux VM을 사용한 빠른 시작에 따라 VM을 만들고 연결합니다.
1. Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli 버전 6.0 이상을 설치합니다.
클라이언트에 인증 기관 설치의 안내에 따라 Linux VM에 인스턴스의 인증 기관을 설치합니다.
인스턴스의 검색 엔드포인트를 보고 기록해 둡니다.
다음 명령어를 실행하여 인스턴스의 검색 엔드포인트에 연결합니다.
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
각 항목의 의미는 다음과 같습니다.
- DISCOVERY_ENDPOINT_ADDRESS 및 PORT_NUMBER는 이전 단계에서 기록한 값입니다.
참고: -c 스위치는 valkey-cli 클러스터 지원 모드를 사용 설정하는 데 사용됩니다. -c 스위치가 제공되지 않으면 연결된 샤드와 다른 샤드의 키에 액세스하려고 하면 MOVED 오류가 발생합니다. 클러스터 지원 모드에서 클라이언트는 오류 응답에서 반환된 주소에 자동으로 다시 연결됩니다.
CLUSTER SHARDS 명령어를 실행하여 노드 토폴로지를 확인합니다. 노드의 IP 주소와 포트 번호 중 하나를 기록해 둡니다.
다음 명령어를 실행하여 원하는 노드에 연결합니다.
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
다음을 바꿉니다.
- NODE_IP_ADDRESS는 이전 단계에서 찾은 노드의 IP 주소입니다.
- NODE_PORT는 이전 단계에서 찾은 노드의 포트 번호입니다.
노드에 연결되면 몇 가지 Valkey 명령어를 입력합니다.

입력:
```
PING
```
결과:
```
PONG
```