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

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

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

API 사용 설정

서비스 연결 정책을 구성하고, 공유 VPC를 구성하고, Redis용 Memorystore 클러스터 인스턴스를 만드는 데 필요한 다음 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 redis.googleapis.com
    

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

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

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

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

서비스 연결 정책 만들기

그런 다음 공유 VPC 네트워크의 호스트 프로젝트, 리전, Redis용 Memorystore 클러스터 인스턴스를 프로비저닝할 서브넷에 대한 서비스 연결 정책을 만듭니다. 일반적으로 네트워크 관리자가 이 작업을 수행합니다. 하지만 명령어를 실행하는 데 필요한 필수 역할이 할당된 경우에도 이 작업을 수행할 수 있습니다.

이 빠른 시작에서는 default 네트워크와 default 서브넷을 사용합니다.

gcloud

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

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

    다음을 바꿉니다.

    • POLICY_NAME은 원하는 정책 이름입니다.
    • HOST_PROJECT_ID은 호스트 프로젝트 ID입니다.
    • REGION는 Redis용 Memorystore 클러스터 인스턴스를 프로비저닝하려는 리전과 동일합니다.
  2. 정책이 성공적으로 생성되었는지 확인하려면 list 명령어를 실행합니다.

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

    다음을 바꿉니다.

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

인스턴스 만들기

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

gcloud

gcloud redis clusters create INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--network=projects/HOST_PROJECT_ID/global/networks/default

다음을 바꿉니다.

  • INSTANCE_ID는 인스턴스 ID입니다.
  • SERVICE_PROJECT_ID는 서비스 프로젝트 ID입니다.
  • REGION은 인스턴스를 프로비저닝하려는 리전입니다.

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

    • redis-shared-core-nano
    • redis-standard-small
    • redis-highmem-medium
    • redis-highmem-xlarge
  • SHARD_COUNT는 인스턴스의 샤드 수를 결정합니다. 샤드 개수는 클러스터 데이터를 저장하기 위한 총 메모리 용량을 결정합니다. 클러스터 사양에 대한 자세한 내용은 클러스터 및 노드 사양을 참고하세요.

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

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

인스턴스 설명

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

gcloud

gcloud redis clusters describe INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

다음을 바꿉니다.

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

인스턴스 삭제

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

gcloud

gcloud redis clusters delete INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

다음을 바꿉니다.

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