Configurer NCC et créer un hub

Cette page explique comment créer un hub Network Connectivity Center (NCC) à l'aide de la topologie d'inspection hybride afin de pouvoir ajouter des spokes de passerelle NCC et des spokes VPC au hub.

Pour une présentation de la passerelle NCC, consultez Présentation de la passerelle NCC.

Avant de commencer

Avant de commencer, consultez les sections suivantes.

Créer ou sélectionner un projet

Pour faciliter la configuration de NCC, commencez par identifier un projet valide.

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  8. Verify that billing is enabled for your Google Cloud project.

  9. Install the Google Cloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command:

    gcloud init
  12. 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.

  13. 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

Avant de pouvoir effectuer toute tâche à l'aide de la passerelle NCC, vous devez activer l'API Network Connectivity.

Console

Pour activer l'API Network Connectivity, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Network Connectivity Center.

    Accéder à Network Connectivity Center

  2. Cliquez sur Activer.

Vous pouvez également activer l'API à l'aide de la bibliothèque d'API de la consoleGoogle Cloud , comme décrit dans la section Activer des API.

Obtenir l'accès

Pour utiliser NCC et la passerelle NCC, 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 d'appareil 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"

    

Créer un hub NCC

Pour créer un hub NCC avec la topologie d'inspection hybride prédéfinie, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Network Connectivity Center.

    Accéder à Network Connectivity Center

  2. Dans le menu "projet", sélectionnez un projet.

  3. Cliquez sur Créer un hub.

  4. Facultatif : Choisissez le mode de règle du hub.

  5. Renseignez la section Configuration de base du formulaire :

    1. Saisissez un nom de hub.
    2. Facultatif : saisissez une Description.
    3. Facultatif : pour ajouter un libellé, cliquez sur Ajouter un élément, puis saisissez une clé et une valeur.
    4. 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.
  6. Facultatif : Pour activer la propagation de connexion Private Service Connect, cliquez sur Activé dans le champ Propagation de connexion Private Service Connect.

  7. 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 Créer un spoke de passerelle NCC.
    • Si vous ne souhaitez pas créer de spoke maintenant, cliquez sur Créer pour terminer la création du hub.

gcloud

Exécutez la commande gcloud network-connectivity hubs create et spécifiez la topologie d'inspection hybride prédéfinie.

gcloud beta network-connectivity hubs create HUB_NAME \
    --preset-topology=hybrid-inspection

Remplacez HUB_NAME par le nom du nouveau hub.

API

Exécutez la méthode projects.locations.global.hubs.create.

POST https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/hubs
{
  "name":"HUB_NAME",
  "description":"DESCRIPTION",
  "labels": {
    "KEY": "VALUE"
  },
  "presetTopology": "HYBRID_INSPECTION"
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le nouveau hub
  • HUB_NAME : nom du nouveau hub
  • DESCRIPTION : texte facultatif décrivant le hub
  • KEY : clé de la paire clé/valeur pour le texte du libellé facultatif
  • VALUE : valeur de la paire clé/valeur pour le texte de l'étiquette facultative

Connecter des réseaux VPC au hub

La procédure de connexion des réseaux VPC à un hub diffère selon que le réseau et le hub se trouvent dans le même projet ou non.

Connecter des réseaux VPC et un hub de différents projets

Pour connecter des réseaux VPC de différents projets, procédez comme suit :

Connecter des réseaux VPC et un hub dans le même projet

Si les réseaux VPC et le hub se trouvent dans le même projet, procédez comme suit :

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 spoke.

Pour créer un spoke VPC, procédez comme suit.

Console

  1. Dans la console Google Cloud , accédez à la page Network Connectivity Center.

    Accéder à Network Connectivity Center

  2. Dans le menu "projet", sélectionnez le projet dans lequel vous souhaitez créer le spoke.

  3. Cliquez sur l'onglet Spokes.

  4. Cliquez sur Ajouter des spokes.

  5. 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é.

  6. Saisissez un Nom de spoke et, éventuellement, une Description.

  7. En fonction de la topologie du hub auquel vous vous connectez, choisissez le groupe de spokes pour votre spoke. Vous pouvez choisir parmi les valeurs suivantes :

    • Par défaut pour un hub avec topologie maillée
    • Center ou Edge pour un hub de topologie en étoile. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile.
    • Prod, Non-prod ou Services pour un hub qui utilise la topologie d'inspection hybride (uniquement pour les spokes de passerelle NCC)

    Pour en savoir plus sur les groupes de spokes, consultez Groupes de spokes.

  8. Sélectionnez Réseau VPC comme Type de spoke.

  9. Pour ajouter un réseau VPC au spoke, sélectionnez-en un dans la liste Réseau VPC associé.

  10. Facultatif : ajoutez un filtre de spoke VPC pour personnaliser l'annonce des routes en spécifiant des plages d'adresses IP afin d'exclure ou d'inclure l'exportation du spoke vers le hub. Vous pouvez configurer le spoke pour qu'il n'exporte que les plages de sous-réseaux qui utilisent des adresses IPv4 privées, que les plages de sous-réseaux IPv6 (internes et externes), ou à la fois les plages de sous-réseaux qui utilisent des adresses IPv4 privées et les plages de sous-réseaux IPv6 internes et externes.

    1. Plages IPv4 : configurez l'exportation des plages de sous-réseaux IPv4.

      • Inclure l'exportation des plages de sous-réseaux IPv4 du spoke vers le hub : par défaut, cette case est cochée et toutes les plages de sous-réseaux qui utilisent des adresses IPv4 privées sont exportées.

        Si vous ne souhaitez pas exporter les plages de sous-réseaux IPv4, décochez cette case.

        Si vous ne souhaitez exporter que des plages de sous-réseaux IPv4 spécifiques, sélectionnez Spécifier des plages IPv4, puis saisissez les plages d'adresses que vous souhaitez exporter. Les plages de sous-réseaux IPv4 que vous spécifiez doivent être des plages d'adresses IPv4 privées, à l'exclusion des adresses IPv4 publiques utilisées en mode privé. Pour en savoir plus, consultez Plages IPv4 valides.

      • Exclure l'exportation des plages de sous-réseaux IPv4 du spoke vers le hub : si le spoke exporte des plages de sous-réseaux et que vous souhaitez exclure des plages spécifiques de l'exportation, saisissez ces plages dans ce champ.

    2. Plages IPv6 : configurez l'exportation des plages de sous-réseaux IPv6 (internes et externes).

      • Inclure l'exportation de toutes les plages de sous-réseaux IPv6 du spoke vers le hub : cochez la case pour exporter toutes les plages de sous-réseaux IPv6 vers le hub.

        Si vous ne souhaitez exporter que des plages de sous-réseaux IPv6 spécifiques, sélectionnez Spécifier des plages IPv6, puis saisissez les plages d'adresses que vous souhaitez exporter.

      • Exclure l'exportation des plages de sous-réseaux IPv6 du spoke vers le hub : si le spoke exporte des plages de sous-réseaux et que vous souhaitez exclure des plages spécifiques de l'exportation, saisissez-les dans ce champ.

  11. Cliquez sur OK.

  12. Si vous souhaitez ajouter d'autres spokes, cliquez sur Ajouter un spoke, puis recommencez le processus en saisissant un Nom de spoke.

  13. Lorsque vous avez terminé d'ajouter des spokes, cliquez sur Créer. La page NCC 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 \
    --include-export-ranges=[INCLUDE_EXPORT_RANGES] \
    --exclude-export-ranges=[EXCLUDE_EXPORT_RANGES] \
    --global \
    --group=GROUP_NAME

Remplacez les éléments suivants :

  • SPOKE_NAME : nom du spoke que vous créez, par exemple vpc-spoke1
  • HUB : hub du spoke
  • DESCRIPTION : description facultative du spoke
  • VPC_URI : réseau VPC vers lequel ce spoke pointe
  • INCLUDE_EXPORT_RANGES : liste de mots clés, de plages d'adresses IP ou d'une combinaison de mots clés et de plages d'adresses IP, séparés par des virgules, qui définissent les plages d'adresses IP de sous-réseau pouvant être exportées vers le hub.

    • Le mot clé ALL_PRIVATE_IPV4_RANGES ajoute toutes les plages de sous-réseaux qui utilisent des adresses IPv4 privées à la liste des plages d'exportation à inclure.

    • Le mot clé ALL_IPV4_RANGES inclut toutes les adresses IPv4, ce qui équivaut au CIDR 0.0.0.0/0. Toutes les plages IPv4 valides pour les plages de sous-réseaux, y compris les plages d'adresses IPv4 publiques utilisées en mode privé, sont incluses. Vous pouvez affiner la liste à l'aide de l'option --exclude-export-ranges.

    • Le mot clé ALL_IPV6_RANGES inclut toutes les adresses IPv6, ce qui équivaut au CIDR ::/0.

    • Les plages d'exportation incluse acceptent jusqu'à 16 CIDR uniques et non chevauchants. Aucun CIDR dans les plages d'exportation incluses ne peut correspondre à un autre CIDR ni en contenir un.

    • Si vous omettez --include-export-ranges pour un spoke VPC, les plages d'exportation incluses par défaut sont les mêmes que si vous aviez spécifié ALL_PRIVATE_IPV4_RANGES.

    • Les plages de sous-réseaux du spoke VPC, ses plages d'exportation d'inclusion et ses plages d'exportation d'exclusion doivent respecter les règles de filtrage d'exportation pour les spokes VPC.

  • EXCLUDE_EXPORT_RANGES : liste de plages d'adresses IP séparées par des virgules qui définissent les plages d'adresses IP de sous-réseau qui ne sont jamais exportées vers le hub.

    • Les plages d'exclusion des exportations acceptent jusqu'à 16 CIDR uniques et non chevauchants. Aucun CIDR dans les plages d'exclusion d'exportation ne peut correspondre à un autre CIDR ni en contenir un.

    • Chaque CIDR spécifié dans les plages d'exportation à exclure doit être développé en adresses IP entièrement contenues dans les CIDR ou les mots clés des plages d'exportation à inclure (ou dans les plages d'exportation à inclure par défaut, si vous n'en spécifiez aucune explicitement).

    • Les plages d'exportation à exclure ne sont pas compatibles avec les mots clés.

    • Si vous omettez --exclude-export-ranges, NCC utilise une liste vide comme plages d'exportation d'exclusion par défaut.

    • Les plages de sous-réseaux du spoke VPC, ses plages d'exportation incluses et ses plages d'exportation exclues doivent respecter les Règles de filtrage des exportations pour les spokes VPC.

  • GROUP_NAME : groupe auquel appartient ce spoke. Valeurs acceptées :

    • Default pour un hub avec topologie maillée
    • Center ou edge pour un hub avec topologie en étoile. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile
    • Prod, non-prod ou services pour un hub qui utilise la topologie d'inspection hybride (uniquement pour les spokes de passerelle NCC)

    Pour en savoir plus sur les groupes de spokes, consultez Groupes de spokes.

API

Pour créer un spoke VPC, utilisez la méthode projects.locations.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_EXPORT_RANGES]",
       "exclude_export_ranges": "[EXCLUDE_EXPORT_RANGES]",
       "group": "GROUP_NAME"
    },
  }

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID du projet contenant le nouveau spoke
  • SPOKE_NAME : nom du nouveau spoke.
  • HUB_NAME : nom du hub auquel vous associez le spoke.
  • VPC_URI : réseau VPC vers lequel ce spoke pointe, par exemple vpc_uri.
  • INCLUDE_EXPORT_RANGES : liste de mots clés, de plages d'adresses IP ou d'une combinaison de mots clés et de plages d'adresses IP, séparés par des virgules, qui définissent les plages d'adresses IP de sous-réseau pouvant être exportées vers le hub.

    • Le mot clé ALL_PRIVATE_IPV4_RANGES ajoute toutes les plages de sous-réseaux qui utilisent des adresses IPv4 privées à la liste des plages d'exportation à inclure.

    • Le mot clé ALL_IPV4_RANGES inclut toutes les adresses IPv4, ce qui équivaut au CIDR 0.0.0.0/0. Toutes les plages IPv4 valides pour les plages de sous-réseaux, y compris les plages d'adresses IPv4 publiques utilisées en mode privé, sont incluses. Vous pouvez affiner la liste à l'aide de l'option --exclude-export-ranges.

    • Le mot clé ALL_IPV6_RANGES inclut toutes les adresses IPv6, ce qui équivaut au CIDR ::/0.

    • Les plages d'exportation incluse acceptent jusqu'à 16 CIDR uniques et non chevauchants. Aucun CIDR des plages d'exportation à inclure ne peut correspondre à un autre CIDR ni en contenir un.

    • Si vous omettez include_export_ranges pour un spoke VPC, les plages d'exportation incluses par défaut sont les mêmes que si vous aviez spécifié ALL_PRIVATE_IPV4_RANGES.

    • Les plages de sous-réseaux du spoke VPC, ses plages d'exportation incluses et ses plages d'exportation exclues doivent respecter les Règles de filtrage des exportations pour les spokes VPC.

  • EXCLUDE_EXPORT_RANGES : liste de plages d'adresses IP séparées par des virgules qui définissent les plages d'adresses IP de sous-réseau qui ne sont jamais exportées vers le hub.

    • Les plages d'exclusion des exportations acceptent jusqu'à 16 CIDR uniques et non chevauchants. Aucun CIDR dans les plages d'exclusion d'exportation ne peut correspondre à un autre CIDR ni en contenir un.

    • Chaque CIDR spécifié dans les plages d'exportation à exclure doit être développé en adresses IP entièrement contenues dans les CIDR ou les mots clés des plages d'exportation à inclure (ou dans les plages d'exportation à inclure par défaut, si vous n'en spécifiez aucune explicitement).

    • Les plages d'exportation exclues ne sont pas compatibles avec les mots clés.

    • Si vous omettez exclude_export_ranges, NCC utilise une liste vide comme plages d'exportation d'exclusion par défaut.

    • Les plages de sous-réseaux du spoke VPC, ses plages d'exportation incluses et ses plages d'exportation exclues doivent respecter les Règles de filtrage des exportations pour les spokes VPC.

  • GROUP_NAME : groupe auquel appartient ce spoke. Valeurs acceptées :

    • Default pour un hub avec topologie maillée
    • Center ou edge pour un hub avec topologie en étoile. Ce champ est obligatoire pour les groupes de spokes qui utilisent la topologie en étoile
    • Prod, non-prod ou services pour un hub qui utilise la topologie d'inspection hybride (uniquement pour les spokes de passerelle NCC)

    Pour en savoir plus sur les groupes de spokes, consultez Groupes de spokes.