Créer un réseau VMware Engine

Ce document explique comment créer une instance VM VMware Engine standard Réseau via le portail VMware Engine, gcloud CLI ou 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 l'API

Pour gérer votre instance VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API ressources, 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 du SDK Cloud.

API

Les exemples d'API de cette 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 éléments suivants 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, vous devez installer la bibliothèque et configurer les identifiants par défaut de l'application.

  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 consultez des 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, procédez comme suit:

  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. Tout VMware Engine sont répertorié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 :

  • Nom:identifiant unique 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 de type de réseau utilisé pour prendre en charge les cas d'utilisation de la mise en réseau et les déploiements de cloud privé standard.
  • 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 CLI gcloud :

  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 répertorier 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 répertorier tous les réseaux VMware Engine afin de confirmer le création du réseau, effectuez 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 d'informations du réseau, modifiez la description, puis cliquez sur Enregistrer.

  4. Facultatif: Pour afficher la nouvelle description, accédez à la section Réseaux VMware Engine. et cliquez sur le réseau pour afficher les détails.

gcloud

Pour mettre à jour un réseau VMware Engine à l'aide de la CLI gcloud, 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: mise à jour de la description 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 demande.

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, effectuez 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 concerné par 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