Inicio rápido con un nodo
Te mostramos cómo instalar TeselaDB, arrancar un nodo y conectarte a él con mongosh desde esta misma página.
Vas a instalar TeselaDB, arrancar un nodo en tu máquina y conectarte a él con mongosh. 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, y una
sesión de mongosh abierta como root. Con el driver de tu lenguaje te conectas igual que 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 mongosh y una de estas dos cosas: Linux (x86_64 o aarch64) o macOS Apple Silicon con curl, o Docker en
cualquier sistema.
Paso 1. Instala y arranca el nodo
Elige cómo arrancarlo y pega las órdenes en una misma terminal, en orden. No hay nada que editar. El script de instalación mira tu sistema y tu CPU, descarga el binario que les corresponde y comprueba su SHA-256 antes de copiarlo.
Para Linux x86_64 y aarch64 y macOS Apple Silicon. El script instala teseladb en /usr/local/bin y pide sudo si hace falta.
- 01.
Instala TeselaDB con el script, que elige el binario de tu sistema y comprueba su SHA-256
$curl -fsSL https://downloads.teseladb.com/install.sh | sh - 02.
Arranca un nodo en segundo plano; el primer arranque crea la autoridad de certificación y el usuario root
$teseladb start --dbpath ./data > teseladb.log 2>&1 & - 03.
Espera a que el nodo esté listo
$until grep -q '^ready' teseladb.log; do sleep 1; done - 04.
Lee la contraseña del usuario root
$ROOT_PASSWORD=$(sed -n 's/^password=//p' ./data/root-credentials.txt) - 05.
Conéctate con mongosh por TLS
$mongosh "mongodb://root:$ROOT_PASSWORD@127.0.0.1:27017/?tls=true&tlsCAFile=./data/pki/ca.pem&authSource=admin"
El último paso abre mongosh conectado como root. Al arrancar, el nodo abre cuatro puertos en 127.0.0.1, cada uno
para un tipo de tráfico distinto, y el de clientes solo acepta TLS:
| Puerto | Para qué |
|---|---|
| 27017 | Clientes y drivers, siempre con TLS |
| 27100 | Tráfico entre nodos, con TLS mutuo |
| 27200 | Administración con teseladb admin, /metrics y /healthz |
| 27080 | API REST y servidor MCP |
Paso 2. Mira lo que creó el primer arranque
En un directorio vacío, el primer arranque crea la seguridad del clúster y deja estos ficheros en el directorio de
datos, ./data con el script o /data dentro del contenedor. El log dice dónde está el fichero de credenciales, pero
nunca escribe su contenido, así que la contraseña de root solo se lee en ese fichero:
| Fichero | Contenido | Permisos |
|---|---|---|
pki/ca.pem, pki/ca.key | Autoridad de certificación del clúster | 0644 / 0600 |
pki/node.pem, pki/node.key | Certificado y clave de este nodo | 0644 / 0600 |
master.key | Clave maestra, que cifra las demás claves | 0600 |
root-credentials.txt | Usuario root y su contraseña inicial | 0600 |
Comprobar que funciona
db.runCommand({ ping: 1 });Escríbelo en la sesión de mongosh que abrió el último paso y debe responder { ok: 1 }. Si mongosh no llega a conectar, lee el log del nodo en teseladb.log si usaste el script, o con docker logs teseladb si usaste Docker, porque ahí dice qué le falta.
Limpiar
pkill -f "teseladb start --dbpath ./data"
rm -rf ./data teseladb.logSal antes de mongosh con exit. Si arrancaste el nodo con el script, estas dos órdenes lo paran y borran sus datos y
su log. Si lo arrancaste con Docker, borra en su lugar el contenedor, su volumen y la CA que copiaste:
docker rm -f teseladb
docker volume rm teseladb-data
rm ./ca.pemSiguientes pasos
Para conectarte desde tu código, sigue Conectar tu aplicación. Para varios nodos en tu máquina, sigue Inicio rápido con un clúster local.