Créer un réseau VMware Engine

Ce document explique comment créer un réseau VMware Engine standard à l'aide du portail VMware Engine, de gcloud CLI ou de l'API. Vous pouvez créer plusieurs réseaux VMware Engine afin d'isoler des clouds privés et définir des appairages de réseaux VPC uniques. Les réseaux VMware Engine gèrent les connexions à partir et vers des clouds privés conformément à une règle de réseau que vous définissez séparément.

Avant de commencer

Configuration requise pour la Google Cloud CLI et les API

Pour utiliser l'outil de ligne de commande gcloud ou l'API pour gérer vos ressources VMware Engine, nous vous recommandons de configurer les outils comme décrit ci-dessous.

gcloud

  1. Définissez votre ID de projet par défaut :

    gcloud config set project PROJECT_ID
    
  2. Définissez une région et une zone par défaut :

    gcloud config set compute/region REGION
    
    gcloud config set compute/zone ZONE
    

Pour en savoir plus sur l'outil gcloud vmware, consultez la documentation de référence de Cloud SDK Cloud.

API

Les exemples d'API de cet ensemble de documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. Un jeton d'accès valide est requis dans la requête cURL. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes utilisent l'outil gcloud pour générer un jeton d'accès:

  1. Connectez-vous à Google Cloud:

    gcloud auth login
    
  2. Générez un jeton d'accès et exportez-le vers TOKEN:

    export TOKEN=`gcloud auth print-access-token`
    
  3. Vérifiez que TOKEN est correctement défini:

    echo $TOKEN
    

Utilisez maintenant le jeton d'autorisation dans vos requêtes à l'API. Exemple :

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Les exemples de code Python de cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour pouvoir utiliser cette approche, la bibliothèque doit être installée et les identifiants par défaut de l'application doivent être configurés.

  1. Téléchargez et installez la bibliothèque Python:

    pip install google-cloud-vmwareengine
    
  2. Configurez les informations ADC en exécutant ces commandes dans votre shell:

    gcloud auth application-default login
    

    Vous pouvez également utiliser un fichier de clé de compte de service:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
    

Pour en savoir plus sur la bibliothèque, consultez la page de référence ou les exemples de code sur GitHub.

Créer un réseau VMware Engine

Créez un réseau VMware Engine à l'aide de la console Google Cloud, de gcloud CLI ou de l'API VMware Engine:

Console

Pour créer un réseau VMware Engine à l'aide de VMware Engine:

  1. Dans la console Google Cloud, accédez à la page Réseaux VMware Engine.

    Accéder aux réseaux VMware Engine

  2. Cliquez sur Créer. Un formulaire de création de réseau VMware Engine s'ouvre.

  3. Saisissez un nom de réseau VMware Engine.

  4. Saisissez une description pour le réseau (par exemple, "Mon VEN 1 standard"), puis cliquez sur Créer.

  5. Facultatif: Vérifiez la création de votre réseau en accédant à l'élément de menu Réseaux VMware Engine. Tous les réseaux VMware Engine sont listés dans le tableau de cette page.

La liste suivante décrit plus en détail chaque champ à renseigner lors de la création du réseau :

  • Name (Nom) : identifiant unique et permanent du réseau VMware Engine.
  • Description:informations supplémentaires visibles sur la page des détails du réseau VMware Engine.
  • Type de réseau:identifiant du type de réseau utilisé pour les cas d'utilisation de mise en réseau et les déploiements de cloud privé standards.
  • Region (Région) : dépend de l'utilisation de réseaux VMware Engine standard ou anciens.

    • Pour les anciens réseaux, il s'agit de la région dans laquelle le réseau est connecté.
    • Pour les réseaux standards, ce champ est toujours défini sur "global".

gcloud

Pour créer un réseau VMware Engine à l'aide de la gcloud CLI:

  1. Exécutez la commande gcloud vmware networks create:

    gcloud vmware networks create NETWORK_ID \
      --type=STANDARD \
      --description="DESCRIPTION"

    Remplacez les éléments suivants :

    • NETWORK_ID: nom du réseau pour cette requête
    • DESCRIPTION: description de ce réseau
  2. Facultatif: Si vous souhaitez lister tous les réseaux VMware Engine pour confirmer la création du nouveau réseau, utilisez la commande gcloud vmware networks list:

    gcloud vmware networks list \
      --location=global

API

Pour créer un réseau VMware Engine à l'aide de l'API VMware Engine, procédez comme suit:

  1. Pour créer un réseau VMware Engine, envoyez une requête POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID"
    
    '{
      "type": "standard",
      "description": "DESCRIPTION"
    }'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour cette requête.
    • NETWORK_ID: nom du réseau pour cette requête.
    • DESCRIPTION: description de ce réseau.
  2. Facultatif: Pour lister tous les réseaux VMware Engine afin de confirmer la création du nouveau réseau, envoyez une requête GET. Remplacez PROJECT_ID par l'ID du projet pour cette requête.

    GET https://vmwareengine.googleapis.com/v1/projects//locations/global/vmwareEngineNetworks

Mettre à jour un réseau VMware Engine

Mettez à jour un réseau VMware Engine à l'aide de la console Google Cloud, de gcloud CLI ou de l'API VMware Engine:

Console

  1. Dans la console Google Cloud, accédez à la page Réseaux VMware Engine.

    Accéder aux réseaux VMware Engine

  2. Cliquez sur le nom du réseau que vous souhaitez mettre à jour.

  3. Sur la page des détails du réseau, modifiez la description, puis cliquez sur Enregistrer.

  4. Facultatif: Pour afficher la description mise à jour, accédez à l'élément de menu Réseaux VMware Engine, puis cliquez sur le réseau pour afficher les détails.

gcloud

Pour mettre à jour un réseau VMware Engine à l'aide de la gcloud CLI, procédez comme suit:

  1. Mettez à jour la description d'un réseau VMware Engine en exécutant la commande gcloud vmware networks update:

    gcloud vmware networks update NETWORK_ID \
      --description='DESCRIPTION'

    Remplacez les éléments suivants :

    • NETWORK_ID: nom du réseau pour cette requête.
    • DESCRIPTION: description mise à jour de ce réseau.
  2. Facultatif: Si vous souhaitez afficher l'attribut mis à jour, exécutez la commande gcloud vmware networks describe:

    gcloud vmware networks describe NETWORK_ID

    Remplacez NETWORK_ID par le nom du réseau pour cette requête.

API

Pour mettre à jour un réseau VMware Engine à l'aide de l'API VMware Engine, procédez comme suit:

  1. Pour mettre à jour la description d'un réseau VMware Engine, envoyez une requête PATCH:

    PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description"
    
    '{
      "description":"DESCRIPTION"
    }'
    

    Remplacez les éléments suivants :

    • PROJECT_ID: projet de cette requête
    • LOCATION: emplacement du réseau, global pour les anciens réseaux ou région pour les réseaux standards
    • NETWORK_ID: nom du réseau pour cette requête
    • DESCRIPTION: description mise à jour de ce réseau
  2. Facultatif: Si vous souhaitez afficher l'attribut mis à jour, envoyez une requête GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"

Étape suivante