Config Connector 시작하기


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

  • Google Cloud API 사용 설정
  • Pub/Sub 주제를 만들고 관리합니다.

시작하기 전에

이 페이지의 연습을 완료하려면 다음 작업을 완료하세요.

  • GKE 부가기능으로 설치의 모든 단계를 완료하여 Config Connector를 설치합니다.

  • 기본 네임스페이스를 사용하도록 Config Connector를 구성합니다.

  • Config Connector는 Resource Manager API를 사용하여 서비스 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 describePubSubTopic 리소스에 대한 API 설명을 볼 수 있습니다.

kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com

또한 구성 커넥터 리소스에서 사용 가능한 리소스에 대한 정보를 볼 수도 있습니다.

Pub/Sub 서비스 사용 설정

Config Connector를 사용하여 클러스터에 YAML 구성을 적용하여 Pub/Sub API를 사용 설정합니다.

  1. 다음 YAML을 enable-pubsub.yaml이라는 파일에 복사합니다.

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: pubsub.googleapis.com
    
  2. kubectl apply를 사용하여 구성을 클러스터에 적용합니다. Pub/Sub API를 사용 설정하려면 다음 명령어를 실행합니다.

    kubectl apply -f enable-pubsub.yaml

Pub/Sub 인스턴스 만들기

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

  apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
  kind: PubSubTopic
  metadata:
    labels:
      LABEL_VALUE
    name: TOPIC_NAME

다음을 바꿉니다.

  • LABEL_VALUE: 라벨의 키-값 쌍입니다. 예를 들면 environment: production입니다.
  • TOPIC_NAME: Pub/Sub 주제 이름

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

kubectl apply 명령어를 사용하여 리소스를 만듭니다. Pub/Sub 주제를 만들려면 다음 명령어를 실행합니다.

kubectl apply -f pubsub-topic.yaml 

리소스 설명

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

예를 들어 모든 Pub/Sub 주제를 보려면 다음 명령어를 실행합니다.

kubectl describe pubsubtopics

이 목록에는 이전 섹션에서 만든 Pub/Sub 주제가 표시됩니다.

리소스가 준비되었는지 확인

Pub/Sub 주제를 만든 후에는 해당 status.condition을 확인할 수 있습니다. 예를 들어 Pub/Sub 주제 리소스가 준비되었는지 확인하려면 다음 명령어를 실행합니다.

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

TOPIC_NAME을 Pub/Sub 주제의 이름으로 바꿉니다.

다음과 비슷한 출력이 표시됩니다.

pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met

리소스 업데이트

YAML 파일을 업데이트하고 kubectl으로 파일을 다시 적용하여 리소스에서 메타데이터를 업데이트할 수 있습니다.

이전 섹션에서 만든 Pub/Sub 주제의 라벨을 변경하려면 다음 단계를 완료하세요.

  1. pubsub-topic.yaml 파일의 metadata 섹션을 수정하여 라벨을 변경합니다.

      apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
      kind: PubSubTopic
      metadata:
        labels:
          NEW_LABEL_VALUE
        name: TOPIC_NAME
    

    다음을 바꿉니다.

    • NEW_LABEL_VALUE: 이전에 추가한 라벨의 업데이트된 값입니다. 예를 들면 environment: staging입니다.
    • TOPIC_NAME: Pub/Sub 주제 이름
  2. 리소스를 업데이트하려면 kubectl apply을 사용합니다. 다음 명령어를 실행합니다.

    kubectl apply -f pubsub-topic.yaml
  3. Pub/Sub 인스턴스에서 이름이 변경되었는지 확인합니다.

    kubectl describe pubsubtopics

    주제에는 새 라벨이 있어야 합니다.

리소스 삭제

자원을 삭제하려면 kubectl delete를 사용하세요. 예를 들어 앞에서 만든 PubSubTopic를 삭제하려면 pubsub-topic.yaml 파일을 사용하여 kubectl delete를 실행합니다.

kubectl delete -f pubsub-topic.yaml

리소스가 삭제되었다는 확인이 표시됩니다.

pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted

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

다음 단계