Modifica una instancia de Cloud Bigtable

Después de crear una instancia de Cloud Bigtable, puedes actualizar cualquiera de las siguientes configuraciones sin tiempo de inactividad:

  • La cantidad de nodos de cada clúster

    Cuando se agregan o quitan nodos, Cloud Bigtable, por lo general, tarda unos minutos en optimizar el rendimiento del clúster.

  • La cantidad de clústeres de la instancia

    Cuando agregas un clúster, Cloud Bigtable demora en replicar tus datos en el clúster nuevo. Los clústeres nuevos se replican desde el clúster más cercano geográficamente en la instancia. En general, cuanto mayor sea la distancia, más larga será la replicación.

  • Los perfiles de aplicaciones de la instancia, que contienen la configuración de replicación

  • Las etiquetas de la instancia, que se encargan de proporcionar los metadatos

  • El nombre visible de la instancia

También puedes actualizar una instancia de desarrollo a una instancia de producción sin tiempo de inactividad. Este cambio es permanente.

Antes de comenzar

Si deseas usar la herramienta de línea de comandos de Cloud Bigtable, instala el SDK de Cloud y la herramienta de línea de comandos cbt si aún no la tienes.

Agrega o quita nodos

Los nodos son recursos de procesamiento que un clúster de Cloud Bigtable usa para acceder a los datos y ejecutar tareas administrativas. Debes supervisar el uso de CPU y del disco de cada clúster para asegurarte de que tenga nodos suficientes. Si deseas obtener más información sobre cómo la cantidad de nodos afecta el rendimiento de un clúster, consulta Rendimiento de las cargas de trabajo típicas.

En la configuración predeterminada, puedes aprovisionar hasta 30 nodos de Cloud Bigtable por zona en cada proyecto de Google Cloud Platform. Si necesitas aprovisionar más nodos que el límite predeterminado, usa el formulario de solicitud de nodos.

Para cambiar la cantidad de nodos de un clúster, sigue estos pasos:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. Haz clic en el clúster que quieres actualizar.

  4. En Nodos, ingresa la cantidad de nodos del clúster.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  5. Haz clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes los ID de los clústeres de la instancia, usa el comando bigtable clusters list para ver una lista de los clústeres en la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters update para cambiar la cantidad de nodos:

    gcloud bigtable clusters update CLUSTER_ID \
        --instance=INSTANCE_ID \
        --num-nodes=NUM_NODES
    

    Ingresa los siguientes valores:

    • CLUSTER_ID: El identificador permanente del clúster.
    • INSTANCE_ID: El identificador permanente de la instancia.
    • NUM_NODES: La cantidad de nodos del clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

cbt

  1. Si no tienes el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances
    
  2. Si no tienes los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de ellos:

    cbt -instance=INSTANCE_ID listclusters
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando updatecluster para cambiar la cantidad de nodos:

    cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • CLUSTER_ID: El identificador permanente del clúster.
    • NUM_NODES: La cantidad de nodos del clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

Agrega y borra clústeres

Una instancia puede tener hasta 4 clústeres. Las instancias con 2 o más clústeres usan la replicación automáticamente.

Agrega un clúster

Puedes agregar clústeres a una instancia existente, hasta un máximo de 4 clústeres por instancia. Los clústeres pueden estar en cualquier región donde esté disponible Cloud Bigtable, siempre y cuando cada clúster esté en una zona diferente. Las ubicaciones ideales de los clústeres adicionales dependen de tu caso práctico. Antes de agregar clústeres a una instancia de un único clúster, consulta los ejemplos de configuración de la replicación para obtener recomendaciones.

Para agregar un clúster a una instancia, sigue estos pasos:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Clústeres, haz clic en Agregar clúster.

    Si este botón está inhabilitado, la instancia ya tiene la cantidad máxima de clústeres.

  4. Ingresa el ID de un clúster, y selecciona su región y zona.

  5. Ingresa la cantidad de nodos del clúster.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  6. Haz clic en Guardar. Cloud Bigtable crea el clúster y comienza a replicar tus datos. Es posible que notes un aumento en el uso de CPU cuando comience la replicación.

  7. A continuación, revisa la configuración de la replicación en el perfil predeterminado de la aplicación a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil predeterminado de la aplicación o crear perfiles de aplicación personalizados.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes los ID de los clústeres de la instancia, usa el comando bigtable clusters list para ver una lista de los clústeres en la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters create para agregar un clúster:

    gcloud bigtable clusters create CLUSTER_ID \
        --async \
        --instance=INSTANCE_ID \
        --zone=ZONE \
        [--num-nodes=NUM_NODES] \
        [--storage-type=STORAGE_TYPE]
    

    Ingresa los siguientes valores:

    • CLUSTER_ID: El identificador permanente del clúster.
    • INSTANCE_ID: El identificador permanente de la instancia.
    • ZONE: La zona donde se ejecuta el clúster.

      Los clústeres de una instancia deben estar en zonas únicas. Puedes crear un clúster adicional en cualquier zona en la que Cloud Bigtable esté disponible. Por ejemplo, si el primer clúster está en us-east1-b, puedes elegir una zona diferente en la misma región, como us-east1-c, o una zona en otra región, como europe-west2-a. Ver la lista de zonas.

    La marca --async no es obligatoria, pero se recomienda. Sin esta marca, es posible que el comando agote el tiempo de espera antes de completar la operación. Cloud Bigtable continuará con la creación del clúster en segundo plano.

    El comando acepta las siguientes marcas opcionales:

    • --num-nodes=NUM_NODES: La cantidad de nodos del clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más. El valor predeterminado es 3.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

    • --storage-type=STORAGE_TYPE: El tipo de almacenamiento que se usará en el clúster. Todos los clústeres de una instancia deben usar el mismo tipo de almacenamiento. Acepta los valores SSD y HDD. El valor predeterminado es SSD.

  4. A continuación, revisa la configuración de la replicación en el perfil predeterminado de la aplicación a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil predeterminado de la aplicación o crear perfiles de aplicación personalizados.

cbt

  1. Si no tienes el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances
    
  2. Si no tienes los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de ellos:

    cbt -instance=INSTANCE_ID listclusters
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando createcluster para agregar un clúster:

    
    cbt -instance=INSTANCE_ID createcluster CLUSTER_ID ZONE NUM_NODES STORAGE_TYPE
    
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • CLUSTER_ID: El identificador permanente del clúster.
    • ZONE: La zona donde se ejecuta el clúster.

      Los clústeres de una instancia deben estar en zonas únicas. Puedes crear un clúster adicional en cualquier zona en la que Cloud Bigtable esté disponible. Por ejemplo, si el primer clúster está en us-east1-b, puedes elegir una zona diferente en la misma región, como us-east1-c, o una zona en otra región, como europe-west2-a. Ver la lista de zonas.

    • NUM_NODES: La cantidad de nodos del clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

    • STORAGE_TYPE: El tipo de almacenamiento que se usará en el clúster. Todos los clústeres de una instancia deben usar el mismo tipo de almacenamiento. Acepta los valores SSD y HDD.

  4. A continuación, revisa la configuración de la replicación en el perfil predeterminado de la aplicación a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil predeterminado de la aplicación o crear perfiles de aplicación personalizados.

Borra un clúster

Si una instancia tiene varios clústeres, puedes borrar todos los clústeres, excepto 1. Si borras todos los clústeres, excepto 1, la replicación se inhabilita automáticamente.

En algunos casos, Cloud Bigtable no te permite borrar un clúster:

  • Si uno de tus perfiles de aplicación enruta todo el tráfico a un solo clúster, Cloud Bigtable no te dejará borrarlo. Debes editar o borrar el perfil de aplicación para poder quitar el clúster.
  • Si agregas clústeres nuevos a una instancia existente, no puedes borrar los clústeres en esa instancia hasta que se complete la copia inicial de datos en los clústeres nuevos.

Para borrar un clúster de una instancia, sigue estos pasos:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. Haz clic en el clúster que deseas borrar y, luego, en el ícono Borrar en la esquina superior derecha de la configuración.

  4. Haz clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes los ID de los clústeres de la instancia, usa el comando bigtable clusters list para ver una lista de los clústeres en la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters delete para borrar el clúster:

    gcloud bigtable clusters delete CLUSTER_ID \
        --instance=INSTANCE_ID
    

    Ingresa los siguientes valores:

    • CLUSTER_ID: El identificador permanente del clúster.
    • INSTANCE_ID: El identificador permanente de la instancia.

cbt

  1. Si no tienes el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances
    
  2. Si no tienes los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de ellos:

    cbt -instance=INSTANCE_ID listclusters
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando deletecluster para borrar el clúster:

    cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • CLUSTER_ID: El identificador permanente del clúster.

Administrar los perfiles de aplicación

Los perfiles de aplicación controlan la manera en que tus aplicaciones se conectan a una instancia que usa la replicación. Todas las instancias con más de 1 clúster tienen su propio perfil de aplicación predeterminado. También puedes crear varios perfiles de aplicación personalizados para cada instancia y asignar uno distinto a cada tipo aplicación que uses.

Si deseas aprender a configurar los perfiles de aplicación de una instancia, consulta Cómo configurar los perfiles de aplicación. Si deseas obtener ejemplos de la configuración que puedes usar para implementar casos prácticos comunes, consulta Ejemplos de configuración de la replicación.

Administrar las etiquetas

Las etiquetas son pares clave-valor que puedes usar para agrupar las instancias relacionadas y almacenar metadatos de una instancia.

Si deseas aprender a administrar etiquetas, consulta Agrega o actualiza las etiquetas de una instancia y Quita una etiqueta de una instancia.

Cambiar el nombre visible de una instancia

Si deseas cambiar el nombre visible de una instancia, que GCP Console usa para identificarla, sigue estos pasos:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. Edita el nombre de la instancia y, luego, haz clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Usa el comando bigtable instances update para actualizar el nombre visible:

    gcloud bigtable instances update INSTANCE_ID \
        --display-name=DISPLAY_NAME
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • DISPLAY_NAME: Un nombre en lenguaje legible que identifique la instancia en GCP Console.

cbt

Esta característica no está disponible en la herramienta cbt.

Actualizar una instancia de desarrollo

Si quieres dejar de usar una instancia de desarrollo para la programación y las pruebas, puedes actualizarla a una instancia de producción en cualquier momento. Esta actualización es permanente.

Para actualizar una instancia de desarrollo a una de producción de forma permanente, sigue estos pasos:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Busca el texto que diga Tipo: Desarrollo y haz clic en el vínculo Actualizar al costado del texto.

  3. Edita el nombre de la instancia si es necesario.

  4. En Tipo de instancia, selecciona Producción.

  5. Si necesitas más de 3 nodos en tu clúster, haz clic en la casilla del primero y edita la cantidad de nodos.

  6. Si quieres usar la replicación en la instancia, haz clic en Agregar clúster y actualiza su ID, la zona y la cantidad de nodos del clúster nuevo.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  7. Haz clic en Guardar para actualizar la instancia.

    Si agregaste un segundo clúster, Cloud Bigtable comenzará a replicar los datos en el clúster nuevo.

  8. A continuación, revisa la configuración de la replicación en el perfil predeterminado de la aplicación a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil predeterminado de la aplicación o crear perfiles de aplicación personalizados.

gcloud

Usa el comando bigtable instances upgrade:

gcloud bigtable instances upgrade INSTANCE_ID

Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

La instancia actualizada tiene un solo clúster de 3 nodos. Después de actualizar la instancia, puedes agregar un clúster o agregar nodos al clúster existente.

cbt

Esta característica no está disponible en la herramienta cbt.

¿Qué sigue?

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Bigtable