Crea una instancia
Una instancia de 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:
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Ejecuta el siguiente comando para instalar la CLI de
cbt
:gcloud components install cbt
Planifica tu configuración:
Opcional: si planeas habilitar la replicación, sigue estos pasos:
- Tómate unos minutos para leer la descripción general de la replicación.
- Identifica tu caso práctico para la replicación.
- Determina las regiones en las que debe estar la instancia, según tu caso práctico y la ubicación de la aplicación y el tráfico.
- Decide cómo usarás los perfiles de aplicaciones para enrutar las solicitudes entrantes.
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
En la consola de Google Cloud, ve a la página Crear instancia.
Ingresa un nombre para la instancia.
La consola de Google Cloud muestra este nombre para identificar tu instancia.
Ingresa un ID de instancia.
El ID de instancia es un identificador permanente de la instancia.
Haga clic en Continuar.
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.
Haga clic en Continuar.
Ingresa el ID del clúster para el primer clúster.
El ID del clúster es un identificador permanente del clúster.
Elige la región y zona en la que se ejecutará el primer clúster.
Elige un modo de escalamiento de nodos para el clúster. En la mayoría de los casos, debes elegir el ajuste de escala automático. Para obtener orientación sobre el escalamiento, consulta Ajuste de escala automático.
- 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.
- 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
Para proteger tu instancia con CMEK en lugar de la encriptación predeterminada administrada por Google, completa lo siguiente (opcional):
- Haz clic en Mostrar opciones de encriptación.
- Selecciona el botón de selección junto a Clave de encriptación administrada por el cliente (CMEK).
- 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.
- 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.
- Haz clic en Guardar.
Para habilitar la replicación ahora, completa los siguientes pasos adicionales (opcional):
- Haz clic en Show advanced options.
- 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.
Haga clic en Crear para crear la instancia.
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
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=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
: Es el identificador permanente de la instancia.DISPLAY_NAME
: Un nombre legible que identifica la instancia en la consola de Google Cloud.CLUSTER_ID
: El identificador permanente del clúster.CLUSTER_ZONE
: La zona donde se ejecuta el clúster.
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 manual de nodos, configurar
nodes
en la marca--cluster-config
es opcional. Si no se establece ningún valor, Bigtable asigna nodos al clúster automáticamente según tu espacio en datos y realiza optimizaciones para lograr un 50% de utilización del almacenamiento. Esta asignación automática de nodos tiene un impacto en los precios. Si deseas controlar la cantidad de nodos en un clúster, reemplazaNODES
por la cantidad de nodos que deseas en el clúster. Obtén más información sobre los nodos.En la mayoría de los casos, elige el ajuste de escala automático en lugar de la asignación manual de nodos. Para for_autoscaling, proporciona opciones
autoscaling-
en la marca--cluster-config
(autoscaling-storage-target
es opcional) y no usesnodes
. 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 lo siguiente por las teclas de opcióncluster-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
: (Opcional) El objetivo de uso de almacenamiento en GiB que mantiene Bigtable mediante la adición o la eliminación de nodos.KMS_KEY: es la clave CMEK para el clúster.
El valor KMS_KEY debe establecerse en el siguiente formato:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Reemplaza lo siguiente:
- PROJECT: El identificador permanente del proyecto
- LOCATION: Es la ubicación de tu clúster.
- KEYRING: Es el nombre del llavero de claves que contiene la clave.
- KEY: el nombre de la clave.
A continuación, se muestra un ejemplo:
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Si la instancia está protegida por CMEK, cada clúster debe estar en la misma región que la clave CMEK. Puedes agregar clústeres de CMEK solo a instancias que ya están protegidas con CMEK. Obtén más información.
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 esSSD
. En la mayoría de los casos, el valor predeterminado es el mejor. Esta elección es permanente. Obtén más información.--project=PROJECT
: El proyecto en el que se crea el clúster si es diferente al proyecto actual.
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
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
: Es el identificador permanente de la instancia.DISPLAY_NAME
: Un nombre legible que identifica la instancia en la consola de Google Cloud.CLUSTER_ID
: El identificador permanente del clúster.CLUSTER_ZONE
: La zona donde se ejecuta el clúster.CLUSTER_NUM_NODES
: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu espacio en datos y realiza optimizaciones para lograr un 50% de utilización de almacenamiento. Si quieres controlar la cantidad de nodos de un clúster, actualiza el valor deCLUSTER_NUM_NODES
. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero. Obtén más información sobre los nodos.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 valoresSSD
yHDD
. En la mayoría de los casos,SSD
es la mejor opción. Esta elección es permanente. Más información.
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
: Es el identificador permanente de la instancia que acabas de crear.CLUSTER_ID
: El 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, comous-east1-c
, o una zona en una región distinta, comoeurope-west2-a
.NUM_NODES
: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu espacio en datos y realiza optimizaciones para lograr un 50% de utilización de almacenamiento. Si quieres controlar la cantidad de nodos de un clúster, actualiza el valor deNUM_NODES
. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero.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 valoresSSD
yHDD
.
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.
C++
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta las bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
¿Qué sigue?
- Descubre cómo Bigtable usa instancias, clústeres y nodos.
- Obtén más información sobre la replicación en Bigtable.
- Revisa y actualiza el perfil de app predeterminado para la replicación y crea perfiles de app personalizados según sea necesario.
- Descubre cómo modificar una instancia existente.