`. 데이터 소스 앞에 게시된
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를 전파하지 않으므로 사용자 지정 Private DNS 매핑은 모든 GCP PSC 엔드포인트에 필수입니다. 이 방식으로 소스의 Private DNS 이름을 항상 제공하며, ClickPipes는 이를 엔드포인트의 고정 내부 IP로 확인합니다.
표준 ClickPipes [사용자 지정 Private DNS 명명 규칙](/docs/ko/integrations/clickpipes/networking/aws-privatelink#custom-private-dns)이 적용됩니다. 와일드카드 지원, 서비스의 역방향 프라이빗 엔드포인트 전체에서의 고유성, 예약된 접미사 제한은 모든 provider에서 동일하게 적용됩니다. 와일드카드는 특히 GCP에서 유용합니다. 예를 들어 `*...managedkafka..cloud.goog`와 같은 단일 매핑으로 관리형 Kafka 클러스터의 모든 broker를 처리할 수 있습니다.
GCP PSC에서는 매핑의 `privateDnsName`만 사용됩니다. PSC 엔드포인트는 연결할 DNS 이름 없이 고정 IP를 노출하므로 `internalDNSName` 필드는 지원되지 않습니다. 매핑은 항상 해당 IP로 확인됩니다.
## producer 소유 연결 승인
프로듀서 소유 PSC에서는 연결이 자동으로 승인되도록 서비스 어태치먼트의 자동 승인 목록에 ClickPipes 소비자 프로젝트를 추가하십시오. 이를 생략하면 수동으로 승인할 때까지 RPE가 `PendingAcceptance` 상태로 유지됩니다.
연결을 승인하려면 서비스 어태치먼트의 consumer 승인 목록에 endpoint의 숫자 ID 기반 URI(`projects//regions//forwardingRules/`)를 추가해야 합니다. 이 값은 서비스 어태치먼트의 pending 연결에 있는 `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`에 전달하십시오:
```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를 가져오십시오.
또한 `--consumer-accept-list`는 허용 목록에 항목을 추가하지 않고 기존 목록을 덮어씁니다. 서비스 어태치먼트가 이미 다른 프로젝트나 엔드포인트를 허용하고 있다면, 모두 같은 명령에 지정해야 합니다. 그렇지 않으면 지정하지 않은 항목은 액세스 권한을 잃습니다.
## 역방향 프라이빗 엔드포인트 관리
ClickHouse Cloud 서비스 설정에서 기존 역방향 프라이빗 엔드포인트를 관리할 수 있습니다.
1. 사이드바에서 `Settings` 버튼을 찾아 클릭하세요.
2. `ClickPipe reverse private endpoints` 섹션에서 `Reverse private endpoints`를 클릭하세요.
플라이아웃에 역방향 프라이빗 엔드포인트의 상세 정보가 표시됩니다.
이 화면은 삭제를 제외하면 읽기 전용입니다. endpoint의 `×`를 클릭한 후 확인하면 삭제할 수 있습니다. 삭제는 영구적이며 해당 endpoint를 현재 사용 중인 모든 ClickPipe가 중단됩니다.
endpoint의 사용자 지정 Private DNS 매핑을 변경하려면 API 또는 Terraform을 사용하세요. 업데이트하면 매핑을 추가하는 대신 전체 매핑 목록이 대체됩니다.
endpoint에 `Rejected` 또는 `Failed`가 표시되면 status 아래의 메시지를 확인하세요. producer가 거부한 connection인지, 종료되었거나 조치가 필요한 connection인지를 구분할 수 있습니다. 두 상태 모두 일반적으로 서비스 어태치먼트의 허용 목록에 ClickPipes consumer 프로젝트가 포함되지 않았음을 의미합니다. GCP가 endpoint에 대해 보고하는 status를 확인하려면 서비스 어태치먼트의 `connectedEndpoints`를 확인하세요.
## 제한 사항
* RPE endpoint와 서비스 어태치먼트는 **동일한 GCP 리전**에 있어야 합니다. [global access](https://docs.cloud.google.com/vpc/docs/about-accessing-vpc-hosted-services-endpoints#global-access)를 통한 리전 간 PSC는 아직 지원되지 않습니다. 소스가 다른 리전에 있는 경우 [SSH Tunneling](/docs/ko/integrations/clickpipes/networking/index#ssh-tunneling)을 사용하십시오.
* PSC 서비스 어태치먼트는 한 번에 하나의 ClickHouse Cloud 서비스에서만 클레임할 수 있으며, 여러 서비스에서 재사용할 수 없습니다. 서비스 어태치먼트를 다른 서비스로 이전하려면 [ClickHouse 지원팀에 문의](https://clickhouse.com/support/program)하여 기존 클레임을 해제하십시오.