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 pour isoler les clouds privés et définir des appairages de réseaux VPC uniques. Les réseaux VMware Engine gèrent les connexions vers et depuis les clouds privés en fonction d'une règle de réseau que vous définissez séparément.

Avant de commencer

Conditions requises pour la Google Cloud CLI et les API

Pour gérer vos ressources VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API, 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 cette documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. Vous devez indiquer un jeton d'accès valide dans la requête cURL. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes font appel à 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

À présent, utilisez le jeton d'autorisation dans vos requêtes adressées à 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 présentés dans cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour que vous puissiez 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 relatives à l'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, procédez comme suit:

  1. Accédez à la console Google Cloud.
  2. Sélectionnez Réseaux VMware Engine dans le menu de navigation, puis 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 du réseau, par exemple "My standard VEN 1", puis cliquez sur Create (Créer).
  5. Facultatif: Confirmez la création du réseau en accédant à l'élément de menu Réseaux VMware Engine. Tous les réseaux 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 d'informations 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é standard.

  • Région:dépend de l'utilisation de réseaux VMware Engine standards ou d'anciens réseaux VMware Engine.

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

  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, exécutez 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 et confirmer la création du nouveau réseau, exécutez une requête GET. Remplacez PROJECT_ID par l'ID du projet concerné par 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. Accédez à la console Google Cloud.
  2. Dans le menu de navigation, sélectionnez Réseaux VMware Engine, puis cliquez sur le nom du réseau que vous souhaitez mettre à jour.
  3. Sur la page "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 VMware Engine networks et cliquez sur le réseau pour afficher les détails.

gcloud

Pour mettre à jour un réseau VMware Engine à l'aide de 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, utilisez la commande gcloud vmware networks describe suivante:

    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, exécutez 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: nouvelle description de ce réseau

  2. Facultatif: Si vous souhaitez afficher l'attribut mis à jour, exécutez une requête GET:

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

Étapes suivantes