Crea una nube privada de un solo nodo de VMware Engine

En este documento, se describe cómo crear una nube privada de un solo nodo. Las nubes privadas de un solo nodo te ayudan a comenzar a usar Google Cloud VMware Engine con un uso no relacionado con la producción, como pruebas piloto y evaluaciones de pruebas de concepto. Las nubes privadas de un solo nodo contienen solo un nodo y un clúster, tienen un tiempo limitado y se quitan automáticamente después de 60 días. Puedes expandir tu nube privada de un solo nodo a tres nodos en cualquier momento para convertirla en una nube privada estándar.

Consulta Nubes privadas de nodo único para obtener información conceptual sobre las nubes privadas de nodo único.

Requisitos de la API y Google Cloud CLI

Para usar la herramienta de línea de comandos de gcloud o la API para administrar tus recursos de VMware Engine, te recomendamos que configures las herramientas como se describe a continuación.

gcloud

  1. Establece tu ID del proyecto predeterminado:

    gcloud config set project PROJECT_ID
    
  2. Configura una región y una zona predeterminadas:

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

Para obtener más información sobre la herramienta gcloud vmware, consulta la documentación de referencia del SDK de Cloud.

API

Los ejemplos de la API de este conjunto de documentación usan la herramienta de línea de comandos cURL para consultar la API. Se requiere un token de acceso válido como parte de la solicitud cURL. Existen muchas maneras de obtener un token de acceso válido. En los siguientes pasos, se usa la herramienta gcloud para generar un token de acceso:

  1. Accede a Google Cloud:

    gcloud auth login
    
  2. Genera un token de acceso y expórtalo a TOKEN:

    export TOKEN=`gcloud auth print-access-token`
    
  3. Verifica que TOKEN esté configurado correctamente:

    echo $TOKEN
    

Ahora, usa el token de autorización en tus solicitudes a la API. Por ejemplo:

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

Las muestras de código de Python de esta documentación usan la biblioteca de VMware Engine para comunicarse con la API. Para poder usar este enfoque, se debe instalar la biblioteca y se deben configurar las Credenciales predeterminadas de la aplicación.

  1. Descarga e instala la biblioteca de Python:

    pip install google-cloud-vmwareengine
    
  2. Ejecuta esos comandos en tu shell para configurar la información de ADC:

    gcloud auth application-default login
    

    También puedes usar un archivo de claves de la cuenta de servicio:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
    

Para obtener más información sobre la biblioteca, visita la página de referencia o consulta las muestras de código en GitHub.

Antes de comenzar

Crea una nube privada de nodo único

Sigue estas instrucciones para crear una nube privada de un solo nodo.

Console

  1. En la consola de Google Cloud, ve a la página Nubes privadas.

    Ir a Nubes privadas

  2. Haz clic en Crear.

  3. Selecciona Nube privada estándar.

  4. Selecciona una ubicación en la que deseas que se implemente la nube privada.

  5. Selecciona el tipo de nodo para tu clúster principal.

  6. Selecciona Nodo único para crear una nube privada de nodo único.

  7. Completa el resto de los detalles de tu nube privada y haz clic en Guardar.

gcloud

Para crear una nube privada de un solo nodo con gcloud CLI, haz lo siguiente:

  1. Opcional: Si no conoces los nombres de las regiones y zonas disponibles para tu proyecto, puedes ejecutar el comando gcloud vmware locations list para obtener una lista:

    gcloud vmware locations list
    
  2. Para crear una nube privada de un solo nodo, que vence después de 60 días, usa el comando gcloud vmware private-clouds create:

    gcloud vmware private-clouds create PRIVATE_CLOUD_ID \
       --description= "" \
       --location=ZONE \
       --cluster="CLUSTER_ID" \
       --node-type-config=type=standard-72, count=1 \
       --management-range=IP_ADDRESS \
       --vmware-engine-network="REGION" \
       --type=TIME_LIMITED
    

    Reemplaza lo siguiente:

    • PRIVATE_CLOUD_ID: Es el nombre de esta nube privada.
    • CLUSTER_ID: Es el ID del clúster de esta solicitud.
    • ZONE: La zona de esta nube privada
    • IP_ADDRESS: La dirección IP y el rango de esta nube privada, por ejemplo, 192.168.1.0/24
    • REGION: Es la región de esta nube privada.

    Ejemplo de salida:

    Create in progress for private cloud [projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID].
    
  3. Opcional: Si deseas verificar el estado de la creación de la nube privada, usa los comandos gcloud vmware operations describe y gcloud vmware private-clouds list.

    gcloud vmware operations describe OPERATION_ID \
       --location=ZONE
    
    gcloud vmware private-clouds list \
       --location=ZONE
    

    El resultado es similar a este:

    NAME                  PROJECT       LOCATION  CREATE_TIME STATE         VCENTER_FQDN
    PRIVATE_CLOUD_ID      PROJECT_ID    ZONE      2023-03-01T13:08:21.507Z  CREATING VCENTER_FQDN
    
  4. Opcional: Si deseas verificar los detalles de la nube privada, ejecuta el comando gcloud vmware private-clouds describe:

    gcloud vmware private-clouds describe PRIVATE_CLOUD_ID \
       --location=ZONE
    
  5. Ejecuta el comando gcloud vmware private-clouds credentials describe para obtener las credenciales de vCenter y NSX-T, respectivamente:

    gcloud vmware private-clouds vcenter credentials describe PRIVATE_CLOUD_ID \
       --location=ZONE
    
    gcloud vmware private-clouds nsx credentials describe PRIVATE_CLOUD_ID \
       --location=ZONE
    

REST

Para crear una nube privada de un solo nodo con la API de VMware Engine, haz lo siguiente:

  1. Para crear una nube privada de un solo nodo (vence después de 60 días), realiza una solicitud POST:

    POST https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?private_cloud_id=PRIVATE_CLOUD_ID
    
    {
     "description": "my private cloud",
     "network_config": {
       "vmware_engine_network": "projects/PROJECT_ID/locations/REGION/vmwareEngineNetworks/REGION-default",
       "management_cidr": "192.168.0.0/24"
     },
     "management_cluster": {
       "cluster_id": "CLUSTER_ID",
       "node_type_configs": {
         "standard-72": {
           "node_count": 1
         }
       }
     },
     "type": "TIME_LIMITED"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el proyecto de esta solicitud.
    • ZONE: La zona de esta nube privada
    • PRIVATE_CLOUD_ID: El nombre de la nube privada para esta solicitud
    • REGION: Es la región de esta nube privada.
    • CLUSTER_ID: Es el ID del clúster de esta solicitud.
  2. Opcional: Verifica el estado de la creación de la nube privada (puede demorar hasta dos horas) mediante una solicitud POST a la operación:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID
    

    Para enumerar las nubes privadas de una zona, realiza una solicitud POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de esta solicitud.
    • ZONE: La zona de esta nube privada
    • OPERATION_ID: El ID de la operación de esta nube privada
  3. Opcional: Para obtener detalles de la nube privada, realiza una solicitud GET:

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID
    
    • PROJECT_ID: El ID de este proyecto
    • PRIVATE_CLOUD_ID: Es el ID de esta nube privada.
    • ZONE: La zona de esta nube privada
  4. Para obtener las credenciales de vCenter y NSX-T, respectivamente, realiza solicitudes GET separadas:

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showVcenterCredentials
    
    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showNsxCredentials
    

VMware Engine tarda aproximadamente entre 30 minutos y 2 horas en crear tu nube privada y permitir que se acceda a ella desde la consola de Google Cloud.

¿Qué sigue?