`, 데이터 소스 앞에 게시된 PSC 엔드포인트입니다.
* **Private DNS 이름**: 파이프가 연결할 호스트명입니다. PSC 엔드포인트에는 DNS 이름이 연결되지 않은 고정 내부 IP가 할당되므로, ClickPipes가 이 호스트명을 해당 IP로 확인합니다.
1. ClickHouse Cloud에서 서비스를 열고 **Data Sources** > **ClickPipes**로 이동합니다.
2. 수집할 데이터 소스를 선택합니다.
3. **Setup your ClickPipe connection**에서 **Use secure connection**을 켠 다음 **+ Reverse private endpoint**를 클릭하고 **GCP PSC service attachment**를 선택합니다.
4. **Service attachment URI**, **Private DNS name**, **Description**을 입력합니다.
5. **Create**를 클릭합니다. 엔드포인트 상태가 `Provisioning`에서 `Ready`로 변경됩니다. (네이티브 PSC는 자동으로 승인되므로 `PendingAcceptance`는 표시되지 않습니다.)
사용자 지정 Private DNS 매핑은 `clickhouse_clickpipes_reverse_private_endpoint`의 속성이 아닙니다. 전체 매핑 목록을 대체하는 방식으로 설정되며, ID로 엔드포인트를 참조하는 별도의 `clickhouse_clickpipes_reverse_private_endpoint_custom_private_dns` 리소스에서 관리합니다.
```hcl theme={null}
resource "clickhouse_clickpipes_reverse_private_endpoint" "gcp_psc" {
service_id = var.clickhouse_service_id
description = "GCP PSC endpoint"
type = "GCP_PSC_SERVICE_ATTACHMENT"
gcp_service_attachment = "projects//regions//serviceAttachments/"
}
resource "clickhouse_clickpipes_reverse_private_endpoint_custom_private_dns" "gcp_psc" {
service_id = var.clickhouse_service_id
reverse_private_endpoint_id = clickhouse_clickpipes_reverse_private_endpoint.gcp_psc.id
mapping = [
{ private_dns_name = "" }
]
}
```
```bash theme={null}
curl --silent --user $KEY_ID:$KEY_SECRET \
-X POST -H "Content-Type: application/json" \
https://api.clickhouse.cloud/v1/organizations//services//clickpipesReversePrivateEndpoints \
-d '{
"type": "GCP_PSC_SERVICE_ATTACHMENT",
"description": "GCP PSC endpoint",
"gcpServiceAttachment": "projects//regions//serviceAttachments/",
"customPrivateDnsMappings": [
{ "privateDnsName": "" }
]
}'
```
### 사용자 지정 Private DNS 이름
GCP PSC는 DNS를 전파하지 않으므로 ClickPipes가 이를 엔드포인트의 고정 내부 IP로 확인할 수 있도록 모든 GCP PSC 엔드포인트에 사용자 지정 Private DNS 매핑이 필요합니다.
표준 ClickPipes [사용자 지정 Private DNS 명명 규칙](/ko/integrations/clickpipes/networking/aws-privatelink#custom-private-dns)이 적용됩니다. 와일드카드 지원, 서비스의 역방향 프라이빗 엔드포인트 전체에서의 고유성, 예약된 접미사 제한은 모든 provider에서 동일하게 적용됩니다. 와일드카드는 특히 유용합니다. 예를 들어 `*...managedkafka..cloud.goog`와 같은 단일 매핑으로 관리형 Kafka 클러스터의 모든 broker를 처리할 수 있습니다.
GCP PSC에서는 매핑의 `privateDnsName`만 사용됩니다. PSC 엔드포인트는 연결할 DNS 이름 없이 고정 IP를 노출하므로 `internalDNSName` 필드는 지원되지 않습니다. 매핑은 항상 해당 IP로 확인됩니다.
## 프로듀서 소유 연결 승인
프로듀서 소유 PSC에서는 연결이 자동으로 수락되도록 ClickPipes 소비자 프로젝트(`clickpipes-production`)를 서비스 어태치먼트의 자동 수락 목록에 추가하십시오. 이 작업을 건너뛰면 수동으로 승인할 때까지 RPE가 `PendingAcceptance` 상태로 남아 있습니다.
연결을 수락하려면 서비스 어태치먼트의 소비자 수락 목록에 엔드포인트의 숫자 ID 기반 URI(`projects//regions//forwardingRules/`)를 추가해야 합니다. 서비스 어태치먼트에서 대기 중인 연결의 `endpointWithId` 값을 가져오려면 다음을 실행하십시오.
```bash theme={null}
gcloud beta compute service-attachments describe \
--region= --project= \
--format='json(connectedEndpoints)'
```
`status`가 `PENDING`인 항목의 `endpointWithId`에서 `https://www.googleapis.com/compute/beta/` 접두사를 제거하고, 결과를 `--consumer-accept-list`에 전달합니다:
`--consumer-accept-list`는 새 소비자 프로젝트를 추가하는 대신 허용 목록 전체를 덮어씁니다. 서비스 어태치먼트가 이미 다른 프로젝트나 엔드포인트를 허용하는 경우, 모두 같은 명령에 전달해야 합니다. 그렇지 않으면 누락한 항목의 액세스 권한이 사라집니다.
```bash theme={null}
gcloud beta compute service-attachments update \
--region= --project= \
--consumer-accept-list=projects//regions//forwardingRules/ \
--reconcile-connections
```
여기에서는 ClickPipes API/Terraform 응답의 `endpoint_id`를 사용하지 마십시오. 이 값은 GCP에서 요구하는 숫자 ID가 아니라 전달 규칙의 *이름*이므로 허용 목록과 일치하지 않습니다. 반드시 서비스 어태치먼트의 pending 상태인 `endpointWithId`에서 숫자 ID를 가져오십시오.
## 역방향 프라이빗 엔드포인트 관리
ClickHouse Cloud 서비스 설정에서 기존 역방향 프라이빗 엔드포인트를 관리할 수 있습니다.
1. ClickHouse Cloud 콘솔 사이드바에서 `Settings`로 이동합니다.
`ClickPipe reverse private endpoints` 아래에서 `Reverse private endpoints`를 클릭합니다.
플라이아웃에 역방향 프라이빗 엔드포인트의 상세 정보가 표시됩니다. 여기에서 RPE를 삭제할 수 있습니다. 엔드포인트의 `×`를 클릭하고 삭제를 확인하십시오. 삭제는 **영구적**이며 현재 해당 엔드포인트를 사용하는 모든 ClickPipe가 작동하지 않게 됩니다.
엔드포인트의 사용자 지정 Private DNS 매핑을 변경하려면 [Cloud API](/ko/integrations/clickpipes/programmatic-access/openapi) 또는 [Terraform](/ko/integrations/clickpipes/programmatic-access/terraform)을 사용하십시오. 업데이트하면 매핑이 추가되는 것이 아니라 전체 매핑 목록이 대체됩니다.
엔드포인트에 `Rejected` 또는 `Failed`가 표시되면 상태 아래의 메시지를 확인하십시오. 이 메시지는 프로듀서가 거부한 연결인지, 종료되었거나 조치가 필요한 연결인지를 구분해 줍니다. 두 상태 모두 일반적으로 서비스 어태치먼트의 허용 목록에 ClickPipes 소비자 프로젝트가 포함되지 않았음을 의미합니다. GCP가 엔드포인트에 대해 보고하는 상태를 확인하려면 서비스 어태치먼트의 `connectedEndpoints`를 설명하십시오.
## 알려진 제한 사항
* PSC 서비스 어태치먼트는 한 번에 하나의 ClickHouse Cloud 서비스에서만 클레임할 수 있으며, 여러 서비스에서 재사용할 수 없습니다. 서비스 어태치먼트를 다른 서비스로 이전하려면 [ClickHouse 지원팀에 문의](https://clickhouse.com/support/program)하여 기존 클레임을 해제하십시오.