> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuração de rede privada do BYOC no GCP
> Configure VPC Peering ou Private Service Connect para BYOC no GCP
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
O ClickHouse BYOC no GCP oferece suporte a duas opções de conexão privada: VPC Peering e PSC (Private Service Connect).
## Pré-requisitos
Etapas comuns necessárias para VPC peering e PSC.
### Habilitar o balanceador de carga privado para ClickHouse BYOC
No console do ClickHouse Cloud, habilite o **balanceador de carga privado** para sua infraestrutura BYOC.
## Configurar VPC peering
Recomendamos que você se familiarize com o [recurso de VPC peering do GCP](https://docs.cloud.google.com/vpc/docs/vpc-peering) e observe as limitações do VPC peering (por exemplo, os intervalos de IP de sub-rede não podem se sobrepor entre redes VPC emparelhadas). O ClickHouse BYOC usa um balanceador de carga privado para permitir conectividade de rede por meio do peering com os serviços ClickHouse.
Para criar ou excluir VPC peering no ClickHouse BYOC, siga estas etapas:
As etapas de exemplo são para um cenário simples; em cenários avançados, como peering com conectividade on-premises, alguns ajustes podem ser necessários.
Neste exemplo, estamos configurando peering entre a rede VPC do BYOC e outra rede VPC existente.
1. Navegue até "VPC Network" no projeto do Google Cloud do ClickHouse BYOC.
2. Selecione "VPC network peering".
3. Clique em "Create connection".
4. Preencha os campos necessários de acordo com seus requisitos. Abaixo está uma captura de tela da criação de um peering dentro do mesmo projeto do GCP.
O VPC peering do GCP exige 2 conexões entre as 2 redes para funcionar (ou seja, uma conexão da rede BYOC para a rede VPC existente e uma conexão da rede VPC existente para a rede BYOC). Portanto, você também precisa criar mais 1 conexão no sentido inverso. Abaixo está uma captura de tela da criação da segunda conexão de peering:
Depois que ambas as conexões forem criadas, o status das 2 conexões deverá mudar para "Active" após atualizar a página do Google Cloud Console:
O serviço ClickHouse agora deve estar acessível a partir da VPC emparelhada.
Para acessar o ClickHouse de forma privada, um balanceador de carga privado e um endpoint são provisionados para conectividade segura a partir da VPC emparelhada do usuário. O endpoint privado segue o formato do endpoint público com o sufixo `-private`. Por exemplo:
* **Endpoint público**: `h5ju65kv87.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com`
* **Endpoint privado**: `h5ju65kv87-private.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com`
## Configure o PSC (Private Service Connect)
O PSC (Private Service Connect) do GCP oferece uma conexão segura e privada aos seus serviços ClickHouse BYOC, sem a necessidade de VPC peering ou gateways de internet. Todo o tráfego permanece na rede do GCP, garantindo que nunca passe pela internet pública.
Certifique-se de que o **balanceador de carga privado** esteja ativado como pré-requisito.
Obter o Service name do endpoint} id="step-2-obtain-endpoint-service-name">
1. No console do ClickHouse Cloud, acesse a página Settings do serviço ao qual deseja se conectar via PSC.
2. Clique em "Set up private endpoint".
3. No painel lateral exibido, copie os valores de `Service name` e `DNS name` — você os usará na próxima etapa. (Pode levar algum tempo para que os valores sejam gerados após a habilitação do link privado.)
1. Abra seu **próprio console do GCP** (isto é, a conta do GCP em que sua aplicação cliente está) → Network Services → Private Service Connect → Connected Endpoints.
2. Abra a caixa de diálogo de criação do Private Service Connect clicando no botão "Connect Endpoint".
3. Preencha os seguintes campos:
* **Target**: use `Published service`
* **Target service**: use o `Service name` obtido na etapa anterior
* **Endpoint name**: insira um nome válido para o endpoint
* **Network/Subnetwork**: escolha a rede que deseja usar para a conexão; é dessa rede que sua aplicação cliente se conectará
* **IP address**: escolha ou crie um novo endereço IP para o endpoint; esse endereço IP será usado na etapa [Definir nome DNS privado para o endpoint](#step-5-set-private-dns-name-for-endpoint)
* (opcional) **Enable global access**: habilite esta opção se quiser disponibilizar o endpoint em qualquer região
* Clique no botão "ADD ENDPOINT" para criar o endpoint.
4. A coluna Status mudará de Pending para Accepted quando a conexão for aprovada.
5. Depois de criar o endpoint, copie o valor de `PSC Connection ID` — você o usará na próxima etapa.
Adicionar o Endpoint ID à lista de permissões do serviço ClickHouse} id="step-4-add-endpoint-id-to-services-allow-list">
1. No console do ClickHouse Cloud, acesse a página Settings do serviço ao qual deseja se conectar via PSC.
2. Clique em "Set up private endpoint".
3. No painel lateral exibido, insira o `PSC Connection ID` obtido na etapa anterior no campo `Endpoint ID` e, opcionalmente, adicione uma descrição.
4. Clique em "Create endpoint".
Se quiser permitir o acesso de uma conexão PSC existente, use o menu suspenso de endpoints existentes.
O menu suspenso exibirá as conexões PSC existentes com serviços na mesma infraestrutura.
Há várias maneiras de configurar o DNS. Configure-o de acordo com seu caso de uso específico.
É necessário apontar todos os subdomínios (curinga) do "DNS name" para o endereço IP do endpoint PSC do GCP. Isso garante que os serviços/componentes na sua VPC/rede possam resolvê-lo corretamente.
1. No console do ClickHouse Cloud, acesse a página Settings do serviço.
2. Clique em "Set up private endpoint".
3. No painel lateral exibido, copie o `DNS name`.
O acesso aos serviços ClickHouse via PSC é controlado pela **Istio Authorization Policy** no nível do serviço, gerenciada pelo ClickHouse em sua infraestrutura BYOC.