Config Connector 시작하기

이 가이드에서는 다음 방법을 설명하여 Config Connector 리소스 관리의 기본을 보여줍니다.

  • Google Cloud API 사용 설정
  • Cloud Spanner 인스턴스 만들기 및 관리

시작하기 전에

이 페이지의 단계를 완료하려면 다음 안내를 따르세요.

  • Config Connector를 설치합니다.

  • 기본 프로젝트를 사용하도록 Config Connector를 구성합니다.

  • Config Connector는 Resource Manager API를 사용하여 서비스를 사용 설정합니다. 이 단계를 수행하려면 Resource Manager API를 사용 설정해야 합니다. 다음 gcloud 명령어를 사용하여 이 API를 사용 설정할 수 있습니다.

    gcloud services enable cloudresourcemanager.googleapis.com
    

사용 가능한 Google Cloud 리소스 탐색

Config Connector에서 사용 가능한 Google Cloud 리소스를 보려면 다음을 실행하세요.

kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true

결과는 Config Connector 버전에서 관리할 수 있는 모든 리소스의 목록입니다.

예를 들어 kubectl describe을 사용하여 SpannerInstance 리소스에 대한 API 설명을 볼 수 있습니다.

kubectl describe crd spannerinstances.spanner.cnrm.cloud.google.com

Cloud Spanner 서비스 사용 설정

Config Connector를 사용하여 클러스터에 YAML 구성을 적용해서 Cloud Spanner API를 사용 설정할 수 있습니다.

  1. 다음 YAML을 enable-spanner.yaml 파일에 복사합니다.

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: spanner.googleapis.com
    
  2. kubectl apply 명령어를 사용하여 클러스터에 매니페스트를 추가합니다. Cloud Spanner API를 사용 설정하려면 다음 명령어를 실행합니다.

    kubectl --namespace [CC_NAMESPACE] apply -f enable-spanner.yaml

    [CC_NAMESPACE]를 Config Connector가 관리하는 리소스의 네임스페이스로 바꿉니다.

Cloud Spanner 인스턴스 만들기

다음 콘텐츠로 spanner-instance.yaml이라는 파일을 만듭니다.

apiVersion: spanner.cnrm.cloud.google.com/v1beta1
kind: SpannerInstance
metadata:
  annotations:
    cnrm.cloud.google.com/project-id: [PROJECT_ID]
  labels:
    label-one: "value-one"
  name: spannerinstance-sample
spec:
  config: regional-us-west1
  displayName: Spanner Instance Sample
  numNodes: 1

[PROJECT_ID]를 프로젝트 ID로 바꿉니다.

Config Connector 리소스를 만들면 연관된 Google Cloud 리소스가 생성됩니다. Config Connector가 이 리소스를 관리합니다. 동일한 이름의 Google Cloud 리소스가 이미 존재하는 경우 Config Connector가 리소스를 가져와서 관리합니다. 기존 리소스 가져오기에 대해 자세히 알아보려면 리소스 관리 및 삭제를 참조하세요.

kubectl apply 명령어를 사용하여 리소스를 만듭니다. Cloud Spanner 인스턴스를 만들려면 다음 명령어를 복사합니다.

kubectl apply -f spanner-instance.yaml

[PROJECT_ID]를 프로젝트 ID로 바꿉니다.

리소스 설명

리소스에 대한 세부정보를 보려면 kubectl describe을 사용하세요.

예를 들어 Cloud Spanner 인스턴스를 보려면 다음 명령어를 실행합니다.

kubectl describe spannerinstance spannerinstance-sample

리소스 업데이트

YAML 파일을 업데이트하고 kubectl으로 파일을 다시 적용하여 리소스에서 메타데이터를 업데이트할 수 있습니다. 이전에 생성한 Spanner 인스턴스에서 메타데이터를 업데이트하려면 다음 안내를 따르세요.

  1. spec.displayName을 'Spanner Instance Sample'에서 'My Spanner Instance'로 변경하려면 spanner-instance.yaml 파일을 수정합니다.

    apiVersion: spanner.cnrm.cloud.google.com/v1beta1
    kind: SpannerInstance
    metadata:
      annotations:
        cnrm.cloud.google.com/project-id: [PROJECT_ID]
      labels:
        label-one: "value-one"
      name: spannerinstance-sample
    spec:
      config: regional-us-west1
      displayName: My Spanner Instance
      numNodes: 1
    

    [PROJECT_ID]를 프로젝트 ID로 바꿉니다.

  2. 리소스를 업데이트하려면 kubectl apply을 사용합니다. 다음 명령어를 실행합니다.

    kubectl apply -f spanner-instance.yaml
  3. Cloud Spanner 인스턴스에서 이름 변경을 확인합니다.

    kubectl describe spannerinstance spannerinstance-sample

    설명에 새 이름 My Spanner Instance가 포함됩니다.

리소스 삭제

자원을 삭제하려면 kubectl delete를 사용하세요. 예를 들어, SpannerInstance을 삭제하려면 다음 명령어를 실행합니다.

kubectl delete -f spanner-instance.yaml

기본적으로 Config Connector는 SpannerInstance 리소스를 삭제합니다. 이 리소스를 유지하려면 리소스 관리 및 삭제의 안내를 참조하세요.

다음 단계