Règles de transfert pour Cloud Service Mesh

Remarque :Ce guide n'est compatible qu'avec Cloud Service Mesh avec les API Google Cloud et non avec les API Istio. Pour en savoir plus, consultez la présentation de Cloud Service Mesh.

Ce document ne s'applique qu'à Cloud Service Mesh avec les API d'équilibrage de charge. Nous vous recommandons vivement d'utiliser les API de routage de services pour déployer Cloud Service Mesh.

Cloud Service Mesh utilise la règle de transfert pour déterminer le proxy cible vers lequel le trafic au sein du maillage est acheminé.

Chaque règle de transfert fournit une seule adresse IPv4 globale pour un service. Vous pouvez utiliser cette adresse pour créer des enregistrements DNS internes pour votre service (par exemple, à l'aide d'une zone privée gérée Cloud DNS). Les filtres de métadonnées de la règle de transfert spécifient les critères pour lesquels un proxy side-car compatible xDS reçoit la configuration.

Remarque :Cette page ne traite que des règles de transfert dans le contexte de Cloud Service Mesh. Les règles de transfert permettent également de fournir des informations de transfert dans le plan de contrôle pour le transfert de protocole, les Passerelles VPN classiques, et les Équilibreurs de charge Google Cloud. Pour une présentation plus complète des règles de transfert, consultez la page Présentation des règles de transfert Cloud Load Balancing.

Pour le plan de contrôle Cloud Service Mesh, la règle de transfert interne, autogérée et globale achemine le trafic par adresse IP, port et protocole vers un proxy cible. Le proxy cible pointe vers un mappage d'URL contenant des règles qui déterminent la destination du trafic. Le mappage d'URL spécifie également le service de backend par défaut. Ce service de backend spécifie une vérification de l'état et détermine le backend approprié, tel qu'un groupe d'instances géré contenant des instances de machine virtuelle ou un groupe de points de terminaison du réseau (NEG). qui contient les pods backend Google Kubernetes Engine (GKE).

Le schéma suivant montre comment une règle de transfert s'intègre à l'architecture du service de maillage Cloud.

Règle de transfert du service de maillage de services cloud en surbrillance (cliquez pour agrandir)

Propriétés de la règle de transfert

Une ressource de règle de transfert contient les propriétés suivantes qui s'appliquent à Cloud Service Mesh. La règle de transfert gère le trafic correspondant à l'adresse IP, au protocole et au numéro de port de destination.

Une adresse IP 0.0.0.0 dans une règle de transfert est l'une des options lorsque vous utilisez Cloud Service Mesh. Une adresse IP 0.0.0.0 correspond à n'importe quelle adresse IP.

• Avec un déploiement de proxy, une adresse IP 0.0.0.0 permet à un proxy de correspondre à tout trafic entrant si aucune autre correspondance spécifique n'est trouvée.

• Lors d'un déploiement sans proxy, une adresse IP 0.0.0.0 permet de spécifier qu'une adresse IP n'est pas requise. Des informations supplémentaires sont présentées sur l'utilisation des adresses IP 0.0.0.0 avec un proxy gRPC cible.

Le tableau suivant décrit plus en détail les propriétés des règles de transfert.

Valeur	Requis	Description
name	✔	Nom de la règle de transfert. Le nom doit être unique au sein du projet, comporter de 1 à 63 caractères et correspondre à l'expression régulière : [a-z]([-a-z0-9]*[a-z0-9])? Le premier caractère doit être une lettre minuscule et tous les caractères suivants doivent être soit un tiret, soit une lettre minuscule, soit un chiffre, à l'exception du dernier caractère, qui ne peut pas être un tiret.
IPAddress	✔	L'un des éléments suivants: 0.0.0.0, 127.0.0.1 ou n'importe quelle adresse RFC 1918. Les adresses IP des règles de transfert Cloud Service Mesh n'ont pas besoin de correspondre aux plages d'adresses IP des sous-réseaux du réseau cloud privé virtuel (VPC). Pour un réseau VPC, une adresse IP et un port donnés, vous ne pouvez avoir qu'une seule règle de transfert interne autogérée. Par exemple, dans le même réseau VPC, vous ne pouvez pas créer deux règles de transfert qui utilisent l'adresse IP 0.0.0.0 et le port 80.
IPAddress avec un proxy gRPC cible		L'adresse IP d'une règle de transfert renvoyant à un proxy gRPC cible dont le champ validateForProxyless est défini sur TRUE doit être 0.0.0.0. Un client gRPC utilisant le schéma xds n'effectue pas de résolution DNS pour résoudre le nom d'hôte dans l'URI de canal. À la place, un tel client résout hostname[:port] dans l'URI cible en envoyant une requête de service de détection d'écouteurs (LDS) à Cloud Service Mesh. Cette opération n'implique aucune résolution DNS, et aucune entrée DNS n'est nécessaire pour le nom d'hôte. Par conséquent, Cloud Service Mesh utilise l'adresse IP 0.0.0.0 et le port (80 par défaut) spécifiés dans l'URI pour rechercher la règle de transfert. Ensuite, Cloud Service Mesh recherche une règle d'hôte correspondante dans le mappage d'URL du proxy cible référencé par la règle de transfert.
target	✔	Proxy cible vers lequel cette règle de transfert dirige le trafic. Cloud Service Mesh est compatible avec target-http-proxy, target-https-proxy et target-grpc-proxy. Lorsque vous utilisez Google Cloud Console pour configurer la règle de transfert, le proxy cible est configuré automatiquement. Lorsque vous utilisez Google Cloud CLI ou l'API, le proxy cible doit exister avant la création de votre règle de transfert. Vous pouvez utiliser plusieurs règles de transfert avec un proxy donné.
IPProtocol	✔	Type de protocole correspondant à cette règle de transfert. La seule valeur acceptée est TCP.
loadBalancingScheme	✔	Indique comment la règle de transfert est utilisée. La valeur valide pour Cloud Service Mesh est INTERNAL_SELF_MANAGED.
portRange	✔	Port ou plage de ports liés par un tiret. Les paquets du protocole spécifié envoyés à ces ports sont transférés au backend approprié. Vous pouvez spécifier un seul nombre dans une plage, par exemple 80 ou 80-8080. Pour un réseau VPC, une adresse IP et un port donnés, vous ne pouvez avoir qu'une seule règle de transfert interne autogérée. Par exemple, dans le même réseau VPC, vous ne pouvez pas créer deux règles de transfert qui utilisent l'adresse IP 0.0.0.0 et le port 80. Avec les services gRPC sans proxy, le port de la règle de transfert est mis en correspondance avec le port spécifié dans l'URI utilisé par une application gRPC pour se connecter à un service. Si aucun port n'est spécifié dans l'URI, 80 est le port par défaut.
network	✔	Indique le réseau VPC où se trouvent les VM Google Cloud exécutant les proxys Envoy. Les proxys Envoy lisent la configuration Cloud Service Mesh que vous définissez pour le réseau sur lequel les proxys sont déployés. Vous pouvez utiliser le réseau VPC nommé default ou un réseau personnalisé. Cloud Service Mesh n'est compatible avec l'équilibrage de charge que pour les clients du réseau Google Cloud. Vous spécifiez le nom du réseau dans la règle de transfert. L'appairage de réseau VPC n'est pas accepté.

Ajouter une règle de transfert globale

Pour savoir comment configurer une règle de transfert dans la configuration globale de Cloud Service Mesh avec les API d'équilibrage de charge, consultez les pages suivantes:

• Configurer Cloud Service Mesh pour les VM Compute Engine avec déploiement Envoy automatique
• Configurer Cloud Service Mesh pour les VM Compute Engine avec déploiement Envoy manuel
• Configurer Cloud Service Mesh pour les pods GKE avec injection Envoy automatique
• Configurer Cloud Service Mesh pour les pods GKE avec injection Envoy manuelle
• Configurer Cloud Service Mesh pour les VM Compute Engine et les services gRPC sans proxy
• Configurer Cloud Service Mesh pour les pods GKE et les services gRPC sans proxy

Étape suivante

• Pour utiliser des filtres de métadonnées afin de contrôler les proxys side-car recevant la configuration associée à la règle de transfert, consultez la section Configurer le filtrage des configurations en fonction de la correspondance MetadataFilter.
• Pour router le trafic, consultez l'article Cartes de règles de routage Cloud Service Mesh.
• Pour en savoir plus sur Cloud Service Mesh, consultez la présentation de Cloud Service Mesh.