Inicio rápido con un nodo

Vas a arrancar un nodo de TeselaDB en tu máquina, leer la contraseña de root y comprobar que el nodo responde. Un nodo solo ya es una base de datos completa: guarda tus colecciones, las divide en rangos y atiende a los drivers.

Qué vas a conseguir

Tardas unos cinco minutos. Al terminar tienes un nodo escuchando en 127.0.0.1 con TLS y usuarios activos, listo para que te conectes con mongosh o con el driver de tu lenguaje igual que te conectarías a un servidor de MongoDB, con la misma clase de cadena de conexión salvo la dirección del nodo y su CA.

Antes de empezar

Necesitas el binario teseladb en tu PATH. Si aún no lo tienes, sigue Instalar en Linux.

Paso 1. Arranca el nodo

teseladb start --dbpath ./data

El nodo guarda sus datos en el directorio que le das con --dbpath; sin esa opción usa ./teseladb-data. Al arrancar abre cuatro puertos en 127.0.0.1, cada uno para un tipo de tráfico distinto, y el de clientes solo acepta TLS:

Paso 2. Lee la contraseña de root

cat ./data/root-credentials.txt

En un directorio vacío, el primer arranque crea la seguridad del clúster y deja estos ficheros dentro de ./data. El log dice dónde está el fichero de credenciales. Nunca escribe su contenido, así que la contraseña de root solo se lee en ese fichero:

Comprobar que funciona

curl -s -o /dev/null -w "%{http_code}\n" --cacert ./data/pki/ca.pem https://127.0.0.1:27200/healthz

Debe salir 200. /healthz contesta así cuando el nodo sirve, y si sale otro código o la orden no llega a conectar, el log del nodo dice qué le falta. Para probar sin PKI ni usuarios puedes arrancar con --insecure. El nodo lo avisa en el log y solo escucha en 127.0.0.1, salvo que añadas --insecure-allow-remote. Ese modo es solo para tu máquina; en cualquier otra, arranca el nodo con TLS y con usuarios.

Limpiar

Para el nodo con Ctrl+C. Si no vas a usarlo más, borra el directorio ./data.

Siguientes pasos

Para conectarte con mongosh o con el driver de tu lenguaje, sigue Conectar tu aplicación.