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 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 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 el entorno y hacer una planificación inicial:

Selecciona o crea un proyecto de GCP.

Ir a la página de selección de proyecto

Importante: El nombre de un proyecto debe tener entre 4 y 30 caracteres. Cuando escribes el nombre, el formulario sugiere un ID del proyecto que puedes editar. El ID del proyecto debe tener entre 6 y 30 caracteres y comenzar con una letra minúscula. El último carácter no puede ser un guion. Es posible que los identificadores de proyecto se conserven más allá de su duración, por lo que no debes usar información sensible para el nombre o ID del proyecto.
Asegúrate de que la facturación esté habilitada en tu proyecto de Google Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.
Habilita las API de Cloud Bigtable y Cloud Bigtable Admin.

Habilitar las API
Haz clic en Ir a Credenciales.
En la página Credenciales, responde las preguntas obligatorias:
1. Para responder “¿Qué API estás usando?”, elige API de Cloud Bigtable.
2. Responde la pregunta sobre App Engine o Compute Engine. En esta guía de inicio rápido, no los usarás.
3. Haz clic en ¿Qué credenciales necesito?
4. Si se te solicita que crees una cuenta de servicio, proporciona la siguiente información:
  1. Elige un nombre para tu cuenta de servicio.
  2. En Función, selecciona Cloud Bigtable > Administrador de Bigtable.
  3. En Tipo de clave, selecciona JSON.
  4. Haz clic en Continuar.
  5. Guarda el archivo JSON que acabas de crear para la cuenta de servicio en tu directorio local HOME o en la ubicación que prefieras.
5. Si no se te solicita que crees una cuenta de servicio nueva, haz clic en Listo.
Si quieres usar las herramientas de línea de comandos de Cloud Bigtable, instala el SDK de Cloud y la herramienta de línea de comandos de cbt si aún no lo hiciste.
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.

Crea una instancia

Sigue estos pasos para crear una instancia de Cloud Bigtable:

Console

Abre la página Crear una instancia en Cloud Console.

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

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.
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
Para habilitar la replicación, haz clic en Agregar clúster replicado y, luego, actualiza la configuración del segundo clúster. Repite este paso para crear hasta 4 clústeres en la instancia. También puedes habilitar la replicación más tarde 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.
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.

Cloud Console muestra cómo el tipo de disco y la cantidad de nodos afectan a la capacidad de procesamiento y el costo.
Haz clic en Crear para crear la instancia.
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

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] \
```
Ingresa los siguientes valores:
- INSTANCE_ID: Identificador permanente de la instancia
- 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 Cloud Bigtable esté disponible en al menos otra zona de esa región. Consulta la lista de zonas.
- DISPLAY_NAME: Un nombre legible que identifica la instancia en Cloud Console.
El comando acepta las siguientes marcas opcionales:
- --cluster-num-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-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.
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:
```
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: 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 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 distinta, como europe-west2-a.
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.
- --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.
Repite el paso anterior para crear hasta 4 clústeres en la instancia.
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

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: 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 Cloud 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. Más información.
- 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. 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
```
Ingresa los siguientes valores:
- 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 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 distinta, 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.
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.

Próximos pasos

Descubre cómo Cloud Bigtable usa instancias, clústeres y nodos.
Obtén más información sobre replicación de Cloud 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.