공유 VPC 네트워크에서 인스턴스 프로비저닝

이 페이지에는 기본 요건을 설정하고, 서비스 프로젝트에서 인스턴스를 프로비저닝하고, 인스턴스를 설명하고, 인스턴스를 삭제하는 데 필요한 gcloud CLI 명령어가 나와 있습니다. 이러한 작업을 수행하려면 이 페이지의 각 섹션에 있는 안내를 따라야 합니다.

이러한 작업에 대한 자세한 안내는 다음 페이지를 참조하세요.

API 사용 설정

서비스 연결 정책 구성, 공유 VPC 구성, Memorystore for Valkey 인스턴스 만들기에 필요한 다음 API를 사용 설정합니다.

gcloud

  1. 서비스 프로젝트에서 다음 API를 사용 설정합니다.

    gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com

    SERVICE_PROJECT_ID를 서비스 프로젝트 ID로 바꿉니다.

  2. 호스트 프로젝트에서 다음 API를 사용 설정합니다.

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    HOST_PROJECT_ID를 호스트 프로젝트 ID로 바꿉니다.

서비스 연결 정책 만들기

그런 다음 정책이 정의된 공유 VPC의 호스트 프로젝트, 네트워크, 리전, Memorystore for Valkey 인스턴스를 프로비저닝할 서브넷에 대한 서비스 연결 정책을 만들어야 합니다. 일반적으로 이 작업은 네트워크 관리자가 수행하거나 필수 역할이 있다면 명령어를 실행하는 데 필요한 권한을 가질 수 있습니다.

이 빠른 시작에서는 default 네트워크와 default 서브넷을 사용합니다. 인스턴스의 IP 주소는 해당 리전의 이 기본 서브넷에 할당됩니다.

gcloud

  1. 서비스 연결 정책을 만들려면 create 명령어를 실행합니다.

    gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=HOST_PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default

    다음을 바꿉니다.

    • POLICY_NAME은 원하는 정책 이름입니다.
    • HOST_PROJECT_ID는 호스트 프로젝트 ID입니다.
    • REGION은 Memorystore for Valkey 인스턴스를 프로비저닝하려는 리전과 동일합니다.

  2. 정책이 성공적으로 생성되었는지 확인하려면 list 명령어를 실행합니다.

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    다음을 바꿉니다.

    • HOST_PROJECT_ID는 호스트 프로젝트 ID입니다.
    • REGION은 서비스 연결 정책이 정의된 리전입니다.

인스턴스 만들기

공유 VPC에 연결된 서비스 프로젝트에서 인스턴스를 만들려면 다음 명령어를 실행합니다.

gcloud

gcloud beta memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=SERVICE_PROJECT_ID

다음을 바꿉니다.

  • INSTANCE는 인스턴스 ID입니다.
  • SERVICE_PROJECT_ID는 서비스 프로젝트 ID입니다.

  • REGION은 인스턴스를 프로비저닝하려는 리전입니다.

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

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

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

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

  • REPLICA_COUNT는 원하는 (샤드당) 읽기 복제본 수입니다. 허용되는 값은 0, 1, 2입니다.

  • HOST_PROJECT_ID는 호스트 프로젝트 ID입니다.

인스턴스 설명

인스턴스 세부정보를 보려면 다음 명령어를 실행합니다.

gcloud

gcloud beta memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

다음을 바꿉니다.

  • INSTANCE는 인스턴스 ID입니다.
  • SERVICE_PROJECT_ID는 서비스 프로젝트 ID입니다.
  • REGION: 인스턴스가 위치한 리전

인스턴스 삭제

인스턴스를 삭제하려면 다음 명령어를 실행합니다.

gcloud

gcloud beta memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

다음을 바꿉니다.

  • INSTANCE는 인스턴스 ID입니다.
  • SERVICE_PROJECT_ID는 서비스 프로젝트 ID입니다.
  • REGION: 인스턴스가 위치한 리전