인스턴스 구성

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

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

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

시작하기 전에

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

구성 파라미터 보기

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

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

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

예:

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

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

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

gcloud memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--mode=MODE
--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는 인스턴스의 샤드 수를 결정합니다. 샤드 개수는 인스턴스 데이터를 저장하기 위한 총 메모리 용량을 결정합니다. 선택한 모드가 클러스터 모드 사용 중지인 경우 인스턴스에 샤드를 하나만 지정할 수 있습니다. 자세한 내용은 인스턴스 및 노드 사양을 참고하세요.

  • mode은 인스턴스가 클러스터 모드 사용 설정인지 클러스터 모드 사용 중지인지 확인합니다. 이 필드를 생략하면 인스턴스가 기본적으로 클러스터 모드 사용 설정으로 설정됩니다. 자세한 내용은 클러스터 모드 사용 설정 및 사용 중지를 참고하세요.

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

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

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

클러스터 모드 사용 설정 예

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

클러스터 모드 사용 중지됨 예시

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

구성 파라미터 업데이트

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

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

예:

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

구성 파라미터 재설정

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

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

예:

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

구성 파라미터 지우기

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

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

예:

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