> ## 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.
# Configuration de la connectivité privée BYOC sur GCP
> Configurer VPC Peering ou Private Service Connect pour le BYOC sur GCP
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
ClickHouse BYOC sur GCP prend en charge deux options de connexion privée : VPC Peering et PSC (Private Service Connect).
## Prérequis
Étapes communes nécessaires au VPC peering et à PSC.
### Activer le répartiteur de charge privé pour ClickHouse BYOC
Dans la console ClickHouse Cloud, activez le **répartiteur de charge privé** pour votre infrastructure BYOC.
## Configurer le VPC peering
Veuillez vous familiariser avec la [fonctionnalité de VPC peering de GCP](https://docs.cloud.google.com/vpc/docs/vpc-peering) et tenir compte de ses limites (par exemple, les plages IP des sous-réseaux ne peuvent pas se chevaucher entre des réseaux VPC en peering). ClickHouse BYOC utilise un répartiteur de charge privé pour permettre la connectivité réseau via le peering vers les services ClickHouse.
Pour créer ou supprimer un VPC peering pour ClickHouse BYOC, suivez les étapes suivantes :
Les étapes ci-dessous illustrent un scénario simple. Pour des scénarios plus avancés, comme un peering avec une connectivité on-premise, certains ajustements peuvent être nécessaires.
Dans cet exemple, nous mettons en place un peering entre le réseau VPC BYOC et un autre réseau VPC existant.
1. Accédez à « VPC Network » dans le projet Google Cloud ClickHouse BYOC.
2. Sélectionnez « VPC network peering ».
3. Cliquez sur « Create connection ».
4. Renseignez les champs nécessaires selon vos besoins. Vous trouverez ci-dessous une capture d’écran montrant la création d’un peering au sein du même projet GCP.
Le VPC peering GCP nécessite 2 connexions entre les 2 réseaux pour fonctionner (c.-à-d. une connexion du réseau BYOC vers le réseau VPC existant, et une connexion du réseau VPC existant vers le réseau BYOC). Vous devez donc créer de la même façon 1 connexion supplémentaire dans le sens inverse. Vous trouverez ci-dessous une capture d’écran de la création de la deuxième connexion de peering :
Une fois les deux connexions créées, leur statut devrait passer à « Active » après actualisation de la page du Google Cloud Console :
Le service ClickHouse devrait maintenant être accessible depuis le VPC en peering.
Pour accéder à ClickHouse de manière privée, un répartiteur de charge privé et un endpoint sont provisionnés afin de fournir une connectivité sécurisée depuis le VPC en peering de l’utilisateur. Le private endpoint suit le format du public endpoint avec un suffixe `-private`. Par exemple :
* **Public endpoint** : `h5ju65kv87.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com`
* **Private endpoint** : `h5ju65kv87-private.mhp0y4dmph.us-east1.gcp.clickhouse-byoc.com`
## Configurer PSC (Private Service Connect)
GCP PSC (Private Service Connect) offre une connexion privée et sécurisée à vos services ClickHouse BYOC, sans nécessiter de peering VPC ni de passerelles Internet. L'ensemble du trafic reste au sein du réseau GCP et ne transite jamais par l'Internet public.
Assurez-vous que le **répartiteur de charge privé** est activé au préalable.
Obtenir le Service name de l’endpoint} id="step-2-obtain-endpoint-service-name">
1. Dans la console ClickHouse Cloud, accédez à la page Settings du service auquel vous souhaitez vous connecter via PSC.
2. Cliquez sur « Set up private endpoint ».
3. Dans le panneau qui s’ouvre, copiez les valeurs `Service name` et `DNS name` ; vous les utiliserez à l’étape suivante. (La génération de ces valeurs peut prendre un certain temps après l’activation de Private Link.)
1. Ouvrez votre **propre console GCP** (c’est-à-dire le compte GCP où se trouve votre application cliente) → Network Services → Private Service Connect → Connected Endpoints.
2. Ouvrez la boîte de dialogue de création Private Service Connect en cliquant sur le bouton « Connect Endpoint ».
3. Renseignez les champs suivants :
* **Target** : utilisez `Published service`
* **Target service** : utilisez le `Service name` obtenu à l’étape précédente
* **Endpoint name** : saisissez un nom d’endpoint valide
* **Network/Subnetwork** : choisissez le réseau à utiliser pour la connexion ; c’est depuis ce réseau que votre application cliente se connectera
* **IP address** : choisissez ou créez une adresse IP pour l’endpoint ; vous devrez l’utiliser à l’étape [Définir le nom DNS privé de l’endpoint](#step-5-set-private-dns-name-for-endpoint)
* (facultatif) **Enable global access** : activez cette option si vous souhaitez rendre l’endpoint accessible depuis n’importe quelle région
* Cliquez sur le bouton « ADD ENDPOINT » pour créer l’endpoint.
4. La colonne Status passera de Pending à Accepted une fois la connexion approuvée.
5. Après avoir créé l’endpoint, copiez la valeur `PSC Connection ID` ; vous l’utiliserez à l’étape suivante.
Ajouter l’Endpoint ID à la liste d’autorisation du service ClickHouse} id="step-4-add-endpoint-id-to-services-allow-list">
1. Dans la console ClickHouse Cloud, accédez à la page Settings du service auquel vous souhaitez vous connecter via PSC.
2. Cliquez sur « Set up private endpoint ».
3. Dans le panneau qui s’ouvre, saisissez le `PSC Connection ID` obtenu à l’étape précédente dans le champ `Endpoint ID`, avec une description facultative.
4. Cliquez sur « Create endpoint ».
Si vous souhaitez autoriser l’accès à partir d’une connexion PSC existante, utilisez le menu déroulant des endpoints existants.
Ce menu affiche les connexions PSC existantes aux services de la même infrastructure.
Il existe différentes manières de configurer DNS. Configurez DNS selon votre cas d’utilisation.
Vous devez faire pointer tous les sous-domaines (caractère générique) du « DNS name » vers l’adresse IP de l’endpoint PSC GCP. Cela permet aux services et composants de votre VPC/réseau de le résoudre correctement.
1. Dans la console ClickHouse Cloud, accédez à la page Settings du service.
2. Cliquez sur « Set up private endpoint ».
3. Dans le panneau qui s’ouvre, copiez le `DNS name`.
L’accès aux services ClickHouse via PSC est contrôlé par l’**Istio Authorization Policy** au niveau du service, gérée par ClickHouse au sein de votre infrastructure BYOC.