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:
-
Accede a tu cuenta de Google.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
-
En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.
- Instala y, luego, inicializa Google Cloud CLI.
-
En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.
- Instala y, luego, inicializa Google Cloud CLI.
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 Cloud Console ve a la página Crear instancia.
Ingresa un nombre para la instancia.
Cloud Console 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.
Haz 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. 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
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 la casilla de verificación junto a Usar una 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=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 instanciaDISPLAY_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
. ReemplazaCLUSTER_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 es1
. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos. Más informaciónPara el ajuste de escala automático, proporciona las tres opciones
autoscaling-
en la marca--cluster-config
y no usescluster-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 marcacluster-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 esSSD
. 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.
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
: Identificador permanente de la instanciaDISPLAY_NAME
: Un nombre legible que identifica la instancia en Cloud Console.CLUSTER_ID
: Identificador permanente del clústerCLUSTER_ZONE
: La zona donde se ejecuta el clústerCLUSTER_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 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
: Identificador permanente de la instancia que acabas de crear.CLUSTER_ID
: Identificador permanente del clústerZONE
: La zona donde se ejecuta el clústerCada 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
: 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 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.
¿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.