Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Crea una instancia

Una instancia de Cloud Bigtable es un contenedor para clústeres de Bigtable. Una instancia que tiene más de un clúster usa la replicación. Puedes crear clústeres en hasta 8 regiones, con tantos clústeres en cada región como zonas haya.

En esta página se explica cómo crear una instancia. Antes de leer esta página, debes familiarizarte con la descripción general de Bigtable. Además, te recomendamos que leas la descripción general de instancias, clústeres y nodos.

Antes de comenzar

Prepara el entorno:

  1. Accede a tu cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.

    Habilita las API

  5. Instala y, luego, inicializa Google Cloud CLI.
  6. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  8. Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.

    Habilita las API

  9. Instala y, luego, inicializa Google Cloud CLI.
  10. Ejecuta el siguiente comando para instalar la CLI de cbt:
    gcloud components install cbt

Planifica tu configuración:

  1. Opcional: si planeas habilitar la replicación, sigue estos pasos:

  2. Opcional: Si deseas usar claves de encriptación administradas por el cliente (CMEK) en lugar de la encriptación predeterminada administrada por Google, completa las tareas de Crea una instancia habilitada para CMEK y ten el ID de clave de CMEK listo antes de crear la instancia nueva. No puedes agregar la protección con CMEK a una instancia después de crearla, tampoco puedes modificar ni reemplazar la clave de CMEK después de crear la instancia.

Crea una instancia

Sigue estos pasos para crear una instancia de Bigtable:

Console

  1. En la consola de Google Cloud, ve a la página Crear instancia.

    Ir a Crear instancia

  2. Ingresa un nombre para la instancia.

    La consola de Google Cloud muestra este nombre para identificar tu instancia.

  3. Ingresa un ID de instancia.

    El ID de instancia es un identificador permanente de la instancia.

  4. Haga clic en Continuar.

  5. Elige si deseas usar un disco SSD o HDD para tus clústeres. En la mayoría de los casos, el SSD es la mejor opción. Esta elección es permanente. Obtén más información.

  6. Haga clic en Continuar.

  7. Ingresa el ID del clúster para el primer clúster.

    El ID del clúster es un identificador permanente del clúster.

  8. Elige la región y zona en la que se ejecutará el primer clúster.

  9. Elige un modo de escalamiento de nodos para el clúster. Para obtener orientación sobre el escalamiento, consulta Ajuste de escala automático.

    1. En Asignación de nodos manual, ingresa la cantidad de nodos de Bigtable del primer clúster. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos.
    2. En Ajuste de escala automático, ingresa los valores de lo siguiente:
      • Cantidad mínima de nodos
      • Cantidad máxima de nodos
      • Objetivo de uso de CPU
      • Objetivo de uso de almacenamiento
  10. Para proteger tu instancia con CMEK en lugar de la encriptación predeterminada administrada por Google, completa lo siguiente (opcional):

    1. Haz clic en Mostrar opciones de encriptación.
    2. Selecciona la casilla de verificación junto a Usar una clave de encriptación administrada por el cliente (CMEK).
    3. Selecciona o ingresa el nombre del recurso para la clave de CMEK que deseas usar para el clúster. No podrás agregar esto más adelante.
    4. Si se te solicita que otorgues permiso a la cuenta de servicio de la clave CMEK, haz clic en Otorgar. Tu cuenta de usuario debe tener la función de administrador de Cloud KMS para completar esta tarea.
    5. Haz clic en Guardar.
  11. Para habilitar la replicación ahora, completa los siguientes pasos adicionales (opcional):

    1. Haz clic en Show advanced options.
    2. Haz clic en Agregar clúster, ingresa la configuración del clúster y, luego, haz clic en Agregar. Repite este paso para crear clústeres adicionales en la instancia. También puedes habilitar la replicación más adelante si agregas un clúster.

    Cada zona de una región puede contener solo un clúster. Si el botón Agregar clúster está inhabilitado, cambia la zona de tu primer clúster.

    Para crear una instancia que tenga más de seis clústeres, primero crea una instancia que tenga seis clústeres y, luego, agrega más clústeres a la instancia.

  12. Haga clic en Crear para crear la instancia.

  13. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

gcloud

  1. Usa el comando bigtable instances create para crear una instancia:

    gcloud bigtable instances create INSTANCE_ID \
        --display-name=DISPLAY_NAME \
        [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \
        [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
        nodes=CLUSTER_NUM_NODES] \
        [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
        autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
        autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
        autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \
        autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET] \
        [kms-key=KMS_KEY]
    

    Reemplaza lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia
    • DISPLAY_NAME: Un nombre legible que identifique la instancia en Google Cloud Console.
    • CLUSTER_ZONE: La zona en la que se ejecuta el clúster.

    Si la instancia está protegida por CMEK, cada clúster debe estar en la misma región que la clave CMEK. Obtén más información.

    Debes configurar al menos un clúster para la instancia con la marca --cluster-config. Si deseas crear una instancia que tenga varios clústeres, repite la marca --cluster-config para cada clúster.

    Para la asignación de nodo manual, usa la opción cluster-num-nodes en la marca --cluster-config. Reemplaza CLUSTER_NUM_NODES por la cantidad de nodos del clúster. Cada clúster de una instancia debe tener uno o más nodos. El valor predeterminado es 1. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos. Más información

    Para el ajuste de escala automático, proporciona opciones autoscaling- en la marca --cluster-config (autoscaling-storage-target es opcional) y no uses cluster-num-nodes. Consulta Ajuste de escala automático a fin de obtener orientación para elegir los valores de la configuración del ajuste de escala automático. Reemplaza lo siguiente por las claves de opción cluster-config:

    • AUTOSCALING_MIN_NODES: La cantidad mínima de nodos para el clúster.
    • AUTOSCALING_MAX_NODES: La cantidad máxima de nodos para el clúster.
    • AUTOSCALING_CPU_TARGET: el porcentaje de uso de CPU objetivo para el clúster. Este valor debe ser de 10 a 80.
    • AUTOSCALING_STORAGE_TARGET: Es el objetivo de uso de almacenamiento en GiB que mantiene Bigtable agregando o quitando nodos (opcional).

    El comando acepta las siguientes marcas opcionales:

    • --cluster-storage-type=CLUSTER_STORAGE_TYPE: El tipo de almacenamiento que se usará en la instancia. El valor predeterminado es SSD. En la mayoría de los casos, el valor predeterminado es el mejor. Esta elección es permanente. Más información.

    • --kms-key=KMS_KEY: es la clave CMEK para el clúster. Puedes agregar clústeres de CMEK solo a instancias que ya están protegidas con CMEK. Más información.

    • --project=PROJECT: El proyecto en el que se crea el clúster si es diferente al proyecto actual.

  2. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

cbt

  1. Comienza por crear una instancia con un solo clúster. Usa el comando createinstance para crear una instancia:

    cbt createinstance INSTANCE_ID DISPLAY_NAME CLUSTER_ID CLUSTER_ZONE \
        CLUSTER_NUM_NODES CLUSTER_STORAGE_TYPE
    

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia
    • DISPLAY_NAME: Un nombre legible que identifique la instancia en Google Cloud Console.
    • CLUSTER_ID: El identificador permanente del clúster.
    • CLUSTER_ZONE: La zona en la que se ejecuta el clúster.
    • CLUSTER_NUM_NODES: Cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más nodos. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos. Más información.
    • CLUSTER_STORAGE_TYPE: El tipo de almacenamiento que se usará para el clúster. Todos los clústeres de una instancia deben usar el mismo tipo de almacenamiento. Acepta los valores SSD y HDD. En la mayoría de los casos, SSD es la mejor opción. Esta elección es permanente. Más información.
  2. Para habilitar la replicación, usa el comando createcluster y agrega un clúster:

    
    cbt -instance=INSTANCE_ID createcluster CLUSTER_ID ZONE NUM_NODES STORAGE_TYPE
    
    

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia que acabas de crear
    • CLUSTER_ID: El identificador permanente del clúster.
    • ZONE: La zona en la que se ejecuta el clúster.

      Cada zona de una región puede contener solo un clúster. Por ejemplo, si una instancia tiene un clúster en us-east1-b, puedes agregar un clúster en una zona diferente en la misma región, como us-east1-c, o una zona en una región distinta, como europe-west2-a.

    • NUM_NODES: Cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más nodos.

      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.

  3. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación (opcional). Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

¿Qué sigue?