Crear una instancia de Cloud Bigtable

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

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

Antes de comenzar

Antes de comenzar, deberás preparar tu entorno y hacer una planificación inicial:

  1. Habilita las API de Cloud Bigtable:

    1. Select or create a Google Cloud Platform project.

      Go to the Manage resources page

    2. Asegúrate de tener habilitada la facturación para tu proyecto.

      Aprende a habilitar la facturación

    3. Habilita las Cloud Bigtable y Admin. de Cloud Bigtable API necesarias.

      Habilita las API

  2. 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 lo has hecho.

  3. Si planeas habilitar la replicación, lee la descripción general de la replicación.

    Debes identificar tu caso práctico de replicación. Con este fin, elige una región para tu instancia que ofrezca Cloud Bigtable en al menos dos zonas y decide cómo usarás los perfiles de aplicación, a fin de enrutar solicitudes de contenido nuevo.

Crea una instancia

Sigue estos pasos para crear una instancia de Cloud Bigtable:

Console

  1. Abre la página Crear instancia en GCP Console.

    Abrir la página Crea una instancia

    Captura de pantalla de la página “Crear instancia”

  2. Ingresa un nombre para la instancia.

    GCP 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. Selecciona el tipo de instancia a crear.

    Para el desarrollo y las pruebas, usa una instancia de desarrollo, que tenga un rendimiento limitado y no tenga un ANS. Puedes realizar una actualización a una instancia de producción más tarde. Más información

    Para otros fines, utiliza una instancia de producción. Esta elección es permanente. Más información

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

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

  6. 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 Cloud Bigtable esté disponible en al menos otra zona de esa región. Consulta la lista de zonas.

  7. Elige la cantidad de nodos de Cloud 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

  8. Para habilitar la replicación ahora, haz clic en Agregar clúster y, a continuación, actualiza la configuración del segundo clúster. También puedes habilitar la replicación 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 Cloud Bigtable esté disponible. Si el botón Agregar clúster está inhabilitado, cambia la zona de tu primer clúster.

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

    GCP Console muestra como el tipo de discos y la cantidad de nodos afectan tu capacidad de procesamiento y costo.

  10. Haz clic en Crear (Create) para crear la instancia.

  11. A continuación, revisa la configuración de replicación en el perfil de aplicación predeterminado a fin de ver si tiene sentido para tu caso práctico de replicación. Es posible que debas actualizar el perfil de aplicación predeterminado o crear perfiles de aplicación 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 \
        --cluster=CLUSTER_ID \
        --cluster-zone=CLUSTER_ZONE \
        --display-name=DISPLAY_NAME \
        [--cluster-num-nodes=CLUSTER_NUM_NODES] \
        [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \
        [--instance-type=INSTANCE_TYPE]
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • CLUSTER_ID: Identificador permanente del clúster
    • CLUSTER_ZONE: Zona donde se ejecuta el clúster

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

    • DISPLAY_NAME: Un nombre legible que identifique la instancia en GCP Console

    El comando acepta las siguientes marcas opcionales:

    • --cluster-num-nodes=CLUSTER_NUM_NODES: Cantidad de nodos en el clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más. El valor predeterminado es 3. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos. Más información

      No uses esta marca para instancias de desarrollo.

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

    • --instance-type=INSTANCE_TYPE: Tipo de instancia a crear. Acepta uno de los siguientes valores:

      • PRODUCTION (predeterminada): Una instancia de alta disponibilidad y potencia completa. Esta elección es permanente. Más información
      • DEVELOPMENT: Una instancia de bajo costo para desarrollo y pruebas, con un rendimiento limitado y sin ANS. Puedes realizar una actualización a una instancia de producción más tarde. Más información
  2. Si deseas habilitar la replicación de una instancia de producción, usa el comando bigtable clusters create para agregar un clúster:

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

    Ingresa los siguientes valores:

    • CLUSTER_ID: Identificador permanente del clúster
    • INSTANCE_ID: Identificador permanente de la instancia que acabas de crear
    • ZONE: 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 una región separada, como europe-west2-a.

    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.

      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.

  3. A continuación, revisa la configuración de replicación en el perfil de aplicación predeterminado a fin de ver si tiene sentido para tu caso práctico de replicación. Es posible que debas actualizar el perfil de aplicación predeterminado o crear perfiles de aplicación 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
    

    Ingresa los siguientes valores:

    • INSTANCE_ID: El identificador permanente de la instancia.
    • DISPLAY_NAME: Un nombre legible que identifique la instancia en GCP Console
    • CLUSTER_ID: Identificador permanente del clúster
    • CLUSTER_ZONE: Zona donde se ejecuta el clúster

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

    • CLUSTER_NUM_NODES: Cantidad de nodos en el clúster. Los clústeres de una instancia de producción deben tener 3 nodos o más. 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. Se aceptan 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. A fin de habilitar la replicación, 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: Identificador permanente de la instancia que acabas de crear
    • CLUSTER_ID: Identificador permanente del clúster
    • ZONE: 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 una región separada, como europe-west2-a.

    • NUM_NODES: Cantidad de nodos en el 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.

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

Próximos pasos

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

Enviar comentarios sobre…

Documentación de Cloud Bigtable