인스턴스 구성

Memorystore for Valkey는 사용자가 수정 가능한 OSS Valkey 구성 파라미터의 하위 집합을 지원하여 인스턴스의 동작을 맞춤설정할 수 있습니다.

구성 변경 시 인스턴스를 다시 시작할 필요가 없으며 인스턴스가 다시 시작되는 경우 저장됩니다. 인스턴스를 만든 후 수정 가능한 구성 파라미터를 업데이트할 수 있습니다.

수정 가능한 구성 파라미터에 대한 자세한 내용은 지원되는 인스턴스 구성을 참조하세요.

시작하기 전에

gcloud components update를 실행하여 최신 버전의 Google Cloud CLI가 설치되었는지 확인합니다.

구성 파라미터 보기

Google Cloud CLI를 사용하여 구성 파라미터를 보려면 variables를 적절한 값으로 바꿔서 gcloud beta memorystore instances describe 명령어를 실행합니다.

기본값에서 구성 파라미터를 변경하지 않으면 gcloud beta memorystore instances describe 명령어를 실행할 때 구성 파라미터를 볼 수 없습니다.

gcloud beta memorystore instances describe instance-id --location=region-id

예를 들면 다음과 같습니다.

gcloud beta memorystore instances describe my-instance --location=us-central1

인스턴스 생성 중 구성 파라미터 설정

인스턴스를 만드는 동안 구성 파라미터를 설정하려면 --engine-configs 플래그를 사용하고 variables를 적절한 값으로 바꿔 gcloud beta memorystore instances create 명령어를 실행합니다.

gcloud beta memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--engine-configs=config-name=config-value \

다음을 바꿉니다.

  • instance-id는 만들려는 Memorystore for Valkey 인스턴스의 ID입니다.
  • region-id: 인스턴스를 배치할 리전
  • project-id는 프로젝트 ID입니다.

  • node-type은 선택한 노드 유형입니다. 허용되는 값은 다음과 같습니다.

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    노드 유형 및 인스턴스 구성에 대한 자세한 내용은 인스턴스 및 노드 사양을 참조하세요.

  • shard-count는 인스턴스의 샤드 수를 결정합니다. 샤드 개수는 인스턴스 데이터를 저장하기 위한 총 메모리 용량을 결정합니다. 인스턴스 사양에 대한 자세한 내용은 인스턴스 및 노드 사양을 참조하세요.

  • config-name은 수정할 구성 파라미터입니다.

  • config-value는 구성하는 파라미터에 해당하는 선택한 설정입니다.

예를 들면 다음과 같습니다.

gcloud beta memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru

구성 파라미터 업데이트

기존 인스턴스의 구성 파라미터를 업데이트하려면 --update-engine-configs 플래그를 사용하고 variables를 적절한 값으로 바꿔 gcloud beta memorystore instances update 명령어를 실행합니다.

gcloud beta memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--update-engine-configs=config-name=config-value

예를 들면 다음과 같습니다.

gcloud beta memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru

구성 파라미터 재설정

구성 파라미터를 기본값으로 재설정하려면 --remove-engine-configs 플래그를 사용하고 variables를 적절한 값으로 바꿔 gcloud beta memorystore instances update 명령어를 실행합니다.

gcloud beta memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--remove-engine-configs=config-name

예를 들면 다음과 같습니다.

gcloud beta memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy

구성 파라미터 지우기

모든 구성 파라미터를 기본값으로 지우려면 --clear-engine-configs 플래그를 사용하고 variables를 적절한 값으로 바꿔 gcloud beta memorystore instances update 명령어를 실행합니다.

gcloud beta memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--clear-engine-configs

예를 들면 다음과 같습니다.

gcloud beta memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs