Cette page explique comment répertorier, créer, décrire, supprimer et mettre à jour les hubs et satellites de Network Connectivity Center.
Pour en savoir plus sur Network Connectivity Center, consultez la section Présentation de Network Connectivity Center.
Avant de commencer
Avant de commencer, consultez les sections suivantes.
Créer ou sélectionner un projet
Pour faciliter la configuration de Network Connectivity Center, commencez par identifier un projet valide.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Si vous utilisez Google Cloud CLI, définissez votre ID de projet à l'aide de la commande
gcloud config set
.gcloud config set project PROJECT_ID
Remplacez
PROJECT_ID
par votre ID de projet unique.Dans les instructions gcloud CLI présentées sur cette page, nous partons du principe que vous avez défini l'ID de votre projet.
Pour vérifier que vous avez correctement défini l'ID du projet, utilisez la commande
gcloud config list
.gcloud config list --format='text(core.project)'
Activer l'API Network Connectivity
Pour pouvoir effectuer des tâches quelconques à l'aide de Network Connectivity Center, vous devez activer l'API Network Connectivity.
Console
Pour activer l'API Network Connectivity, procédez comme suit :
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Cliquez sur Activer.
Vous pouvez également activer l'API à l'aide de la bibliothèque d'API de la console Google Cloud, comme décrit dans la section Activer des API.
Obtenir l'accès
Pour utiliser Network Connectivity Center, vous devez disposer des autorisations décrites dans la section Rôles et autorisations.
Identifier les ressources
Lorsque vous référencez des ressources à l'aide de gcloud CLI ou de l'API, utilisez les conventions décrites dans le tableau suivant.
Congrès | Compatible | Remarques | Exemple |
---|---|---|---|
URI complet | Toutes les ressources | Utilisez l'une de ces méthodes pour référencer des instances de dispositif de routeur. |
"https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME" |
Nom de ressource relatif | Toutes les ressources | "projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME" |
|
Nom | Ressources régionales et mondiales | Utilisez cette méthode pour les hubs, les spokes, les tunnels VPN et les rattachements de VLAN. | "HUB_NAME" |
Travailler avec des hubs
Cette section explique comment répertorier, créer, décrire et supprimer des hubs du centre de connectivité réseau. Vous pouvez également mettre à jour les libellés ou la description d'un hub.
Créer un hub
Pour utiliser Network Connectivity Center, vous devez créer au moins un hub et un spoke. Vous pouvez créer des spokes en même temps que des hubs, ou ajouter les spokes ultérieurement.
Lorsque vous créez un hub, vous pouvez éventuellement lui appliquer des libellés. Pour en savoir plus sur les libellés, consultez la section Exigences applicables aux libellés.
Pour en savoir plus sur le nombre maximal de spokes autorisés par projet, consultez la page Quotas et limites.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Cliquez sur Créer un hub.
Renseignez la section Configuration de base du formulaire :
- Saisissez un nom de hub.
- Facultatif : saisissez une Description.
- Facultatif : pour ajouter un libellé, cliquez sur Ajouter un élément, puis saisissez une clé et une valeur.
- Vérifiez que le formulaire affiche l'ID de projet approprié. Si l'ID du projet est incorrect, sélectionnez un autre projet à l'aide du menu déroulant situé en haut de la page.
Pour activer la propagation de connexion Private Service Connect, dans le champ Propagation de connexion Private Service Connect, cliquez sur Activé. Cette fonctionnalité (Preview) ne s'applique qu'aux spokes VPC.
Effectuez l'une des opérations suivantes :
- Si vous souhaitez créer un spoke, cliquez sur Étape suivante et remplissez la section du formulaire concernant la création du spoke. Pour obtenir des instructions, consultez l'une des sections suivantes :
- Si vous ne souhaitez pas créer de spoke maintenant, cliquez sur Créer pour terminer la création du hub.
gcloud
Pour créer un hub, utilisez la commande gcloud network-connectivity hubs create
.
gcloud network-connectivity hubs create HUB_NAME \ --description="DESCRIPTION" \ --labels="KEY"="VALUE"
Si vous souhaitez activer la connexion propagée Private Service Connect (version bêta) de manière globale pour le hub de Network Connectivity Center, utilisez l'indicateur --export-psc
. Cette fonctionnalité ne s'applique qu'aux spokes VPC.
gcloud network-connectivity hubs create HUB_NAME \ --description="DESCRIPTION" \ --labels="KEY"="VALUE" \ [ --export-psc]
Remplacez les valeurs suivantes :
HUB_NAME
: nom du nouveau hubDESCRIPTION
: texte facultatif décrivant le hubKEY
: clé de la paire clé/valeur pour le texte de l'étiquette facultativeVALUE
: valeur de la paire clé/valeur pour le texte du libellé facultatif
API
Pour créer un hub, utilisez la méthode networkconnectivity.hubs.create
.
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs { "name":"HUB_NAME", "description":"DESCRIPTION", "labels": { "KEY": "VALUE" } }
Si vous souhaitez activer la connexion propagée Private Service Connect (version bêta) de manière globale pour le hub du Centre de connectivité réseau, définissez la valeur export-psc
sur "true". Cette fonctionnalité ne s'applique qu'aux spokes VPC. La propagation des connexions Private Service Connect ne se propage pas aux réseaux sur site via des rayons hybrides, tels que les rattachements VLAN Cloud Interconnect, les tunnels VPN haute disponibilité et l'appareil de routeur.
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs { "export_psc": true }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le nouveau hubHUB_NAME
: nom du nouveau hubDESCRIPTION
: texte facultatif décrivant le hubKEY
: clé de la paire clé/valeur pour le texte du libellé facultatifVALUE
: valeur de la paire clé/valeur pour le texte du libellé facultatif
Répertorier les hubs
Pour répertorier les hubs associés à un projet, suivez les instructions ci-dessous.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
La page répertorie tous les hubs associés au projet, ainsi que les informations suivantes sur chaque hub :
- Nom du hub
- Description du hub
- Tous les libellés appliqués au hub
- Nombre de spokes associés au hub
- Types de spokes associés au hub
gcloud
Pour répertorier les hubs associés à un projet, exécutez la commande gcloud network-connectivity hubs list
.
gcloud network-connectivity hubs list
Le résultat de la commande inclut le nom et la description de chaque hub.
API
Pour répertorier les hubs associés à un projet, utilisez la méthode networkconnectivity.hubs.list
.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
Remplacez PROJECT_ID
par l'ID du projet qui contient les hubs à répertorier.
Pour chaque hub, cette méthode renvoie les informations suivantes :
- Nom du hub
- Code temporel indiquant la date de création du hub
- Code temporel de la dernière mise à jour
- Tous les libellés appliqués au hub
- Description du hub (le cas échéant)
- ID unique du hub
- État du hub
- Liste de
routingVpcs
, qui sont des réseaux VPC associés aux spokes du hub
Décrire un hub
Suivez les instructions ci-dessous pour récupérer les informations sur le hub d'un projet.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu des projets, sélectionnez un projet afin d'afficher les informations sur son hub.
Pour afficher les détails des spokes du hub, cliquez sur l'onglet Spokes.
gcloud
Pour obtenir des informations détaillées sur un hub existant, utilisez la commande gcloud network-connectivity hubs describe
.
gcloud network-connectivity hubs describe HUB_NAME
Remplacez HUB_NAME
par le nom du hub.
Le résultat de cette commande affiche les informations suivantes :
- Date et heure de création du hub
- Description du hub
- Tous les libellés appliqués au hub
- Les réseaux VPC (
routingVpcs
) associés aux ressources de spoke de ce hub - Identifiant unique du hub
- Date et heure de la dernière mise à jour du hub
Si vous souhaitez obtenir des informations sur les spokes associés à un hub, consultez les pages Répertorier les spokes et Décrire un spoke.
API
Pour obtenir des informations détaillées sur un hub existant, utilisez la méthode networkconnectivity.hubs.get
.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant les hubs à décrire.HUB_NAME
: nom du hub à décrire
Le résultat de cette commande affiche les informations suivantes :
- Date et heure de création du hub
- Description du hub
- Tous les libellés appliqués au hub
- Les réseaux VPC (
routingVpcs
) associés aux ressources de spoke de ce hub - Identifiant unique du hub
- Date et heure de la dernière mise à jour du hub
L'extrait de code suivant illustre une réponse typique à cet appel d'API :
{ "name": "projects/myproject/locations/global/hubs/myhub", "createTime": "2021-08-29T23:40:25.844970812Z", "updateTime": "2021-08-30T04:20:36.738801209Z", "labels": { "environment": "test" }, "description": "in review", "uniqueId": "d6d3e375-4224-4352-a3b6-776042419430", "state": "ACTIVE", "routingVpcs": [ { "uri": "https://www.googleapis.com/compute/v1/projects/myproject/global/networks/myvpcnetwork" } ] }
Si vous souhaitez obtenir des informations sur les spokes associés à un hub, consultez les pages Répertorier les spokes et Décrire un spoke.
Mettre à jour un hub
Une fois le hub créé, vous pouvez ajouter ou modifier l'un des éléments suivants :
- Libellés appliqués au hub (pour en savoir plus sur les libellés, consultez la page Conditions requises pour les libellés)
- Description du hub
- Activez la propagation de connexion Private Service Connect sur un hub existant. Cette fonctionnalité (Preview) ne s'applique qu'aux spokes VPC.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Cliquez sur le nom du hub que vous souhaitez modifier.
Sur la page Informations sur le hub, cliquez sur
Modifier le hub.Mettez à jour la description et les libellés du hub.
Pour activer la propagation de connexion Private Service Connect, cliquez sur Activé. Pour désactiver la propagation des connexions Private Service Connect, cliquez sur Désactivé. Cette fonctionnalité (Preview) ne s'applique qu'aux spokes VPC.
Cliquez sur Enregistrer.
gcloud
Pour mettre à jour la description d'un hub ou lui ajouter des libellés, utilisez la commande gcloud network-connectivity hubs update
.
gcloud network-connectivity hubs update HUB_NAME \ --description="DESCRIPTION" \ --update-labels="KEY"="VALUE"
Si vous souhaitez activer la connexion propagée Private Service Connect (version bêta) de manière globale pour le hub de Network Connectivity Center, utilisez l'indicateur --export-psc
. Cette fonctionnalité ne s'applique qu'aux spokes VPC.
gcloud network-connectivity hubs update HUB_NAME \ --description="DESCRIPTION" \ --labels="KEY"="VALUE" \ --export-psc
Remplacez les valeurs suivantes :
HUB_NAME
: nom du hubDESCRIPTION
: nouvelle description facultative du hubKEY
: clé de la paire clé/valeur pour le texte du libellé facultatifVALUE
: valeur de la paire clé/valeur pour le texte de l'étiquette facultative
Vous pouvez désactiver la fonctionnalité de propagation de connexion Private Service Connect sur les hubs existants à l'aide de l'indicateur --no-export-psc
. Les connexions de propagation existantes sont supprimées de manière asynchrone.
Pour supprimer un ou plusieurs libellés, utilisez l'option --remove-labels
. Pour supprimer tous les libellés, utilisez l'option --clear-labels
. Pour en savoir plus sur cette commande, consultez la page gcloud network connectivity hubs update
.
API
Pour mettre à jour la description d'un hub ou lui ajouter des libellés, utilisez la méthode networkconnectivity.hubs.patch
.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME { "description": "DESCRIPTION", "labels": { "KEY": "VALUE" } }
Si vous souhaitez activer la connexion propagée Private Service Connect (version bêta) de manière globale pour le hub du Centre de connectivité réseau, définissez la valeur export-psc
sur "true". Cette fonctionnalité ne s'applique qu'aux spokes VPC.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME { "export_psc": true }
Remplacez les valeurs suivantes :
PROJECT_ID
: identifiant du projet contenant le hubHUB_NAME
: nom du hubDESCRIPTION
: description facultative du hubKEY
: clé de la paire clé/valeur pour le texte du libellé facultatifVALUE
: valeur de la paire clé/valeur pour le texte de l'étiquette facultative
Vous pouvez désactiver la fonctionnalité de propagation de connexion Private Service Connect sur un hub existant en définissant la valeur export_psc
sur "false". Les connexions de propagation existantes sont supprimées de manière asynchrone.
Supprimer un hub
Pour supprimer un hub, vous devez supprimer ses spokes, comme décrit dans la section Supprimer un spoke.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Cliquez sur
Supprimer le hub.Dans la boîte de dialogue de confirmation, effectuez l'une des opérations suivantes :
- Cliquez sur Annuler si vous ne souhaitez pas supprimer le hub.
- Cliquez sur Supprimer pour supprimer le hub.
gcloud
Pour supprimer un hub, utilisez la commande gcloud network-connectivity hubs delete
.
gcloud network-connectivity hubs delete HUB_NAME
Remplacez HUB_NAME
par le nom du hub.
API
Pour supprimer un hub, utilisez la méthode networkconnectivity.hubs.delete
.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le hub à supprimerHUB_NAME
: nom du hub à supprimer
Travailler avec des spokes
Cette section explique comment répertorier, créer, décrire, supprimer et mettre à jour les spokes du centre de connectivité réseau.
Consignes pour les spokes
Lorsque vous créez un spoke, vous spécifiez le type de ressource réseau Google Cloud que vous prévoyez d'associer au spoke.
- Pour obtenir la liste des types de ressources compatibles, consultez la section Spokes de la présentation du centre de connectivité réseau.
- Pour connaître le nombre de ressources que vous pouvez associer à un spoke, consultez la page Quotas et limites.
Pour les spokes hybrides, nous vous recommandons de créer chaque spoke dans la région la plus proche du site auquel il se connecte. Un site peut être un centre de données sur site, une filiale ou un autre fournisseur cloud. Les spokes VPC sont mondiaux.
Conditions requises
Vous devez créer chaque spoke dans la même région Google Cloud que la ressource de connectivité réseau que vous souhaitez associer au spoke. Par exemple, supposons que vous disposez d'un tunnel VPN utilisant une passerelle VPN haute disponibilité dans la région us-central1
. Si vous souhaitez créer un spoke qui utilise ce tunnel, vous devez le créer dans us-central1
.
Limites
Une fois que vous avez créé un spoke, une grande partie de ses attributs ne peuvent pas être modifiés. Si vous souhaitez modifier un attribut qui ne peut pas être modifié, vous devez supprimer le spoke et le recréer.
Par exemple, les attributs suivants ne peuvent pas être modifiés :
La valeur du champ de transfert de données de site à site.
Les tunnels VPN haute disponibilité ou les rattachements de VLAN associés au spoke.
Le réseau VPC associé aux ressources de sauvegarde du spoke. Cette limitation ne s'applique qu'aux spokes d'appareil de routeur, car ils disposent de ressources modifiables.
Spoke VPC de consommateur et nom de la connexion d'appairage d'un spoke VPC de producteur (Preview)
Pour obtenir la liste des attributs de spoke qui peuvent être modifiés après la création du spoke, consultez la section Mettre à jour un spoke.
Recommandations pour associer plusieurs ressources à un spoke
Lorsque vous créez un spoke, vous pouvez ajouter plusieurs ressources, mais toutes les ressources doivent être du même type. Par exemple, vous pouvez ajouter plusieurs tunnels VPN haute disponibilité, mais vous ne pouvez pas ajouter des tunnels VPN haute disponibilité et des rattachements de VLAN.
En outre, pour les rattachements de VLAN et les tunnels VPN, la restriction suivante existe : bien qu'un spoke puisse être associé à plusieurs ressources, chaque ressource ne peut être associée qu'à un seul spoke. En revanche, une instance de dispositif de routeur peut être associée à plusieurs spokes si elle possède des interfaces dans plusieurs réseaux VPC et si le champ de transfert de données de site à site est défini sur "false". Cependant, chaque interface ne peut être associée qu'à un seul spoke.
Vous pouvez également consulter les recommandations spécifiques aux ressources décrites dans les sections Créer un spoke d'appareil de routeur, Créer un spoke de rattachement de VLAN, Créez un spoke de VPN et créez un spoke de VPC.
Attribution de numéros ASN aux spokes (spokes hybrides uniquement)
Pour les spokes hybrides, vous devez attribuer des numéros de système autonome (numéro ASN) comme décrit dans les exigences liées aux numéros ASN.
Valider les ressources Spoke
Avant de créer un spoke, la ressource correspondante doit être configurée correctement. Pour en savoir plus, consultez les recommandations spécifiques aux ressources décrites dans les sections Créer un spoke VPC, Créer un spoke VPC de producteur (Preview), Créer un spoke d'appareil de routeur, Créer un spoke de rattachement de VLAN et Créer un spoke de VPN.
Créer un spoke VPC
Avant de créer des spokes de rattachement de VPC, tenez compte des consignes suivantes :
- Les spokes VPC sont mondiaux, car les réseaux VPC sont mondiaux.
- Il ne doit pas y avoir de chevauchements de sous-réseaux sur les spokes VPC. Pour éviter cela, utilisez les options
exclude export ranges
etinclude export ranges
. Pour en savoir plus sur l'utilisation de filtres pour la connectivité réseau VPC, consultez la section Connectivité VPC avec des filtres. - Il ne peut pas y avoir de chevauchement de sous-réseau entre la connectivité VPC de Network Connectivity Center et l'appairage VPC.
- Les spokes VPC, où le hub et le spoke VPC se trouvent dans des projets différents, ont un workflow différent. Pour plus d'informations, consultez la section Spokes VPC dans un projet différent du hub.
- Les spokes VPC associés à un hub compatible avec la topologie en étoile doivent être explicitement attribués à un groupe de spokes.
- Si vous souhaitez créer une connexion Private Service Connect dans le spoke VPC (version Preview), la propagation de connexion Private Service Connect doit être activée sur le hub. Pour savoir comment créer un point de terminaison Private Service Connect, consultez Créer un point de terminaison.
Pour connecter plusieurs réseaux VPC dans un projet donné, connectez un réseau VPC à un spoke, puis connectez-le à un hub.
Si vous créez un VPC pour vous connecter à un hub configuré pour la topologie en étoile, vous devez obtenir auprès de l'administrateur du hub l'ID du projet, le nom ou l'URI du hub, et le nom du groupe.
Si vous souhaitez attribuer des plages d'exclusion d'exportation ou des plages d'inclusion d'exportation, utilisez les options appropriées lors de la création du rayon.
Pour créer un spoke VPC, procédez comme suit.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez le projet dans lequel vous souhaitez créer le spoke.
Cliquez sur l'onglet Spokes.
Cliquez sur Ajouter des spokes.
Dans la section Sélectionner un hub, sélectionnez l'emplacement du hub comme suit :
- Pour associer le nouveau spoke à un hub hébergé dans le même projet, sélectionnez Dans le projet
PROJECT_NAME
et sélectionnez le nom du hub dans la liste. - Si vous souhaitez associer le nouveau spoke à un hub hébergé dans un autre projet, sélectionnez Dans un autre projet. Saisissez l'ID de projet et le nom du hub auquel vous souhaitez associer votre nouveau spoke.
Lorsque vous choisissez un hub hébergé dans un autre projet, votre spoke ne devient actif que lorsque l'administrateur du hub examine et accepte le spoke proposé. Pour en savoir plus sur la création de spokes associés à un hub hébergé dans un autre projet, consultez la section Présentation des spokes VPC. Si vous créez un spoke VPC dans le même projet que le hub, il est automatiquement accepté et activé.
- Pour associer le nouveau spoke à un hub hébergé dans le même projet, sélectionnez Dans le projet
Saisissez un Nom de spoke et, éventuellement, une Description.
Si le hub auquel vous vous connectez est configuré pour la topologie en étoile, sélectionnez le groupe de spokes correspondant à votre spoke. Pour en savoir plus sur les groupes de spokes, consultez la section Groupes de spokes.
Sélectionnez Réseau VPC comme Type de spoke.
Pour ajouter un réseau VPC au spoke, sélectionnez-en un dans la liste Réseau VPC associé.
Vous pouvez éventuellement ajouter un filtre de Spoke VPC pour personnaliser l'annonce des routes en saisissant une plage d'adresses IP afin d'exclure ou d'inclure l'exportation du spoke vers le hub. Vous ne pouvez pas modifier ce filtre une fois le spoke créé.
Cliquez sur OK.
Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un Nom de spoke.
Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page Network Connectivity Center est mise à jour et affiche les détails des spokes que vous avez créés.
gcloud
Pour créer un spoke VPC, utilisez la commande gcloud network-connectivity spokes linked-vpc-network create
.
gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \ --hub=HUB \ --description=DESCRIPTION \ --vpc-network=VPC_URI \ --exclude-export-ranges=[EXCLUDE_CIDR_RANGE] \ --include-export-ranges=[INCLUDE_CIDR_RANGE] \ --global \ --group=GROUP_NAME
Remplacez les éléments suivants :
SPOKE_NAME
: nom du spoke que vous créez, par exemplevpc-spoke1
HUB
: hub du spokeDESCRIPTION
: texte (facultatif) décrivant le spokeVPC_URI
: réseau VPC vers lequel ce spoke pointe[EXCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à exclure de l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
. Les plages spécifiées doivent être d'une étendue supérieure ou égale aux sous-réseaux configurés individuellement dans le VPC.[INCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à inclure dans l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
.GROUP_NAME
: groupe auquel appartient ce spoke, par exemple,center
ouedge
. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile (preview). Pour en savoir plus sur les groupes de spokes, consultez la section Groupes de spokes.
API
Pour créer un spoke VPC, utilisez la méthode networkconnectivity.spokes.create
.
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/spokes/SPOKE_NAME { "hub":"HUB_NAME", "linkedVpcNetwork": { "uri": VPC_URI, "include_export_ranges": "[INCLUDE_CIDR_RANGE]", "exclude_export_ranges": "[EXCLUDE_CIDR_RANGE]", "group": "GROUP_NAME" }, }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le nouveau spokeHUB_NAME
: nom du hub auquel vous associez le spokeVPC_URI
: réseau VPC vers lequel ce spoke pointe, par exemplevpc_uri
.[INCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à inclure dans l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
. Les plages spécifiées doivent être d'une étendue supérieure ou égale aux sous-réseaux configurés individuellement dans le VPC.[EXCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à exclure de l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
.GROUP_NAME
: groupe auquel appartient ce spoke. Nom du groupe de spokes. Les valeurs acceptées sontdefault
pour un hub avec topologie de maillage, etcenter
ouedge
pour un hub avec topologie en étoile. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile (preview). Pour en savoir plus sur les groupes de spokes, consultez la section Groupes de spokes.
Créer un spoke VPC de producteur
Avant de créer un spoke VPC de producteur:
- Consultez les considérations concernant les spokes VPC de producteur.
- Consultez les consignes pour créer des spokes VPC, qui s'appliquent également aux spokes VPC producteurs.
Pour connecter un réseau VPC de producteur de services à d'autres réseaux dans un projet donné, connectez le réseau VPC du producteur à un spoke VPC de producteur, puis connectez le spoke VPC du producteur à un hub.
Si vous utilisez Google Cloud CLI ou l'API pour connecter le rayon du VPC du producteur à un hub configuré pour une topologie en étoile, vous devez utiliser le même nom de groupe que le rayon du VPC du consommateur existant sur le hub. Si vous utilisez la console Google Cloud, le spoke VPC de producteur est automatiquement ajouté au même groupe.
Si vous souhaitez attribuer des plages d'exclusion d'exportation ou des plages d'inclusion d'exportation, utilisez les options appropriées lors de la création du rayon.
Pour créer un spoke VPC producteur, procédez comme suit :
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez le projet dans lequel vous souhaitez créer le spoke.
Cliquez sur l'onglet Spokes.
Cliquez sur Ajouter des spokes.
Dans la section Sélectionner un hub, sélectionnez l'emplacement du hub comme suit :
- Pour associer le nouveau spoke à un hub hébergé dans le même projet, sélectionnez Dans le projet
PROJECT_NAME
et sélectionnez le nom du hub dans la liste. - Si vous souhaitez associer le nouveau spoke à un hub hébergé dans un autre projet, sélectionnez Dans un autre projet. Saisissez l'ID de projet et le nom du hub auquel vous souhaitez associer votre nouveau spoke.
Lorsque vous choisissez un hub hébergé dans un autre projet, votre spoke ne devient actif que lorsque l'administrateur du hub examine et accepte le spoke proposé. Pour en savoir plus sur la création de spokes associés à un hub hébergé dans un autre projet, consultez la section Présentation des spokes VPC. Si vous créez un spoke VPC de producteur dans le même projet que le hub, il est automatiquement accepté et activé.
- Pour associer le nouveau spoke à un hub hébergé dans le même projet, sélectionnez Dans le projet
Saisissez un Nom de spoke et, éventuellement, une Description.
Sélectionnez Réseau VPC du producteur comme Type de spoke.
Saisissez le nom d'un spoke VPC consommateur existant sur le hub qui consomme des services du réseau VPC du producteur via une connexion d'appairage de réseaux VPC. Google Cloud identifie le réseau du producteur via la connexion d'appairage.
Vous pouvez éventuellement ajouter un filtre de spoke VPC pour personnaliser l'annonce des routes en saisissant une plage d'adresses IP afin d'exclure ou d'inclure l'exportation du spoke vers le hub. Vous ne pouvez pas modifier ce filtre une fois le spoke créé.
Cliquez sur OK.
Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un nom de spoke.
Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page Network Connectivity Center est mise à jour et affiche les détails des spokes que vous avez créés.
gcloud
Pour créer un spoke VPC de producteur, utilisez la commande gcloud network-connectivity spokes linked-producer-vpc-network create
.
gcloud network-connectivity spokes linked-producer-vpc-network create SPOKE_NAME \ --hub=HUB \ --description=DESCRIPTION \ --network=CONSUMER_VPC_URI \ --peering=servicenetworking-googleapis-com \ --exclude-export-ranges=[EXCLUDE_CIDR_RANGE] \ --include-export-ranges=[INCLUDE_CIDR_RANGE] \ --global \ --group=GROUP_NAME
L'option --peering
doit être définie sur servicenetworking-googleapis-com
.
Remplacez les éléments suivants :
SPOKE_NAME
: nom du spoke que vous créez, par exempleproducer-vpc-spoke1
HUB
: hub du spokeDESCRIPTION
: texte facultatif décrivant le spokeCONSUMER_VPC_URI
: réseau VPC qui consomme les services du réseau producteur via une connexion d'appairage de réseaux VPC. Google Cloud identifie le réseau VPC du producteur via la connexion d'appairage. Le réseau client que vous saisissez doit également être un spoke du hub. Vous pouvez saisir l'URI complet ou relatif. L'exemple suivant montre l'URI relatif :projects/PROJECT_ID/global/networks/NETWORK_NAME
.[EXCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à exclure de l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
. Les plages spécifiées doivent avoir un préfixe plus long ou être égales aux sous-réseaux configurés individuellement dans le VPC du producteur.[INCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à inclure dans l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
.GROUP_NAME
: groupe auquel appartient ce spoke, par exemple,center
ouedge
. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile (preview). Si vous utilisez la topologie en étoile, vous devez placer le spoke VPC de producteur dans le même groupe que le spoke VPC de consommateur existant. Pour en savoir plus sur les groupes de spokes, consultez la section Groupes de spokes.
API
Pour créer un spoke VPC de producteur, utilisez la méthode networkconnectivity.spokes.create
.
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/spokes/SPOKE_NAME { "hub":"HUB_NAME", "linkedProducerVpcNetwork": { "network": "CONSUMER_VPC_URI", "peering_name": "servicenetworking-googleapis-com", "include_export_ranges": "[INCLUDE_CIDR_RANGE]", "exclude_export_ranges": "[EXCLUDE_CIDR_RANGE]", "group": "GROUP_NAME" }, }
Le champ peering_name
doit être défini sur servicenetworking-googleapis-com
.
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le nouveau spokeHUB_NAME
: nom du hub auquel vous associez le spoke.SPOKE_NAME
: nom du spoke que vous créez.CONSUMER_VPC_URI
: réseau VPC qui consomme les services du producteur via une connexion d'appairage de réseaux VPC. Google Cloud identifie le réseau VPC du producteur via la connexion d'appairage. Le réseau client que vous saisissez doit également être un spoke du hub. Vous pouvez saisir l'URI complet ou relatif. L'exemple suivant montre l'URI relatif :projects/PROJECT_ID/global/networks/NETWORK_NAME
.[INCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à inclure dans l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
. Les plages spécifiées doivent avoir un préfixe plus long ou être égales aux sous-réseaux configurés individuellement dans le réseau VPC du producteur.[EXCLUDE_CIDR_RANGE]
: liste des plages d'adresses IP séparées par des virgules à exclure de l'exportation vers le hub (jusqu'à 16 plages CIDR), par exemple10.1.0.0/16, 192.168.0.0/24, 172.16.1.1/32
.GROUP_NAME
: groupe auquel appartient ce spoke. Les valeurs acceptées sontdefault
pour un hub avec topologie de maillage, etcenter
ouedge
pour un hub avec topologie en étoile. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile (preview). Si vous utilisez la topologie en étoile, vous devez placer le spoke VPC de producteur dans le même groupe que le spoke VPC de consommateur existant. Pour en savoir plus sur les groupes de spokes, consultez la section Groupes de spokes.
Créer un spoke d'appareil de routeur
Si vous utilisez un spoke de dispositif de routeur pour vous connecter à des sites en dehors de Google Cloud, suivez les instructions ci-dessous :
Contrairement aux spokes de rattachement de VLAN et de VPN, un spoke d'appareil de routeur ne doit pas nécessairement être associé à un seul emplacement en dehors de Google Cloud. Cependant, étant donné que les instances d'appareil de routeur sont des ressources régionales, nous vous recommandons de les configurer pour recevoir des données à partir d'emplacements proches.
Si vous configurez plusieurs instances d'appareil de routeur pour recevoir les données du même ensemble de sites, nous vous recommandons d'associer ces instances au même spoke.
Si vous utilisez un spoke d'appareil de routeur pour le transfert de données de site à site, suivez les instructions suivantes :
- Si vous associez plusieurs instances d'appareil de routeur à un spoke, sachez que Network Connectivity Center ne fournit pas de transfert de données de site à site entre ces instances. Pour utiliser le transfert de données de site à site, vous devez configurer plusieurs spokes. En réponse, Network Connectivity Center permet le transfert de données entre ces spokes.
Après avoir créé un spoke d'appareil de routeur, vous devez configurer l'appairage BGP entre l'instance d'appareil de routeur et un routeur cloud situé dans la même région. Pour en savoir plus, consultez la section Créer des instances d'appareils de routeur.
Pour en savoir plus sur la configuration des ressources requises pour créer un spoke d'appareil de routeur, consultez la documentation suivante :
- Créer des instances d'appareils de routeur
- Présentation des appareils de routeur
- Documentation Cloud Router
- Documentation Compute Engine (VM)
Console
Saisir les détails de base des spokes
- Dans Google Cloud Console, accédez à la page Network Connectivity Center. Accéder à Network Connectivity Center
- Dans le menu du projet, sélectionnez un projet Google Cloud.
- Cliquez sur l'onglet Spokes.
- Cliquez sur Ajouter des spokes.
- Dans le formulaire Nouveau spoke, définissez le type de spoke.
- Saisissez un Nom de spoke et, éventuellement, une Description.
- Sélectionnez le champ Région du nouveau spoke.
- Sous Transfert de données de site à site, sélectionnez Activé ou Désactivé. Si la région que vous avez sélectionnée n'est pas compatible avec le transfert de données, le champ est désactivé. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
- Dans la liste Réseau VPC, sélectionnez un réseau. Si plusieurs spokes utilisent la fonctionnalité de transfert de données, ils doivent tous se trouver sur le même réseau VPC. Ainsi, si vous avez déjà créé un spoke qui utilise le transfert de données, la valeur Réseau VPC est pré-remplie et ne peut pas être modifiée.
Saisissez les détails de l'appareil de routeur
- Choisissez une instance d'appareil de routeur:
- Cliquez sur Ajouter une instance.
- Dans le menu déroulant Instances, sélectionnez une instance d'appareil de routeur existante.
- Facultatif: pour propager les sous-réseaux annoncés sur le hub vers les spokes hybrides, sous Filtre de spoke hybride, cliquez sur Inclure toutes les plages IPv4 du hub au spoke.
- Pour ajouter d'autres instances d'appareil de routeur à ce spoke, répétez l'étape précédente. Lorsque vous avez terminé, cliquez sur OK et passez à l'étape Enregistrer votre spoke.
Enregistrer votre spoke
- Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un Nom de spoke.
- Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page Network Connectivity Center est mise à jour et affiche les détails des spokes que vous avez créés.
gcloud
Pour créer un spoke d'appareil de routeur, utilisez la commande gcloud network-connectivity spokes linked-router-appliances create
.
Par exemple, pour créer un spoke comportant deux instances de dispositif de routeur et utilisant le transfert de données de site à site, exécutez la commande suivante :
Pour activer l'importation de plages d'adresses IP de sous-réseau dans cette branche (Preview, version Preview), utilisez l'indicateur --include-import-ranges
.
gcloud network-connectivity spokes linked-router-appliances create NAME \ --hub=HUB_NAME \ --description="DESCRIPTION" \ --router-appliance=instance="ROUTER_APPLIANCE_URI",ip=IP_ADDRESS \ --router-appliance=instance="ROUTER_APPLIANCE_URI_2",ip=IP_ADDRESS_2 \ --region=REGION \ --labels="KEY"="VALUE" \ --site-to-site-data-transfer \ --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]
Remplacez les valeurs suivantes :
NAME
: le nom du spokeHUB_NAME
: nom du hubDESCRIPTION
: texte facultatif décrivant le spokeROUTER_APPLIANCE_URI
: URI de la première instance d'appareil de routeur. Par exemple :https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
IP_ADDRESS
: adresse IP interne de la première instance d'appareil de routeurROUTER_APPLIANCE_URI_2
: URI de la deuxième instance d'appareil de routeurIP_ADDRESS_2
: adresse IP interne de la deuxième instance d'appareil de routeurREGION
: région Google Cloud dans laquelle se trouve le spoke. Par exemple,us-west1
KEY
: clé de la paire clé/valeur pour le texte du libellé facultatifVALUE
: valeur de la paire clé/valeur pour le texte de l'étiquette facultative[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Utilisez l'option site-to-site-data-transfer
si vous souhaitez activer le transfert de données pour le spoke. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
API
Pour créer un spoke d'appareil de routeur, utilisez la méthode networkconnectivity.spokes.create
.
Par exemple, pour créer un spoke contenant deux instances d'appareil de routeur, utilisez la requête suivante :
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME { "hub": "HUB_NAME", "labels": {"KEY": "VALUE"}, "linkedRouterApplianceInstances": { "instances": [ { "virtualMachine": "ROUTER_APPLIANCE_URI", "ipAddress": "IP_ADDRESS", }, { "virtualMachine": "ROUTER_APPLIANCE_URI_2, "ipAddress": "IP_ADDRESS_2", } ], "siteToSiteDataTransfer": BOOLEAN "includeImportRanges": [INCLUDE_IMPORT_RANGES,...] } }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID de votre projetREGION
: région Google Cloud dans laquelle vous souhaitez localiser le spoke, par exempleus-west1
SPOKE_NAME
: nom du spokeHUB_NAME
: nom du hub auquel vous associez le spokeKEY
: clé de la paire clé/valeur pour le texte de l'étiquette facultativeVALUE
: valeur de la paire clé/valeur pour le texte du libellé facultatifROUTER_APPLIANCE_URI
: URI de la première instance d'appareil de routeur. Par exemple :https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
IP_ADDRESS
: adresse IP interne de la première instance d'appareil de routeurROUTER_APPLIANCE_URI_2
: URI de la deuxième instance d'appareil de routeurIP_ADDRESS_2
: adresse IP interne de la deuxième instance d'appareil de routeur[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Créer un spoke de rattachement de VLAN
Avant de créer des spokes de rattachement de VLAN, tenez compte des consignes suivantes :
- Si des connexions par interconnexion dédiée ou par interconnexion partenaire sont configurées dans une configuration redondante pour le même site, vous devez configurer les deux connexions en un seul spoke. Les rattachements de VLAN redondants associés à ces connexions d'interconnexion doivent être situés dans la même région Google Cloud. Pour en savoir plus sur les configurations redondantes, consultez la page Bonnes pratiques pour Cloud Interconnect.
- Si vous souhaitez utiliser des connexions par interconnexion provenant de régions différentes, vous devez les configurer en tant que spokes différents.
Pour en savoir plus sur la configuration des ressources requises pour créer un spoke de rattachement de VLAN, consultez la documentation suivante :
Pour en savoir plus sur la vérification des ressources de rattachement de VLAN, consultez la documentation suivante :
- Obtenir des diagnostics Cloud Interconnect
- Afficher les détails sur une interconnexion dédiée
- Afficher des rattachements de VLAN
Console
Saisir les détails de base des spokes
- Dans Google Cloud Console, accédez à la page Network Connectivity Center. Accéder à Network Connectivity Center
- Dans le menu du projet, sélectionnez un projet Google Cloud.
- Cliquez sur l'onglet Spokes.
- Cliquez sur Ajouter des spokes.
- Dans le formulaire Nouveau spoke, définissez le type de spoke.
- Saisissez un Nom de spoke et, éventuellement, une Description.
- Sélectionnez le champ Région du nouveau spoke.
- Sous Transfert de données de site à site, sélectionnez Activé ou Désactivé. Si la région que vous avez sélectionnée n'est pas compatible avec le transfert de données, le champ est désactivé. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
- Dans la liste Réseau VPC, sélectionnez un réseau. Si plusieurs spokes utilisent la fonctionnalité de transfert de données, ils doivent tous se trouver sur le même réseau VPC. Ainsi, si vous avez déjà créé un spoke qui utilise le transfert de données, la valeur Réseau VPC est pré-remplie et ne peut pas être modifiée.
Saisir les détails du rattachement de VLAN
- Choisissez un rattachement de VLAN :
- Cliquez sur Ajouter un rattachement.
- Dans le menu déroulant Rattachements de VLAN, sélectionnez un rattachement existant.
- Vous pouvez éventuellement propager les sous-réseaux annoncés sur le hub vers les spokes hybrides. Pour ce faire, sous Filtre de spoke hybride, cliquez sur Inclure toutes les plages IPv4 du hub au spoke.
- Pour ajouter d'autres rattachements à ce spoke, répétez l'étape précédente. Lorsque vous avez terminé, cliquez sur OK et passez à l'étape Enregistrer votre spoke.
Enregistrer votre spoke
- Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un Nom de spoke.
- Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page Network Connectivity Center est mise à jour et affiche les détails des spokes que vous avez créés.
gcloud
Pour créer un spoke de rattachement de VLAN, utilisez la commande gcloud network-connectivity spokes linked-interconnect-attachments create
.
Par exemple, pour créer un spoke comportant deux rattachements de VLAN et utilisant le transfert de données de site à site, exécutez la commande suivante.
Pour activer l'importation de plages d'adresses IP de sous-réseau dans cette branche (Preview, version Preview), utilisez l'indicateur --include-import-ranges
.
gcloud network-connectivity spokes linked-interconnect-attachments create SPOKE_NAME \ --hub=HUB_NAME \ --description="DESCRIPTION" \ --interconnect-attachments=VLAN_ATTACHMENT_NAME,VLAN_ATTACHMENT_NAME_2 \ --region=REGION \ --labels="KEY"="VALUE" \ --site-to-site-data-transfer \ --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]
Remplacez les valeurs suivantes :
SPOKE_NAME
: nom du spokeHUB_NAME
: nom du hub, au format URI, auquel vous associez le spoke. Exemple :projects/myproject/locations/global/hubs/us-west-to-uk
DESCRIPTION
: texte facultatif décrivant le spokeVLAN_ATTACHMENT_NAME
: nom du premier rattachement de VLAN à ajouter au spokeVLAN_ATTACHMENT_NAME_2
: nom du deuxième rattachement de VLAN. Si vous incluez un deuxième rattachement, veillez à omettre l'espace entre la virgule et le nom du rattachement.REGION
: région Google Cloud dans laquelle se trouve le spokeKEY
: clé de la paire clé/valeur pour le texte du libelléVALUE
: valeur de la paire clé/valeur pour le texte du libellé[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Utilisez l'option site-to-site-data-transfer
si vous souhaitez activer le transfert de données pour le spoke. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
API
Pour créer un spoke de rattachement de VLAN, utilisez la méthode networkconnectivity.spokes.create
.
Par exemple, pour créer un spoke contenant deux rattachements de VLAN et pour lequel l'importation de plages d'adresses IP de sous-réseau est activée (Preview, version bêta), utilisez la requête suivante:
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME { "hub": "HUB_NAME", "labels": {"KEY": "VALUE"}, "linkedInterconnectAttachments": { "uris": [ "VLAN_ATTACHMENT_NAME", "VLAN_ATTACHMENT_NAME_2" ], "siteToSiteDataTransfer": BOOLEAN "includeImportRanges": [INCLUDE_IMPORT_RANGES,...] } }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID de votre projetREGION
: région Google Cloud dans laquelle vous souhaitez localiser le spoke, par exempleus-west1
SPOKE_NAME
: nom du spokeHUB_NAME
: nom du hub auquel vous associez le spokeKEY
: clé de la paire clé/valeur pour le texte de l'étiquette facultativeVALUE
: valeur de la paire clé/valeur pour le texte du libellé facultatifVLAN_ATTACHMENT_NAME
: nom du premier rattachement de VLAN à ajouter au spokeVLAN_ATTACHMENT_NAME_2
: nom du deuxième rattachement de VLANBOOLEAN
: valeur qui détermine si le transfert de données de site à site est activé pour ce spoke. Pour plus d'informations sur ce cas d'utilisation, consultez la page Présentation du transfert de données de site à site.[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Créer un spoke de VPN
Avant de créer des spokes de VPN, tenez compte des instructions suivantes :
Lorsque vous associez des tunnels VPN haute disponibilité à un spoke, nous vous recommandons de configurer ensemble dans un seul spoke tous les tunnels qui se connectent à un seul site. L'inverse est également vrai : deux tunnels se connectant à deux sites différents doivent être connectés à des spokes différents. Par exemple, supposons que vous souhaitiez connecter un bureau à Dallas et un bureau à Tokyo. Le tunnel qui se connecte à Dallas doit faire partie d'un spoke différent de celui qui relie votre réseau VPC à Tokyo.
Lorsque vous associez des tunnels VPN haute disponibilité à un spoke, vous ne pouvez pas connecter les passerelles VPN haute disponibilité de différentes régions entre elles au sein du même projet Google Cloud. Il s'agit d'une limitation liée au VPN haute disponibilité, et non à une limitation du centre de connectivité réseau.
Pour plus d'informations sur la configuration des ressources requises pour créer un spoke de VPN, consultez la documentation suivante :
Pour plus d'informations sur la vérification des ressources VPN, consultez la page Vérifier l'état des VPN haute disponibilité.
Console
Saisir les détails de base des spokes
- Dans Google Cloud Console, accédez à la page Network Connectivity Center. Accéder à Network Connectivity Center
- Dans le menu du projet, sélectionnez un projet Google Cloud.
- Cliquez sur l'onglet Spokes.
- Cliquez sur Ajouter des spokes.
- Dans le formulaire Nouveau spoke, définissez le type de spoke.
- Saisissez un Nom de spoke et, éventuellement, une Description.
- Sélectionnez le champ Région du nouveau spoke.
- Sous Transfert de données de site à site, sélectionnez Activé ou Désactivé. Si la région que vous avez sélectionnée n'est pas compatible avec le transfert de données, le champ est désactivé. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
- Dans la liste Réseau VPC, sélectionnez un réseau. Si plusieurs spokes utilisent la fonctionnalité de transfert de données, ils doivent tous se trouver sur le même réseau VPC. Ainsi, si vous avez déjà créé un spoke qui utilise le transfert de données, la valeur Réseau VPC est pré-remplie et ne peut pas être modifiée.
Saisir les détails du tunnel VPN
- Définissez la liste déroulante Type de spoke sur Tunnels VPN.
- Sélectionnez la région du spoke.
- Choisissez un tunnel :
- Cliquez sur Ajouter un tunnel.
- Dans le menu déroulant Tunnels VPN, sélectionnez un tunnel existant.
- Vous pouvez éventuellement propager les sous-réseaux annoncés sur le hub vers les spokes hybrides. Pour ce faire, sous Filtre de spoke hybride, cliquez sur Inclure toutes les plages IPv4 du hub au spoke.
- Pour ajouter d'autres tunnels à ce spoke, répétez l'étape précédente. Lorsque vous avez terminé, cliquez sur OK et passez à l'étape Enregistrer votre spoke.
Enregistrer votre spoke
- Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un Nom de spoke.
- Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page Network Connectivity Center est mise à jour et affiche les détails des spokes que vous avez créés.
gcloud
Pour créer une instance satellite contenant un tunnel VPN haute disponibilité, utilisez la commande gcloud network-connectivity spokes linked-vpn-tunnels create
.
Par exemple, pour créer un spoke comportant deux tunnels VPN haute disponibilité et utilisant le transfert de données de site à site, saisissez la commande suivante.
Pour activer l'importation de plages d'adresses IP de sous-réseau dans cette branche (Preview, version Preview), utilisez l'indicateur --include-import-ranges
.
gcloud network-connectivity spokes linked-vpn-tunnels create SPOKE_NAME \ --hub=HUB_NAME \ --description="DESCRIPTION" \ --vpn-tunnels=TUNNEL_NAME,TUNNEL_NAME_2 \ --region=REGION \ --labels="KEY"="VALUE" \ --site-to-site-data-transfer \ --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]
Remplacez les valeurs suivantes :
SPOKE_NAME
: nom du spokeHUB_NAME
: nom du hub, au format URI, auquel vous associez le spoke. Exemple :projects/PROJECT_ID/locations/global/hubs/us-west-to-uk
DESCRIPTION
: texte facultatif décrivant le spoke. Par exemple :us-vpn-spoke
TUNNEL_NAME
: nom du premier tunnel VPN haute disponibilité à ajouter au spokeTUNNEL_NAME_2
: nom du deuxième tunnel VPN haute disponibilité. Si vous utilisez un deuxième tunnel, veillez à omettre l'espace entre la virgule et le nom du second tunnel.REGION
: région Google Cloud dans laquelle se trouve le spokeKEY
: clé de la paire clé/valeur pour le texte du libellé facultatifVALUE
: valeur de la paire clé/valeur pour le texte de l'étiquette facultative[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Utilisez l'option site-to-site-data-transfer
si vous souhaitez activer le transfert de données pour le spoke. Pour plus d'informations sur ce cas d'utilisation, consultez la section Présentation du transfert de données de site à site.
API
Pour créer un spoke de VPN, utilisez la méthode networkconnectivity.spokes.create
.
Par exemple, pour créer un spoke contenant deux tunnels VPN haute disponibilité et pour lequel l'option "Inclure les plages d'adresses IP de sous-réseau d'importation" est activée, utilisez la requête suivante:
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME { "hub": "HUB_NAME", "labels": {"KEY": "VALUE"}, "linkedVpnTunnels": { "uris": [ "TUNNEL_NAME", "TUNNEL_NAME_2" ], "siteToSiteDataTransfer": BOOLEAN, "includeImportRanges": [INCLUDE_IMPORT_RANGES,...] } }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID de votre projetREGION
: région Google Cloud dans laquelle vous souhaitez localiser le spoke, par exempleus-west1
SPOKE_NAME
: nom du spokeHUB_NAME
: nom du hub auquel vous associez le spokeKEY
: clé de la paire clé/valeur pour le texte de l'étiquette facultativeVALUE
: valeur de la paire clé/valeur pour le texte du libellé facultatifTUNNEL_NAME
: nom du premier tunnel VPN haute disponibilité à ajouter au spokeTUNNEL_NAME_2
: nom du deuxième tunnel VPN haute disponibilitéBOOLEAN
: valeur qui détermine si le transfert de données de site à site est activé pour ce spoke. Pour plus d'informations sur ce cas d'utilisation, consultez la page Présentation du transfert de données de site à site.[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Répertorier les spokes
Lorsque vous créez un spoke, celui-ci est toujours associé à un hub. Vous pouvez utiliser l'opération list spokes
pour lister tous les spokes d'un même projet. Vous pouvez également lister tous les spokes associés à un hub dans plusieurs projets. Consultez également la section Décrire un hub.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu des projets, sélectionnez le projet contenant le hub pour lequel vous souhaitez lister les spokes existants.
Dans l'onglet Hub, sélectionnez le hub.
Cliquez sur l'onglet Spoke. Tous les spokes associés à ce hub sont listés.
Utilisez le champ Filtre pour trier les spokes par nom, type, état, ID, région, nombre de ressources, sessions BGP ou description.
Pour afficher les détails d'un spoke spécifique, cliquez sur son nom.
gcloud
Pour répertorier les spokes existants d'un projet, exécutez la commande gcloud network-connectivity spokes list
.
gcloud network-connectivity spokes list \ --region=LOCATION
Remplacez LOCATION
par la région appropriée.
Pour répertorier les spokes VPC existants dans un projet, utilisez la même commande avec l'option --global
:
gcloud network-connectivity spokes list \ --global
Pour répertorier tous les spokes associés à un hub dans tous les projets, exécutez la commande gcloud network-connectivity hubs list-spokes
.
gcloud network-connectivity hubs list-spokes HUB_NAME
Remplacez HUB_NAME
par le nom du hub pour lequel vous souhaitez lister les spokes, par exemple my-hub
.
Filtres
Pour lister tous les spokes VPC appartenant à un groupe spécifique, utilisez la commande gcloud network-connectivity hubs list-spokes
et spécifiez le filtre group
.
gcloud network-connectivity hubs list-spokes HUB_NAME \ --filter="group:GROUP_NAME"
Remplacez les valeurs suivantes :
HUB_NAME
: nom du hub pour lequel vous souhaitez lister les spokes.GROUP_NAME
: nom du groupe de spokes. Les valeurs acceptées sontdefault
pour la topologie de maillage, etcenter
ouedge
pour un hub avec topologie en étoile.
Pour lister tous les spokes VPC associés à un hub qui sont en attente d'examen par l'administrateur du hub, utilisez la même commande et spécifiez le filtre reason
.
gcloud network-connectivity hubs list-spokes HUB_NAME \ --filter="reason:PENDING_REVIEW"
Remplacez HUB_NAME
par le nom du hub pour lequel vous souhaitez lister les spokes.
Pour lister tous les spokes VPC inactifs associés à un hub, exécutez la même commande et spécifiez le filtre state
.
gcloud network-connectivity hubs list-spokes HUB_NAME \ --filter="state:INACTIVE"
Remplacez HUB_NAME
par le nom du hub pour lequel vous souhaitez lister les spokes inactifs.
API
Pour répertorier les spokes existants d'un projet, utilisez la méthode networkconnectivity.spokes.list
.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant les spokes à répertorierLOCATION
: région où se trouve le spoke. Par exemple,us-west1
ouglobal
pour les spokes VPC
Pour répertorier tous les spokes associés à un hub dans tous les projets, utilisez la méthode networkconnectivity.hubs.listSpokes
.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet du hubHUB_NAME
: nom du hub pour lequel vous souhaitez répertorier les spokes
Pour obtenir une liste agrégée des spokes existants dont les valeurs de plusieurs lignes sont regroupées pour former une seule valeur de résumé, utilisez la méthode networkconnectivity.spokes.list
avec un trait d'union (-
) après locations
en tant que caractère générique.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/-/spokes
Remplacez PROJECT_ID
par l'ID du projet contenant les rayons à répertorier.
Décrire un spoke
Pour obtenir des informations détaillées sur un spoke existant, suivez les instructions ci-dessous.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Dans l'onglet Hub, sélectionnez le hub. Tous les spokes associés à ce hub sont listés.
Pour afficher les détails d'un spoke spécifique, effectuez l'une des opérations suivantes :
- Dans la colonne Nom du spoke, sélectionnez un spoke pour afficher la page Détails du spoke.
- Dans l'onglet Spokes, cliquez sur la colonne Nom du spoke, puis sélectionnez un spoke pour afficher la page Détails du spoke.
gcloud
Pour décrire un spoke, utilisez la commande gcloud network-connectivity spokes describe
.
gcloud network-connectivity spokes describe SPOKE_NAME \ --region=LOCATION
Remplacez les valeurs suivantes :
SPOKE_NAME
: le nom du spokeLOCATION
: région où se trouve le spoke
Pour décrire un spoke VPC, utilisez la même commande avec l'option --global
:
gcloud network-connectivity spokes describe SPOKE_NAME \ --global
Remplacez SPOKE_NAME
par le nom du spoke.
API
Pour décrire un spoke, utilisez la méthode networkconnectivity.spokes.get
.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes/SPOKE_NAME
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le spokeLOCATION
: région où se trouve le spoke. Par exemple,us-west1
ouglobal
pour les spokes VPCSPOKE_NAME
: le nom du spoke
Mettre à jour un spoke
Une fois le spoke créé, vous pouvez mettre à jour les éléments suivants :
- Description du spoke
- Les libellés appliqués au spoke ; Pour en savoir plus sur les libellés, consultez la page Conditions requises pour les libellés.
- Si le spoke est un spoke de dispositif de routeur, vous pouvez modifier ses ressources sous-jacentes : Cependant, les nouvelles ressources doivent se trouver sur le même réseau VPC que les ressources d'origine.
- Les plages d'adresses IP à importer à partir des sous-réseaux du hub
Console
Pour modifier les ressources utilisées par un dispositif de routeur, procédez comme suit :
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Cliquez sur l'onglet Spokes.
Cliquez sur le nom du spoke à modifier.
Effectuez l'une des opérations suivantes :
- Pour ajouter des ressources, cliquez sur Ajouter des instances et suivez les instructions pour sélectionner une ou plusieurs VM. Lorsque vous avez terminé, cliquez sur OK.
- Pour supprimer des ressources, sélectionnez les VM à supprimer, puis cliquez sur Supprimer les instances. Dans la boîte de dialogue de confirmation, cliquez sur OK.
gcloud
Pour mettre à jour un spoke, utilisez l'une des commandes suivantes :
gcloud network-connectivity spokes linked-router-appliances update
gcloud network-connectivity spokes linked-interconnect-attachments update
gcloud network-connectivity spokes linked-vpn-tunnels update
gcloud network-connectivity spokes linked-vpc-network update
gcloud network-connectivity spokes linked-producer-vpc-network update
Vous pouvez modifier les plages d'adresses IP spécifiées pour être importées à partir des sous-réseaux du hub en ajoutant ALL_IPV4_RANGES
à la liste pour tous les types de spoke hybrides.
Modifier la description et les libellés, et inclure des plages d'adresses IP
Pour mettre à jour la description et le libellé d'un spoke d'appareil de routeur, et inclure des plages d'adresses IP, exécutez la commande suivante:
gcloud network-connectivity spokes linked-router-appliances update SPOKE_NAME \ --description="DESCRIPTION" \ --region=LOCATION \ --update-labels="KEY"="VALUE" \ --include-import-ranges="[INCLUDE_IMPORT_RANGES,...]"
Remplacez les valeurs suivantes :
SPOKE_NAME
: nom du spoke à mettre à jourDESCRIPTION
: nouvelle description du spokeLOCATION
: région Google Cloud dans laquelle se trouve le spoke. Par exemple,us-west1
ouglobal
KEY
: clé de la paire clé/valeurVALUE
: valeur de la paire clé/valeur[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Mettre à jour les ressources sous-jacentes d'un spoke d'appareil de routeur
Si nécessaire, vous pouvez mettre à jour un spoke d'appareil de routeur pour utiliser une autre instance d'appareil de routeur, à condition que la nouvelle ressource se trouve sur le même réseau VPC que l'instance d'origine. Pour remplacer la ressource existante par une nouvelle, exécutez la commande suivante :
gcloud network-connectivity spokes linked-router-appliances update SPOKE_NAME \ --region=LOCATION \ --router-appliance=instance="ROUTER_APPLIANCE_URI",ip=IP_ADDRESS
Remplacez les valeurs suivantes :
SPOKE_NAME
: le nom du spokeLOCATION
: région Google Cloud dans laquelle se trouve le spoke. Par exemple,us-west1
ROUTER_APPLIANCE_URI
: URI de la nouvelle instance d'appareil de routeur à associer au spoke. Par exemple :"https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
IP_ADDRESS
: adresse IP interne de la nouvelle instance d'appareil de routeur
API
Pour mettre à jour un spoke, utilisez la méthode networkconnectivity.spokes.patch
.
Mettre à jour la description et les libellés
Pour mettre à jour la description et le libellé d'un spoke de serveur, utilisez la requête suivante :
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE_NAME { "description": "DESCRIPTION" "labels": { "KEY": "VALUE" "includeImportRanges": [INCLUDE_IMPORT_RANGES,...] } }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le spokeREGION
: région où se trouve le spoke. Par exemple,us-west1
SPOKE_NAME
: nom du spoke à mettre à jourDESCRIPTION
: nouvelle description du spokeKEY
: clé de la paire clé/valeurVALUE
: valeur de la paire clé/valeur[INCLUDE_IMPORT_RANGES,...]
: plages d'adresses IP spécifiées pour être importées à partir de sous-réseaux de hub. Vous ne pouvez ajouter queALL_IPV4_RANGES
à la liste. S'il est vide, le spoke n'importe aucun sous-réseau du hub.
Mettre à jour les ressources sous-jacentes d'un spoke d'appareil de routeur
Si nécessaire, vous pouvez mettre à jour un spoke d'appareil de routeur pour utiliser une autre instance d'appareil de routeur, à condition que la nouvelle ressource se trouve sur le même réseau VPC que l'instance d'origine. Pour remplacer la ressource existante par une nouvelle, exécutez la requête suivante :
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE { "linkedRouterApplianceInstances": { "instances": [ { "virtualMachine": "ROUTER_APPLIANCE_URI", "ipAddress": "IP_ADDRESS", } ] } }
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le spokeREGION
: région où se trouve le spoke. Par exemple,us-west1
SPOKE
: le nom du spokeROUTER_APPLIANCE_URI
: URI de la nouvelle instance d'appareil de routeur à associer au spoke. Par exemple :"https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"
IP_ADDRESS
: adresse IP interne de la nouvelle instance d'appareil de routeur
Supprimer un spoke
Lorsque vous supprimez un spoke, vous dissociez également les ressources de ce spoke. En d'autres termes, la suppression d'un spoke ne supprime pas les ressources, mais les dissocie simplement du spoke.
Si vous souhaitez supprimer un spoke VPC associé à un spoke VPC de producteur (Preview), vous devez d'abord supprimer le spoke VPC de producteur.
Console
Dans Google Cloud Console, accédez à la page Network Connectivity Center.
Dans le menu "projet", sélectionnez un projet.
Cliquez sur l'onglet Spokes.
Affichez la liste des noms de spoke du projet.
Sélectionnez les spokes à supprimer.
Cliquez sur
Supprimer les spokes.Dans la boîte de dialogue de confirmation, effectuez l'une des opérations suivantes :
- Cliquez sur Annuler si vous ne souhaitez pas supprimer les spokes.
- Cliquez sur Supprimer pour supprimer les spokes.
gcloud
Pour supprimer un spoke, utilisez la commande gcloud network-connectivity spokes delete
.
gcloud network-connectivity spokes delete SPOKE_NAME \ --region=REGION
Remplacez les valeurs suivantes :
SPOKE_NAME
: nom du spoke à supprimerREGION
: région où se trouve le spoke. Cette option est obligatoire en plus de la région indiquée dans le nom complet du spoke. Si vous supprimez un spoke VPC, vous devez spécifier--global
.
API
Pour supprimer un spoke existant, utilisez la méthode networkconnectivity.spokes.delete
.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/spokes/SPOKE_NAME
Remplacez les valeurs suivantes :
PROJECT_ID
: ID du projet contenant le spoke à supprimerLOCATION
: région où se trouve le spoke. Par exemple,us-west1
ou--global
pour les spokes VPCSPOKE_NAME
: nom du spoke à supprimer
Étapes suivantes
- Pour afficher la liste des partenaires dont les solutions sont intégrées à Network Connectivity Center, consultez la page Partenaires Network Connectivity Center.
- Pour trouver des solutions aux problèmes liés à l'appliance de routeur, consultez la section Dépannage.
- To get details about API and Google Cloud CLI commands, see APIs and reference.