Usa nodos de solo almacenamiento

En este documento, se describe cómo usar nodos de solo almacenamiento en VMware Engine. Los nodos de solo almacenamiento, también conocidos como nodos de almacenamiento, se pueden usar para escalar la capacidad de almacenamiento de un clúster de vSAN sin agregar núcleos ni memoria al clúster. Puedes crear clústeres que contengan nodos estándar y solo de almacenamiento y, luego, expandirlos o reducirlos con Google Cloud CLI o la API de VMware Engine.

Google Cloud CLI y requisitos de las APIs

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

gcloud

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

Establece 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 el token de acceso y expórtalo a TOKEN

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

Verifica que el 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, se debe instalar la biblioteca y se deben configurar las credenciales predeterminadas de la aplicación.

Descarga y, luego, instala la biblioteca de Python
```
 pip install google-cloud-vmwareengine
```
Ejecuta esos comandos en tu shell para configurar la información de ADC.
```
  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 muestras de código en GitHub.

Antes de comenzar

Antes de crear una nube privada con nodos de solo almacenamiento, confirma que exista una red de VMware Engine. Si no existe una red de VMware Engine, crea una con Google Cloud CLI. Para ello, ingresa el comando gcloud vmware networks create:

   gcloud vmware networks create NETWORK_NAME \
      --type-STANDARD \
      --project=PROJECT_ID

Reemplaza lo siguiente:

NETWORK_NAME: Es el nombre de la red.
PROJECT_ID: Es el ID del proyecto de la solicitud.

Enumerar los tipos de nodos disponibles

A fin de verificar que haya un nodo de solo almacenamiento disponible para tu proyecto y región, enumera los tipos de nodos disponibles con Google Cloud CLI o la API de VMware Engine.

gcloud

Obtén una lista de los tipos de nodos disponibles con el comando gcloud vmware node-types list:

  gcloud vmware node-types list \
     --location=ZONE \
     --project=PROJECT_ID

Reemplaza lo siguiente:

ZONE: es la zona para esta solicitud.
PROJECT_ID: Es el ID del proyecto de esta solicitud.

API

Para enumerar los tipos de nodos disponibles con la API de VMware Engine, realiza una solicitud GET:

GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/nodeTypes"

Reemplaza lo siguiente:

PROJECT_ID: Es el nombre del proyecto para esta solicitud.
ZONE: Es la zona de la nube privada.

Crea una nube privada con nodos de solo almacenamiento

Puedes crear una nube privada de VMware Engine que contenga nodos de solo almacenamiento, además de nodos estándar, con Google Cloud CLI o la API de VMware Engine.

gcloud

Para crear una nube privada con nodos de solo almacenamiento mediante Google Cloud CLI, haz lo siguiente:

Para crear una nube privada PC_STORAGE_NODE_NAME con n nodos standard-72 y m storage-only-standard-72, ingresa el comando gcloud private-clouds create:
```
gcloud vmware private-clouds create PC_STORAGE_NODE_NAME \
 --location=ZONE \
 --project=PROJECT_ID \
 --description=DESCRIPTION \
 --management-range=IP_ADDRESS \
 --cluster=CLUSTER_NAME \
 --node-type-config=type=standard-72,count=n \
 --node-type-config=type=storage-only-standard-72,count=m \
 --vmware-engine-network=NETWORK_NAME
```
Reemplaza lo siguiente:
- PC_STORAGE_NODE_NAME: Es el nombre de la nube privada con nodo de solo almacenamiento.
- ZONE: Es la zona de esta nube privada.
- PROJECT_ID: Es el ID del proyecto de la solicitud.
- DESCRIPTION: Es la descripción de esta nube privada.
- IP_ADDRESS: Es la dirección IP y el rango de esta nube privada, por ejemplo, 192.168.0.0/22.
- CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
- n: Es la cantidad de nodos estándar en el clúster principal de esta nube privada.
- m: Es la cantidad de nodos de solo almacenamiento en el clúster principal de esta nube privada.
- NETWORK_NAME: Es el nombre de la red.
Opcional: Para confirmar la creación de la nube privada con nodos de solo almacenamiento, ingresa el comando gcloud vmware private-clouds clusters describe:
```
gcloud vmware private-clouds clusters describe CLUSTER_NAME \
 --location=ZONE \
 --project=PROJECT_ID \
 --private-cloud=PC_STORAGE_NODE_NAME
```
Reemplaza lo siguiente:
- CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
- ZONE: Es la zona de esta nube privada.
- PROJECT_ID: Es el ID del proyecto de la solicitud.
- PC_STORAGE_NODE_NAME: Es el nombre de la nube privada con nodo de solo almacenamiento.

API

Para crear una nube privada con nodos de solo almacenamiento mediante la API de VMware Engine, realiza una solicitud GET:

GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?alt=json&privateCloudId=PC_STORAGE_NODE_NAME" -d '{
  "description": "DESCRIPTION",
  "managementCluster": {
     "clusterId": "CLUSTER_NAME",
     "nodeTypeConfigs": {
        "standard-72": {
           "nodeCount": n
        },
        "storage-only-standard-72": {
           "nodeCount": m
        }
     }
     },
     "networkConfig": {
        "managementCidr": "IP_ADDRESS",
        "vmwareEngineNetwork": "projects/PROJECT_ID/locations/ZONE/vmwareEngineNetworks/NETWORK_NAME"
      }
     }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada con nodo de solo almacenamiento.
DESCRIPTION: Es la descripción de esta nube privada.
CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
n: Es la cantidad de nodos estándar en el clúster principal de esta nube privada.
m: Es la cantidad de nodos de solo almacenamiento en el clúster principal de esta nube privada.
IP_ADDRESS: Es la dirección IP y el rango de esta nube privada, por ejemplo, 192.168.0.0/22.
NETWORK_NAME: Es el nombre de la red.

Expande un clúster con nodos de solo almacenamiento

Para expandir un clúster estándar, agrega nodos de solo almacenamiento con Google Cloud CLI o la API de VMware Engine. Para ello, haz lo siguiente:

gcloud

Para expandir un clúster mediante nodos de solo almacenamiento con Google Cloud CLI, usa el comando gcloud vmware private-clouds clusters update:

  gcloud vmware private-clouds clusters update CLUSTER_NAME \
     --private-cloud=PC_STORAGE_NODE_NAME \
     --location=ZONE \
     --project=PROJECT_ID \
     --update-nodes-config=type=storage-only-standard-72,count=m

Reemplaza lo siguiente:

CLUSTER_NAME: Es el nombre del clúster en esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
ZONE: Es la zona de esta nube privada.
PROJECT_ID: Es el ID del proyecto de la solicitud.
m: Es la nueva cantidad total de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

API

Para expandir un clúster mediante la adición de nodos de solo almacenamiento con la API de VMware Engine, realiza una solicitud PATCH:

PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_STORAGE_NODE_NAME/clusters/CLUSTER_NAME/?alt=json&updateMask=node_type_configs.*.node_count" -d '{
  "nodeTypeConfigs": {
     "standard-72": {
        "nodeCount": n
     },
     "storage-only-standard-72": {
        "nodeCount": m
     }
   }
  }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
CLUSTER_NAME: Es el nombre del clúster en esta nube privada.
n: Es la cantidad de nodos estándar en el clúster especificado de esta nube privada.
m+1: Es la nueva cantidad total de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

Cómo reducir un clúster con nodos de solo almacenamiento

Para reducir un clúster que contenga nodos de solo almacenamiento, usa Google Cloud CLI o la API de VMware Engine de la siguiente manera:

gcloud

Para reducir un clúster que contenga nodos de solo almacenamiento mediante Google Cloud CLI, usa el comando gcloud vmware private-clouds clusters update:

  gcloud vmware private-clouds clusters update CLUSTER_NAME \
     --private-cloud=PC_STORAGE_NODE_NAME \
     --location=ZONE \
     --project=PROJECT_ID \
     --update-nodes-config=type=storage-only-standard-72,count=m

Reemplaza lo siguiente:

CLUSTER_NAME: Es el nombre del clúster en esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
ZONE: Es la zona de esta nube privada.
PROJECT_ID: Es el ID del proyecto de la solicitud.
m: Es la nueva cantidad total de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

API

Para reducir un clúster que contenga nodos de solo almacenamiento mediante la API de VMware Engine, realiza una solicitud PATCH:

PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_STORAGE_NODE_NAME/clusters/CLUSTER_NAME/?alt=json&updateMask=node_type_configs.*.node_count" -d '{
  "nodeTypeConfigs": {
     "standard-72": {
        "nodeCount": n
     },
     "storage-only-standard-72": {
        "nodeCount": m
     }
   }
  }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
CLUSTER_NAME: Es el nombre del clúster en esta nube privada.
n: Es la cantidad de nodos estándar en el clúster especificado de esta nube privada.
m: Es la nueva cantidad total de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

Crea un clúster nuevo con nodos de solo almacenamiento

Para crear un clúster nuevo en una nube privada existente que incluya nodos de solo almacenamiento mediante Google Cloud CLI o la API de VMware Engine, haz lo siguiente:

gcloud

Para crear un clúster nuevo con nodos de solo almacenamiento mediante Google Cloud CLI, usa el comando gcloud vmware private-clouds clusters create:

  gcloud vmware private-clouds clusters create CLUSTER_NAME \
     --private-cloud=PC_STORAGE_NODE_NAME \
     --location=ZONE \
     --project=PROJECT_ID \
     --node-type-config=type=standard-72,count=n \
     --node-type-config=type=storage-only-standard-72,count=m

Reemplaza lo siguiente:

CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
ZONE: Es la zona de esta nube privada.
PROJECT_ID: Es el ID del proyecto de la solicitud.
n: Es la cantidad de nodos estándar en el clúster especificado de esta nube privada.
m: Es la cantidad de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

API

Para crear un clúster nuevo en una nube privada con nodos de solo almacenamiento mediante la API de VMware Engine, realiza una solicitud PATCH:

PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_STORAGE_NODE_NAME/clusters?alt=json&clusterId=CLUSTER_NAME" -d '{
  "nodeTypeConfigs": {
     "standard-72": {
        "nodeCount": n
     },
     "storage-only-standard-72": {
        "nodeCount": m
     }
   }
  }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
n: Es la cantidad de nodos estándar en el clúster especificado de esta nube privada.
m: Es la cantidad de nodos de solo almacenamiento en el clúster especificado de esta nube privada.

Borra un clúster con nodos de solo almacenamiento

Puedes borrar un clúster que contenga nodos de solo almacenamiento con Google Cloud CLI o la API de VMware Engine de la siguiente manera:

gcloud

Para borrar un clúster que contenga nodos de solo almacenamiento mediante Google Cloud CLI, usa el comando gcloud vmware private-clouds clusters delete:

  gcloud vmware private-clouds clusters delete CLUSTER_NAME \
     --private-cloud=PC_STORAGE_NODE_NAME \
     --location=ZONE \
     --project=PROJECT_ID

Reemplaza lo siguiente:

CLUSTER_NAME: Es el nombre del clúster en esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
ZONE: Es la zona de esta nube privada.
PROJECT_ID: Es el ID del proyecto de la solicitud.

API

Para borrar un clúster que contenga nodos de solo almacenamiento mediante la API de VMware Engine, realiza una solicitud DELETE:

DELETE "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_STORAGE_NODE_NAME/clusters/CLUSTER_NAME/?alt=json"

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
CLUSTER_NAME: Es el nombre del clúster en esta nube privada.

Crea una nube privada extendida con nodos solo de almacenamiento

Puedes crear una nube privada extendida de VMware Engine que contenga nodos estándar y solo de almacenamiento mediante Google Cloud CLI o la API de VMware Engine.

gcloud

Para crear una nube privada extendida que contenga nodos de solo almacenamiento mediante Google Cloud CLI, haz lo siguiente:

Para crear una nube privada extendida, ingresa el comando gcloud private-clouds create:
```
gcloud vmware private-clouds create STRETCHED_PC_STORAGE_NODE_NAME \
 --description=DESCRIPTION \
 --location=REGION \
 --cluster=STRETCHED_CLUSTER_NAME \
 --node-type-config=type=standard-72,count=n \
 --node-type-config=type=storage-only-standard-72,count=m \
 --management-range=IP_ADDRESS \
 --vmware-engine-network=NETWORK_NAME
 --preferred-zone=projects/PROJECT_ID/locations/PREFERRED_ZONE \
 --secondary-zone=projects/PROJECT_ID/locations/SECONDARY_ZONE \
 --type=STRETCHED
```
Reemplaza lo siguiente:
- STRETCHED_PC_STORAGE_NODE_NAME: Es el nombre de la nube privada extendida con nodo de solo almacenamiento.
- DESCRIPTION: Es la descripción de esta nube privada.
- REGION: Es la región de esta nube privada.
- STRETCHED_CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
- n: Es la cantidad total de nodos estándar, un número par, en el clúster principal de esta nube privada.
- m: Es la cantidad total de nodos de solo almacenamiento, un número par, en el clúster principal de esta nube privada.
- IP_ADDRESS: Es la dirección IP y el rango de esta nube privada, por ejemplo, 192.168.0.0/22.
- NETWORK_NAME: Es el nombre de la red.
- PROJECT_ID: Es el ID del proyecto de la solicitud.
- SECONDARY_ZONE: Es la zona secundaria de la solicitud.
- PREFERRED_ZONE: Es la zona preferida para la solicitud.
Opcional: Para confirmar la creación de la nube privada extendida y la cantidad de nodos estándar y de solo almacenamiento, usa los comandos gcloud vmware private-clouds describe y gcloud vmware private-clouds clusters describe, respectivamente:
```
gcloud vmware private-clouds describe STRETCHED_PC_STORAGE_NODE_NAME \
 --location=REGION
```
Reemplaza lo siguiente:
- STRETCHED_PC_STORAGE_NODE_NAME: Es el nombre de la nube privada extendida.
- REGION: Es la región de esta nube privada.
```
gcloud vmware private-clouds clusters describe STRETCHED_CLUSTER_NAME \
 --location=REGION \
 --project=PROJECT_ID \
 --private-cloud=STRETCHED_PC_STORAGE_NODE_NAME
```
Reemplaza lo siguiente:
- STRETCHED_CLUSTER_NAME: Es el nombre del clúster extendido en esta nube privada.
- REGION: Es la región de esta nube privada.
- PROJECT_ID: Es el ID del proyecto de la solicitud.
- STRETCHED_PC_STORAGE_NODE_NAME: Es el nombre de la nube privada extendida.

API

Para crear una nube privada extendida que contenga nodos de solo almacenamiento mediante la API de VMware Engine, realiza una solicitud GET:

GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?alt=json&privateCloudId=PC_STORAGE_ONLY_NODE_NAME" -d '{
  "description": "DESCRIPTION",
  "managementCluster": {
     "clusterId": "CLUSTER_NAME",
     "nodeTypeConfigs": {
        "standard-72": {
           "nodeCount": n
        },
        "storage-only-standard-72": {
           "nodeCount": m
        }
     }
     },
     "networkConfig": {
        "managementCidr": "IP_ADDRESS",
        "vmwareEngineNetwork": "projects/PROJECT_ID/locations/ZONE/vmwareEngineNetworks/NETWORK_NAME"
      }
     }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
ZONE: Es la zona de esta nube privada.
PC_STORAGE_NODE_NAME: Es el nombre de la nube privada con nodo de solo almacenamiento.
DESCRIPTION: Es la descripción de esta nube privada.
CLUSTER_NAME: Es el nombre del clúster nuevo en esta nube privada.
n: Es la cantidad total de nodos estándar, un número par, en el clúster principal de esta nube privada.
m: Es la cantidad total de nodos de solo almacenamiento, un número par, en el clúster principal de esta nube privada.
IP_ADDRESS: Es la dirección IP y el rango de esta nube privada, por ejemplo, 192.168.0.0/22.
NETWORK_NAME: Es el nombre de la red.

Expande o contrae un clúster extendido con nodos de solo almacenamiento

Para expandir o reducir un clúster extendido, agrega o quita nodos de solo almacenamiento con Google Cloud CLI o la API de VMware Engine de la siguiente manera:

gcloud

Para expandir o reducir un clúster extendido agregando o quitando nodos de solo almacenamiento con Google Cloud CLI, usa el comando gcloud vmware private-clouds clusters update:

  gcloud vmware private-clouds clusters update STRETCHED_CLUSTER_NAME \
     --location=REGION \
     --project=PROJECT_ID \
     --private-cloud=STRETCHED_PC_STORAGE_NODE_NAME \
     --node-type-config=type=standard-72,count=n \
     --node-type-config=type=storage-only-standard-72,count=m

Reemplaza lo siguiente:

STRETCHED_CLUSTER_NAME: Es el nombre del clúster extendido en esta nube privada.
REGION: Es la región de esta nube privada.
PROJECT_ID: Es el ID del proyecto de la solicitud.
STRETCHED_PC_STORAGE_NODE_NAME: Es el nombre de la nube privada.
n: Es la nueva cantidad total de nodos estándar, un número par, para este clúster especificado.
m: Es la nueva cantidad total de nodos de solo almacenamiento, un número par, para este clúster especificado.

API

Para expandir o reducir un clúster extendido agregando o quitando nodos de solo almacenamiento con la API de VMware Engine, realiza una solicitud PATCH:

PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateClouds/STRETCHED_PC_STORAGE_NODE_NAME/clusters/STRETCHED_CLUSTER_NAME" -d '{
  "nodeTypeConfigs": {
     "standard-72": {
        "nodeCount": n
     },
     "storage-only-standard-72": {
        "nodeCount": m
     }
   }
  }'

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la solicitud.
REGION: Es la región de esta nube privada.
STRETCHED_PC_STORAGE_NODE_NAME: Es el nombre de la nube privada extendida.
STRETCHED_CLUSTER_NAME: Es el nombre del clúster extendido en esta nube privada.
n: Es la nueva cantidad total de nodos estándar, un número par, para este clúster especificado.
m: Es la nueva cantidad total de nodos de solo almacenamiento, un número par, para este clúster especificado.

¿Qué sigue?

Administra la actividad y los recursos de la nube privada.