Memorystore for Valkey 인스턴스에 연결

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

고객 지원

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

리전 간 액세스

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

클러스터 모드 지원 인스턴스에 연결

이 섹션에서는 Memorystore for Valkey 클러스터 모드 지원 인스턴스에 연결하는 방법을 설명합니다.

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

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

gcloud

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

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

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
       connectionType: CONNECTION_TYPE_DISCOVERY
       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
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606778'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa
    - pscAutoConnection:
       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
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606779'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa-2
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

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

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

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

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

  1. Memorystore for Valkey 인스턴스에 승인된 네트워크를 사용하는 Linux Compute Engine VM이 아직 없으면 VM을 만들고 빠른 시작: Linux VM 만들기를 따라 연결합니다.

  2. Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli를 설치합니다.

  3. 인스턴스의 검색 엔드포인트를 보고 기록해 둡니다.

  4. 다음 명령어를 실행하여 인스턴스의 검색 엔드포인트에 연결합니다.

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    각 항목의 의미는 다음과 같습니다.

    • DISCOVERY_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  5. CLUSTER SHARDS 명령어를 실행하여 노드 토폴로지를 확인합니다. 노드의 IP 주소와 포트 번호 중 하나를 기록해 둡니다.

  6. 다음 명령어를 실행하여 원하는 노드에 연결합니다.

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    다음을 바꿉니다.

    • NODE_IP_ADDRESS는 이전 단계에서 찾은 노드의 IP 주소입니다.
    • NODE_PORT은 이전 단계에서 찾은 노드의 포트 번호입니다.

  7. 노드에 연결되면 Valkey 명령어를 몇 가지 입력합니다.

    입력:

    PING

    결과:

    PONG

    입력

    SET HELLO WORLD

    결과:

    OK

    다음을 입력합니다.

    GET HELLO

    결과:

    "WORLD"

  8. Valkey 노드에 대한 연결 테스트를 완료한 후 Valkey 인스턴스에 연결하는 데 사용한 Compute Engine VM을 삭제하는 것을 고려해야 합니다. 이렇게 하면 Cloud Billing 계정에 비용이 청구되지 않습니다.

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

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

  1. 이전 단계의 Valkey 인스턴스와 동일한 승인된 네트워크를 사용하는 Compute Engine VM이 아직 없으면 Linux VM을 사용한 빠른 시작에 따라 VM을 만들고 연결합니다.

    1. Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli 버전 6.0 이상을 설치합니다.

  2. 클라이언트에 인증 기관 설치의 안내에 따라 Linux VM에 인스턴스의 인증 기관을 설치합니다.

  3. 인스턴스의 검색 엔드포인트를 보고 기록해 둡니다.

  4. 다음 명령어를 실행하여 인스턴스의 검색 엔드포인트에 연결합니다.

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem

    각 항목의 의미는 다음과 같습니다.

    • DISCOVERY_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  5. CLUSTER SHARDS 명령어를 실행하여 노드 토폴로지를 확인합니다. 노드의 IP 주소와 포트 번호 중 하나를 기록해 둡니다.

  6. 다음 명령어를 실행하여 원하는 노드에 연결합니다.

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem

    다음을 바꿉니다.

    • NODE_IP_ADDRESS는 이전 단계에서 찾은 노드의 IP 주소입니다.
    • NODE_PORT은 이전 단계에서 찾은 노드의 포트 번호입니다.

  7. 노드에 연결한 후 다음 Valkey 명령어를 입력합니다.

    다음을 입력합니다.

    PING

    결과:

    PONG

클러스터 모드 사용 중지 인스턴스에 연결

이 섹션에서는 Memorystore for Valkey 클러스터 모드 사용 중지 인스턴스에 연결하는 방법을 설명합니다.

인스턴스의 기본 및 리더 엔드포인트 보기

인스턴스의 기본 및 리더 엔드포인트를 보려면 다음 안내를 따르세요.

gcloud

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

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

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_PRIMARY
      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.124
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606778'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_READER
      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.125
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606779'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa-2
replicaCount: 2
shardCount: 1
mode: CLUSTER_DISABLED
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

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

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

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

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

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

  1. Memorystore for Valkey 인스턴스에 승인된 네트워크를 사용하는 Linux Compute Engine VM이 아직 없으면 VM을 만들고 빠른 시작: Linux VM 만들기를 따라 연결합니다.

  2. Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli를 설치합니다.

  3. 인스턴스의 기본 및 리더 엔드포인트를 보고 기록해 둡니다.

  4. 다음 명령어를 실행하여 인스턴스의 기본 엔드포인트에 연결합니다.

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    각 항목의 의미는 다음과 같습니다.

    • PRIMARY_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  5. 기본 노드에 연결한 후 다음 Valkey 명령어를 입력합니다.

    다음을 입력합니다.

    PING

    결과:

    PONG

    입력

    SET HELLO WORLD

    결과:

    OK

    다음을 입력합니다.

    GET HELLO

    결과:

    "WORLD"

  6. 다음 명령어를 실행하여 인스턴스의 리더 엔드포인트에 연결합니다.

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    각 항목의 의미는 다음과 같습니다.

    • READER_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  7. 기본 노드에 연결한 후 다음 Valkey Get 명령어를 입력합니다.

    다음을 입력합니다.

    PING

    결과:

    PONG

    다음을 입력합니다.

    GET HELLO

    결과:

    "WORLD"

  8. Valkey 노드에 대한 연결을 테스트한 후 Valkey 인스턴스에 연결하는 데 사용한 Compute Engine VM을 삭제해야 합니다. 이렇게 하면 Cloud Billing 계정에 비용이 청구되지 않습니다.

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

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

  1. 이전 단계의 Valkey 인스턴스와 동일한 승인된 네트워크를 사용하는 Compute Engine VM이 아직 없으면 Linux VM을 사용한 빠른 시작에 따라 VM을 만들고 연결합니다.

    1. Valkey 설치의 안내에 따라 Compute Engine VM에 valkey-cli 버전 6.0 이상을 설치합니다.

  2. 클라이언트에 인증 기관 설치의 안내에 따라 Linux VM에 인스턴스의 인증 기관을 설치합니다.

  3. 인스턴스의 기본 및 리더 엔드포인트를 보고 기록해 둡니다.

  4. 다음 명령어를 실행하여 인스턴스의 기본 엔드포인트에 연결합니다.

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    각 항목의 의미는 다음과 같습니다.

    • PRIMARY_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  5. 다음 명령어를 실행하여 인스턴스의 리더 엔드포인트에 연결합니다.

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    각 항목의 의미는 다음과 같습니다.

    • READER_ENDPOINT_ADDRESS 및 PORT_NUMBER은 이전 단계에서 기록한 값입니다.

  6. 노드에 연결되면 Valkey 명령어를 몇 가지 입력합니다.

    입력:

    PING

    결과:

    PONG