Crear 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 empezar a usar Google Cloud VMware Engine con usos no productivos, como pruebas piloto y evaluaciones de pruebas de concepto. Las nubes privadas de un solo nodo contienen solo un nodo y un clúster. Puedes ampliar 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 un solo nodo para obtener información conceptual sobre las nubes privadas de un solo nodo.

Requisitos de Google Cloud CLI y de las APIs

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

gcloud

  1. Configura tu ID de proyecto predeterminado:

    gcloud config set project PROJECT_ID
    
  2. Definir 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 Google Cloud.

API

En los ejemplos de API de este conjunto de documentación se usa la herramienta de línea de comandos cURL para consultar la API. Se necesita un token de acceso válido como parte de la solicitud cURL. Hay muchas formas de obtener un token de acceso válido. En los siguientes pasos se utiliza la herramienta gcloud para generar un token de acceso:

  1. Inicia sesión en Google Cloud:

    gcloud auth login
    
  2. Generar token de acceso y exportarlo 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

Los ejemplos de código de Python de esta documentación usan la biblioteca VMware Engine para comunicarse con la API. Para poder usar este método, la biblioteca debe estar instalada y las credenciales de aplicación predeterminadas deben estar configuradas.

  1. Descarga e instala la biblioteca de Python:

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

    gcloud auth application-default login
    

    También puedes usar un archivo de clave de 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 los ejemplos de código en GitHub.

Antes de empezar

Crear una nube privada de un solo nodo

Crea una nube privada de un solo nodo siguiendo estas instrucciones.

Consola

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

    Ir a Private Cloud

  2. Haga clic en Seleccionar un proyecto y, a continuación, seleccione la organización, la carpeta o el proyecto
    en el que quiera crear la nube privada de un solo nodo.

  3. Haz clic en Crear.

  4. Selecciona Nube privada estándar.

  5. Selecciona la ubicación en la que quieras implementar la nube privada.

  6. Selecciona el tipo de nodo de tu clúster principal.

  7. Selecciona Un solo nodo para crear una nube privada de un solo nodo.

  8. Rellena 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 la CLI de gcloud, sigue estos pasos:

  1. Opcional: Si no sabes los nombres de las regiones y zonas disponibles para tu proyecto, puedes consultarlos ejecutando el comando gcloud vmware locations list:

    gcloud vmware locations list
    
  2. Para crear una nube privada de un solo nodo que caduque al cabo 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
    

    Haz los cambios siguientes:

    • PRIVATE_CLOUD_ID: el nombre de esta nube privada.
    • CLUSTER_ID: el ID del clúster de esta solicitud
    • ZONE: la zona de esta nube privada
    • IP_ADDRESS: la dirección IP y el intervalo de esta nube privada, por ejemplo, 192.168.1.0/24
    • REGION: 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 quieres comprobar 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 debería ser similar al siguiente:

    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 quieres consultar 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. Obtén las credenciales de vCenter y NSX, respectivamente, ejecutando el comando gcloud vmware private-clouds credentials describe:

    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. Crea una nube privada de un solo nodo (caduca al cabo de 60 días) haciendo una POST solicitud:

    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"
    }
    

    Haz los cambios siguientes:

    • PROJECT_ID: el proyecto de esta solicitud
    • ZONE: la zona de esta nube privada
    • PRIVATE_CLOUD_ID: el nombre de la nube privada de esta solicitud
    • REGION: la región de esta nube privada
    • CLUSTER_ID: el ID del clúster de esta solicitud
  2. Opcional: Comprueba el estado de la creación de la nube privada (puede tardar hasta dos horas) haciendo 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, haz una solicitud POST:

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

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de esta solicitud.
    • ZONE: la zona de esta nube privada
    • OPERATION_ID: el ID de operación de esta nube privada
  3. Opcional: Obtén los detalles de la nube privada haciendo 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: el ID de esta nube privada
    • ZONE: la zona de esta nube privada
  4. Obtenga las credenciales de vCenter y NSX, respectivamente, haciendo solicitudes GET independientes:

    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 entre 30 minutos y 2 horas en crear tu nube privada y permitir el acceso desde laGoogle Cloud consola.

Siguientes pasos