인스턴스 구성

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

구성 변경 시 인스턴스를 다시 시작할 필요가 없으며 서비스가 중단되지 않습니다. Memorystore for Valkey는 변경사항을 즉시 저장합니다. 인스턴스가 다시 시작되면 인스턴스가 구성 변경사항을 유지합니다. 인스턴스를 만든 후 수정 가능한 구성 파라미터를 업데이트할 수 있습니다. 자세한 내용은 지원되는 인스턴스 구성을 참조하세요.

시작하기 전에

최신 버전의 Google Cloud CLI를 설치해야 합니다. 기존 설치를 업데이트하려면 gcloud components update 명령어를 사용합니다.

구성 파라미터 보기

구성 파라미터를 보려면 gcloud memorystore instances describe 명령어를 사용합니다.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

다음을 바꿉니다.

  • INSTANCE_ID: 인스턴스의 ID
  • REGION_ID: 인스턴스가 있는 리전

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

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

구성 파라미터를 기본값에서 변경하지 않으면 파라미터가 출력에 표시되지 않습니다.

인스턴스를 만들 때 구성 파라미터 설정

인스턴스를 만들 때 구성 파라미터를 설정하려면
gcloud memorystore instances create 명령어를 --engine-configs 플래그와 함께 사용합니다.

gcloud memorystore instances create INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--node-type=NODE_TYPE \
--mode=MODE \
--shard-count=SHARD_COUNT \
--engine-configs=CONFIG_NAME=CONFIG_VALUE

다음을 바꿉니다.

  • INSTANCE_ID: 만들려는 인스턴스의 ID입니다.
  • REGION_ID: 인스턴스를 배치할 리전입니다.
  • PROJECT_ID: 프로젝트 ID입니다.

  • NODE_TYPE: 인스턴스의 노드 유형입니다.

  • MODE: 클러스터 모드 사용 설정 또는 클러스터 모드 사용 중지 인스턴스를 만드는지 여부입니다. 이 필드를 생략하면 기본적으로 Memorystore for Valkey는 클러스터 모드 사용 설정 인스턴스를 만듭니다. 자세한 내용은 클러스터 모드 사용 설정 및 사용 중지를 참조하세요.

  • SHARD_COUNT: 인스턴스의 샤드 수입니다. 샤드 개수는 인스턴스 데이터를 저장하는 데 사용되는 총 메모리 용량을 결정합니다.

    선택한 모드가 클러스터 모드 사용 중지인 경우 인스턴스에 샤드를 하나만 지정할 수 있습니다. 자세한 내용은 인스턴스 및 노드 사양을 참조하세요.

  • CONFIG_NAME: 설정하려는 구성 파라미터의 이름입니다.

  • CONFIG_VALUE: 설정 중인 파라미터의 값입니다.

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

클러스터 모드 사용 설정 예시

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

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

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

구성 파라미터 업데이트

기존 인스턴스의 구성 파라미터를 업데이트하려면
gcloud memorystore instances update 명령어를 --update-engine-configs 플래그와 함께 사용합니다.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--update-engine-configs=CONFIG_NAME=CONFIG_VALUE

다음을 바꿉니다.

  • INSTANCE_ID: 인스턴스의 ID
  • REGION_ID: 인스턴스가 있는 리전
  • PROJECT_ID: 프로젝트 ID입니다.
  • CONFIG_NAME: 업데이트하려는 구성 파라미터의 이름입니다.
  • CONFIG_VALUE: 파라미터의 새 값입니다.

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

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru

업데이트할 수 있는 구성 파라미터에 대한 자세한 내용은 수정 가능한 구성 파라미터를 참조하세요.

구성 파라미터 재설정

구성 파라미터를 기본값으로 재설정하려면
gcloud memorystore instances update 명령어를 --remove-engine-configs 플래그와 함께 사용합니다.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--remove-engine-configs=CONFIG_NAME

다음을 바꿉니다.

  • INSTANCE_ID: 인스턴스의 ID
  • REGION_ID: 인스턴스가 있는 리전
  • PROJECT_ID: 프로젝트 ID입니다.
  • CONFIG_NAME: 기본값으로 재설정하려는 구성 파라미터의 이름입니다.

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

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy

모든 구성 파라미터 재설정

모든 구성 파라미터를 기본값으로 재설정하려면
gcloud memorystore instances update 명령어를 --clear-engine-configs 플래그와 함께 사용합니다.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--clear-engine-configs

다음을 바꿉니다.

  • INSTANCE_ID: 인스턴스의 ID
  • REGION_ID: 인스턴스가 있는 리전
  • PROJECT_ID: 프로젝트 ID입니다.

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

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs