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.

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 Cloud Console ve a la página Crear instancia.

    Ir a Crear instancia

  2. Ingresa un nombre para la instancia.

    Cloud Console 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. Más información.

  6. Haz 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

  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] \
    [kms-key=KMS_KEY]

    Reemplaza lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia
    • DISPLAY_NAME: Un nombre legible que identifica la instancia en Cloud Console.
    • CLUSTER_ZONE: La zona donde 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. 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 las tres opciones autoscaling- en la marca --cluster-config y no uses cluster-num-nodes. Consulta Ajuste de escala automático para obtener orientación sobre cómo elegir los valores para tu configuración de ajuste de escala automático. Reemplaza las siguientes opciones en la marca 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 uso de CPU objetivo para el clúster. Este valor debe ser de 10 a 80.

    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 identifica la instancia en Cloud Console.
    • CLUSTER_ID: Identificador permanente del clúster
    • CLUSTER_ZONE: La zona donde 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: Identificador permanente del clúster

    • ZONE: La zona donde 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?