Administra la actividad y los recursos de la nube privada

Después de crear una nube privada, puedes ver información detallada sobre ella, administrar sus recursos y su actividad, y acceder a sus dispositivos de administración de VMware. Cada nube privada contiene uno o más clústeres, y cada clúster contiene nodos que corresponden a hosts de ESXi.

Las políticas de ajuste de escala automático que se aplican a los clústeres en una nube privada supervisan el consumo de recursos y agregan o quitan nodos del clúster de forma automática. También puedes ampliar o contraer una nube privada de forma manual si agregas o quitas nodos de los clústeres en esa nube privada. Por ejemplo, puedes crear una nube privada según las necesidades actuales y, luego, ampliarla agregando nodos a medida que aumenta el consumo.

Para ver una lista de tus nubes privadas, accede a la página de resumen de recursos:

Accede al portal de Google Cloud VMware Engine.
En el menú de navegación principal, ve a Recursos.
En la lista de nubes privadas, selecciona la que deseas administrar.

Requisitos de gcloud y la API

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

gcloud

Configura tu ID del proyecto predeterminado:
```
gcloud config set project PROJECT_ID
```

Configura una región o zona predeterminada:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

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

API

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

Accede a Google Cloud
```
gcloud auth login
```

Genera un token de acceso y expórtalo a TOKEN

export TOKEN=`gcloud auth print-access-token`

Verifica que TOKEN esté configurado correctamente.
```
echo $TOKEN

Output:
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 en esta documentación usan la biblioteca de VMware Engine para comunicarse con la API. Para poder usar este enfoque, es necesario instalar la biblioteca y configurar las credenciales predeterminadas de la aplicación.

Descarga y, luego, instala la biblioteca de Python
```
 pip install google-cloud-vmwareengine
```
Para configurar la información del ADC, ejecuta esos comandos en tu shell
```
  gcloud auth application-default login
```
o usar un archivo de claves 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 las muestras de código en GitHub.

Verifica la versión de diseño de la dirección IP

Las nubes privadas creadas después de noviembre de 2022 cumplen con las asignaciones de subred de la versión 2.0 de diseño de direcciones IP (plan de IP). Casi todas las nubes privadas creadas antes de noviembre de 2022 cumplen con las asignaciones de subred del plan de IP versión 1.0.

Para averiguar a qué versión cumple tu nube privada, completa los siguientes pasos:

Accede al portal de Google Cloud VMware Engine.
En la página Recursos, haz clic en Resumen.

El número de versión se muestra con la Versión del plan de IP.

Visualiza un resumen de la nube privada

En el resumen, se proporciona información sobre la nube privada, incluido su nombre, la cantidad de clústeres de vSphere, la cantidad de nodos, la ubicación, el estado operativo y mucho más. La página de resumen también incluye los servidores DNS implementados en la nube privada.

En la página de resumen de la nube privada, puedes realizar las siguientes acciones:

Inicia el cliente de vSphere. Accede a vCenter para esta nube privada.
Agregar nodos. Agrega nodos a esta nube privada.
Agregar clúster. Agrega un clúster nuevo a esta nube privada.
Crea un clúster con una configuración personalizada de recuento de núcleos. Crear un clúster nuevo con configuración personalizada de recuento de núcleos
Quitar nodos. Quita nodos de esta nube privada.
Borrar la nube privada. Borra una nube privada, incluidas todas las VM, la configuración de vCenter y los datos. Antes de hacerlo, crea una copia de seguridad de todos los sistemas y datos.
Cambiar los privilegios de vSphere. Aumenta tus privilegios para realizar una tarea en particular en esta nube privada.
Copiar las direcciones IP de los servidores DNS. Obtén una lista de servidores DNS en tu nube privada. Puedes configurar el reenvío de DNS desde los servidores DNS locales hacia los servidores DNS de la nube privada. Si deseas obtener más información sobre el reenvío de DNS, consulta Configura el DNS para la resolución de nombres para el acceso a vCenter de nube privada desde estaciones de trabajo locales.

Agregar nodos a una nube privada

Una nube privada consiste en uno o más clústeres de vSphere, cada uno con múltiples nodos. Cuando agregas nodos a una nube privada, los agregas al clúster existente o creas un clúster nuevo. Una nube privada se puede ampliar varias veces, siempre que te mantengas dentro de los límites de nodos generales. Cada vez que amplias una nube privada, la agregas al clúster existente o creas uno nuevo.

Como parte de la configuración del clúster nuevo, Google configura la infraestructura de VMware. Esta incluye la configuración de almacenamiento para grupos de discos de vSAN, la alta disponibilidad de VMware y el programador de recursos distribuidos (DRS).

Sigue estos pasos para agregar nodos a una nube privada:

Console

En la página de resumen de la nube privada, haz clic en Agregar nodos.
Elige si quieres agregar nodos a uno de tus clústeres existentes o crear uno nuevo de vSphere. A medida que realizas cambios, la información de resumen de la página se actualiza.
Para agregar nodos a uno de tus clústeres existentes, selecciona Agregar nodos a un clúster existente. Selecciona el clúster que deseas expandir y, luego, ingresa la cantidad de nodos que quieres agregar.
Para agregar un clúster nuevo, selecciona Crear nuevo. Luego, proporciona los siguientes detalles:
1. Ingresa un nombre para el clúster.
2. Selecciona un centro de datos de vSphere existente o ingresa un nombre para crear un centro de datos nuevo.
3. Selecciona la cantidad de nodos. Cada clúster nuevo debe tener al menos tres nodos.
4. Opcional: Haz clic en el botón de activación Personalizar núcleos si deseas reducir la cantidad de núcleos disponibles para cada nodo en el clúster de administración. Para obtener más detalles, consulta Recuentos de núcleos personalizados.
Haz clic en Enviar.

gcloud

El comando update te permite cambiar la cantidad total de nodos para el clúster. Este comando requiere el nombre del clúster y la nube privada.

Haz una lista de los clústeres.

gcloud vmware private-clouds clusters list \
 --private-cloud=PC_NAME \
 --location=ZONE

Actualiza el clúster. Por ejemplo, con los siguientes comandos, se cambia la cantidad de nodos a 4.
```
gcloud vmware private-clouds clusters update CLUSTER_NAME \
--location=ZONE \
--private-cloud=PC_NAME --node-type-config=type=standard-72,count=4
```
Reemplaza lo siguiente:
- CLUSTER_NAME: Es el nombre del clúster que se actualizará en esta nube privada.
- ZONE: Es la zona de la nube privada.
- PC_NAME: Es el nombre de la nube privada.
- PROJECT_ID: Es el ID del proyecto de esta solicitud.

API

La API de actualización te permite cambiar el recuento total de nodos del clúster. Este comando requiere el nombre del clúster y la nube privada.

Haz una lista de los clústeres.

curl -L -X GET -H "Authorization: Bearer TOKEN" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/clusters"

Actualiza los clústeres. Por ejemplo, a continuación, se actualiza el clúster a standard-72 y se cambia la cantidad de nodos a 4.
```
curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/clusters/CLUSTER_NAME?updateMask=node_type_configs.*.node_count" \
-d '{
"nodeTypeConfigs": {
  "standard-72" : {
    "nodeCount": 4
  }
}
}'
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto de esta solicitud.
- ZONE: Es la zona de la nube privada.
- PC_NAME: Es el nombre de la nube privada.
- CLUSTER_NAME: Es el nombre del clúster que se actualizará en esta nube privada.

Python

El método de actualización de clústeres te permite cambiar la cantidad total de nodos del clúster. Este método requiere el nombre del clúster y la nube privada.

Haz una lista de los clústeres.

from typing import Iterable

from google.cloud import vmwareengine_v1

def list_clusters(
    project_id: str, zone: str, private_cloud_name: str
) -> Iterable[vmwareengine_v1.Cluster]:
    """
    Retrieves a list of clusters in private cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located.
        private_cloud_name: name of the cloud of which you want to list cluster.

    Returns:
        An iterable collection of Cluster objects.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    return client.list_clusters(
        parent=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

Actualiza los clústeres. El siguiente método te permite modificar la cantidad de nodos standard-72 en el clúster.

from google.api_core import operation
from google.cloud import vmwareengine_v1

def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

Agrega un clúster nuevo a una nube privada

Para agregar un clúster nuevo a una nube privada existente, haz lo siguiente:

gcloud

Agrega el clúster nuevo y asígnale un nombre. Por ejemplo:

gcloud vmware private-clouds clusters create CLUSTER_NAME \
   --location=ZONE --private-cloud=PC_NAME \
   --node-type-config=type=standard-72,count=4

API

Agrega el clúster nuevo y asígnale un nombre. Por ejemplo:

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/clusters?clusterId=CLUSTER_NAME" \
-d '{
  "nodeTypeConfigs": {
    "standard-72": {
      "nodeCount": 4
      }
  }
}'

Python

Agrega el clúster nuevo y asígnale un nombre.

from google.api_core import operation
from google.cloud import vmwareengine_v1

def create_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
) -> operation.Operation:
    """
    Create a new cluster in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster. (Must be >= 3)

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

Crea un clúster nuevo con una configuración personalizada de recuento de núcleos

Para crear un clúster nuevo con la configuración personalizada de recuento de núcleos, haz lo siguiente:

gcloud

Agrega el clúster nuevo y especifica la configuración del recuento de núcleos. Por ejemplo, lo siguiente crea un clúster nuevo del tipo de nodo standard-72 con 3 nodos y un recuento de núcleos personalizados de 28.

gcloud vmware private-clouds clusters create CLUSTER_NAME \
    --location=ZONE \
    --private-cloud=PC_NAME \
    --node-type-config=type=standard-72,count=4,custom-core-count=28

API

Agrega el clúster nuevo y especifica la configuración del recuento de núcleos. Por ejemplo, lo siguiente crea un clúster nuevo del tipo de nodo standard-72 con 4 nodos y un recuento de núcleos personalizados de 28.

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PROJECT_ID/clusters?clusterId=CLUSTER_NAME" \
-d '{
      "nodeTypeConfigs": {
      "standard-72": {
        "nodeCount": 4,
        "customCoreCount": 28
        }
    }
}'

Python

Agrega el clúster nuevo y especifica la configuración del recuento de núcleos. Por ejemplo, lo siguiente crea un clúster nuevo del tipo de nodo standard-72 con cantidad configurable de nodos y recuento de núcleos.

from google.api_core import operation
from google.cloud import vmwareengine_v1

def create_custom_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
    core_count: int = 28,
) -> operation.Operation:
    """
    Create a new cluster with custom number of cores in its nodes
    in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster.
        core_count: number of CPU cores in the new cluster nodes.

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.cluster.node_type_configs["standard-72"].custom_core_count = core_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

Quitar nodos o borrar un clúster

Cuando quitas nodos de una nube privada, quitas nodos del clúster existente o borras todo el clúster.

Para quitar nodos de una nube privada, actualiza el clúster con algunos nodos.

Console

En la página de resumen de la nube privada, haz clic en Quitar nodos.
Selecciona el clúster que deseas reducir o borrar.
Selecciona Quitar un nodo.
Verifica la capacidad del clúster.
Haz clic en Enviar para comenzar el proceso de quitar nodos.

Para supervisar el progreso, selecciona Actividad > Tareas. Este proceso requiere que se vuelva a sincronizar en vSAN, lo que puede tomar algunas horas, según los datos.

gcloud

gcloud vmware private-clouds clusters update CLUSTER_NAME \
  --location=ZONE \
  --private-cloud=PC_NAME --node-type-config=type=standard-72,count=3

API

curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/clusters/CLUSTER_NAME?update_mask=node_type_configs.*.node_count" \
-d '{
  "nodeTypeConfigs": {
    "standard-72" : {
      "nodeCount": 3
    }
  }
}'

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1

def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

Para borrar todo un clúster, haz lo siguiente:

Console

En la página de resumen de la nube privada, haz clic en Quitar nodos.
Selecciona el clúster que deseas reducir o borrar.
Selecciona Borrar todo el clúster.
Verifica la capacidad del clúster.
Haz clic en Enviar para comenzar el proceso de quitar nodos.

gcloud

gcloud vmware private-clouds clusters delete CLUSTER_NAME \
  --location=ZONE \
  --private-cloud=PC_NAME

API

curl -L -X DELETE -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/clusters/CLUSTER_NAME"

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1

def delete_cluster(
    project_id: str, zone: str, private_cloud_name: str, cluster_name: str
) -> operation.Operation:
    """
    Delete a cluster from private cloud.

    Deleting a cluster is a long-running operation and it may take over an hour..

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.

    Returns:
        An Operation object related to started cluster deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.DeleteClusterRequest()
    request.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    return client.delete_cluster(request)

Restricciones

El proceso de quitar nodos de tu nube privada tiene las siguientes restricciones:

El clúster de vSphere debe tener al menos tres nodos. No puedes quitar nodos de un clúster con 3 nodos o menos.
El almacenamiento total consumido no puede exceder la capacidad total después de quitar nodos de un clúster.
No puedes borrar el primer clúster que se creó cuando se creó la nube privada.
Si las reglas de DRS de vSphere (afinidad y antiafinidad) se aplican a todos los nodos de un clúster, los nodos no se pueden quitar del clúster. Puedes borrar las reglas y reintentar la operación de eliminación del nodo.

Visualiza subredes

Si deseas ver la lista de subredes de administración definidas para tu nube privada, selecciona la pestaña Subredes. La lista incluye las subredes HCX que se crearon cuando se creó la nube privada. La lista de subredes también incluye la tabla de firewall adjunta para cada subred.

Visualiza la información de la actividad

Para ver la información de actividad de tu nube privada, selecciona la pestaña Actividad. La información que se muestra es una lista filtrada de todas las actividades de la nube privada. En esta página, se muestran hasta 25 actividades recientes. Para obtener una lista completa de actividades y acciones asociadas, consulta Supervisa la actividad de VMware Engine.

Visualiza la red de administración de vSphere

Para ver la lista de los recursos de administración de VMware y las máquinas virtuales que están configuradas en la nube privada, selecciona la pestaña Red de administración de vSphere. La información incluye la versión de software, el nombre de dominio completamente calificado (FQDN) y la dirección IP de los recursos.