Crear una instancia de Bigtable.

Una instancia de Cloud Bigtable es un contenedor para hasta cuatro clústeres de Bigtable. Las instancias que usan replicación tienen dos o más clústeres, y las instancias sin replicación tienen uno solo.

En esta página se explica cómo crear una instancia con o sin replicación. 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 e inicializa el SDK de Cloud.
  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 e inicializa el SDK de Cloud.

Planifica tu configuración:

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

  2. Si planeas 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. Abre la página Crear una instancia en Cloud Console.

    Abrir la página Crear una 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.

    Si planeas usar la replicación en una sola región, asegúrate de que Bigtable esté disponible en al menos otra zona de esa región. Consulta la lista de zonas.

  9. Elige 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. Más información

  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 ID del recurso de la clave de CMEK que quieres usar para la instancia. 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, haz clic en Agregar clúster, ingresa la configuración del segundo clúster y, luego, haz clic en Agregar (opcional). Repite este paso para crear hasta 4 clústeres en la instancia. También puedes habilitar la replicación más adelante si agregas un 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 Bigtable esté disponible. Si el botón Agregar clúster está inhabilitado, cambia la zona de tu primer clúster.

  12. Haga clic en Create para crear la instancia.

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

gcloud

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

    gcloud bigtable instances create INSTANCE_ID \
        --display-name=DISPLAY_NAME \
        [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE,[nodes=CLUSTER_NUM_NODES,kms-key=KMS_KEY]] \
        [--cluster-storage-type=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

      Si planeas usar la replicación en una sola región, asegúrate de que Bigtable esté disponible en al menos otra zona de esa región. Consulta la lista de zonas.

    El comando acepta las siguientes marcas opcionales:

    • --cluster-config=nodes=CLUSTER_NUM_NODES: La cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 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.
    • --cluster-config=kms-key=KMS_KEY: Un ID de clave de CMEK. Usa esto si deseas que la instancia esté protegida por CMEK. No podrás agregar esto más adelante. Obtenga más información.

    • --cluster-storage-type=CLUSTER_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.

      En la mayoría de los casos, el valor predeterminado es el mejor. Esta elección es permanente. Más información

  2. Si quieres habilitar la replicación para una instancia de producción, usa el comando bigtable clusters create a fin de agregar un clúster (opcional):

    gcloud bigtable clusters create CLUSTER_ID \
        --instance=INSTANCE_ID \
        --zone=ZONE \
        [--num-nodes=NUM_NODES] \
        [--kms-key=KMS_KEY] \
        [--project=PROJECT]
    

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster
    • INSTANCE_ID: Identificador permanente de la instancia que acabas de crear.
    • 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 Bigtable esté disponible. Por ejemplo, si el primer clúster está en us-east1-b, puede elegir una zona diferente en la misma región, como us-east1-c, o una zona en otra región, como europe-west2-a.

      Excepción: Si la instancia está protegida por CMEK, la zona debe estar en la misma región que la clave de CMEK. Más información

    El comando acepta las siguientes marcas opcionales:

    • --num-nodes=NUM_NODES: La 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.

    • --kms-key=KMS_KEY: La clave de CMEK que usa la instancia. Puedes agregar clústeres de CMEK solo a instancias que ya están protegidas con CMEK.

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

  3. Repite el paso anterior para crear hasta 4 clústeres en la instancia.

  4. A continuación, revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso práctico 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

      Si planeas usar la replicación en una sola región, asegúrate de que Bigtable esté disponible en al menos otra zona de esa región. Consulta la lista de zonas.

    • CLUSTER_NUM_NODES: La 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. Obtenga 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

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

    • NUM_NODES: La 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. A continuación, revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

¿Qué sigue?