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

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

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

API 사용 설정

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

서비스 연결 정책 만들기

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

이 빠른 시작에서는 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은 Memorystore for Redis 클러스터 인스턴스를 프로비저닝하려는 리전과 동일한 리전입니다.

  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은 노드 유형으로, 클러스터에 사용하려는 것입니다.

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

  • REPLICA_COUNT는 (샤드당) 읽기 복제본 수입니다. 허용되는 값은 0~5입니다.

  • 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: 인스턴스가 위치한 리전