GCP Workload Identity 인증은 베타 단계입니다.
시작하기 전에
다음 사항이 필요합니다.- GCP에서 실행되는 ClickHouse Cloud 서비스가 있어야 합니다. 해당 서비스의 ClickPipes 배포도 GCP에서 실행되어야 합니다.
- 해당 서비스의 ClickPipes를 관리할 수 있는 권한(permission)이 있는 ClickHouse Cloud API 키가 있어야 합니다.
- Google Cloud 소스 리소스에 IAM 역할을 부여할 수 있는 권한이 있어야 합니다.
- Terraform을 사용하는 경우
clickhouse_clickpipes_service_context데이터 소스가 포함된 ClickHouse provider 릴리스가 필요합니다. 버전을 선택하기 전에 provider 변경 로그를 확인하십시오.
작동 방식
- ClickPipes가 ClickHouse Cloud 서비스용 Google 서비스 계정을 생성하고 관리합니다.
- ClickPipes 서비스 컨텍스트에서 해당 서비스 계정을 조회합니다.
- 서비스 계정에 Google Cloud 소스 리소스에 대한 액세스 권한을 부여합니다.
- ClickPipes는 Workload Identity를 사용해 서비스 계정의 단기 자격 증명을 발급받아 소스에 액세스합니다.
ClickPipes 서비스 계정 조회
OpenAPI 또는 Terraform을 사용하여 서비스 컨텍스트를 조회하십시오. 컨텍스트에서 Workload Identity가 지원되고 준비된 상태로 표시되기 전에는 ClickPipe를 생성하지 마십시오.- OpenAPI
- Terraform
API 인증 정보와 리소스 ID를 설정하세요:서비스 컨텍스트를 조회합니다:아이덴티티가 준비되면 응답의 ClickHouse 서비스에서 ClickPipes를 사용한 적이 없다면 처음에는 응답에
principal에 관리형 서비스 계정이 포함됩니다:principal 없이 ready: false가 반환될 수 있습니다. ready가 true가 되고 principal 값이 채워질 때까지 다시 시도하십시오.전체 응답 스키마(schema)는 서비스 컨텍스트 API 참조를 참고하십시오.소스에 대한 액세스 권한 부여
serviceAccount:<principal>을 IAM 멤버로 사용하십시오. 여기서 <principal>은 서비스 컨텍스트에서 반환된 이메일입니다. 각 소스의 권한 섹션에 설명된 대로, 해당 소스에 필요한 역할만 부여하십시오.
- BigQuery
- Cloud SQL for Postgres
- Cloud SQL for MySQL
- Google Managed Service for Apache Kafka
- Google Cloud Storage
- Google Cloud Pub/Sub
depends_on을 사용하여 이 순서가 보장되도록 하십시오.
ClickPipe 생성
소스의 인증 메서드를SERVICE_ACCOUNT_WORKLOAD_IDENTITY로 설정하십시오. Workload Identity를 사용할 때는 서비스 계정 키, 액세스 키, 연결 문자열(Connection String) 또는 IAM role을 함께 구성하지 마십시오.
소스별 프로그래밍 방식 예시는 다음을 참조하십시오.
- Terraform을 사용한 Google Managed Kafka
- Terraform을 사용한 Google Cloud Storage
- Terraform을 사용한 Google Cloud Pub/Sub
- Terraform을 사용한 BigQuery
- OpenAPI 예시
문제 해결
Workload Identity가 지원되지 않음
Workload Identity가 지원되지 않음
ClickHouse Cloud 서비스와 해당 서비스의 ClickPipes 배포가 모두 GCP에서 실행되고 있는지 확인하십시오. 서비스가 이러한 요구 사항을 충족하는데도
supported가 false이면 ClickHouse 지원팀에 문의하십시오.아이덴티티가 준비되지 않음
아이덴티티가 준비되지 않음
아이덴티티 프로비저닝이 아직 진행 중일 수 있습니다. 서비스 컨텍스트 요청을 재시도하거나, Terraform을 사용하는 경우
ready_timeout 값을 늘리십시오. ready가 true가 되고 principal 값이 채워질 때까지 ClickPipe를 생성하지 마십시오.소스가 액세스를 거부함
소스가 액세스를 거부함
IAM 멤버가 서비스 컨텍스트에 표시된 주체를 그대로 사용하여
serviceAccount:<principal> 형식으로 지정되어 있는지 확인하십시오. 또한 역할이 올바른 프로젝트, 데이터셋, 버킷, subscription 또는 클러스터 범위에서 부여되었는지 확인하십시오. Google Managed Kafka를 사용하는 경우 브로커 측 Kafka 접근 제어 목록(ACLs)과 TLS 구성도 함께 확인하십시오.