CouchDB

Base de datos NoSQL orientada a documentos JSON, con replicación nativa y API HTTP integrada.

Versión:

3.5.1

Volver a Marketplace

Requisitos de VM

Recurso Mínimo
CPU 2 vCPU
RAM 4 GB
Disco 40 GB
Sistema Operativo Ubuntu 22.04 / 24.04

Puerto de acceso

Puerto Protocolo Uso
30594 HTTP API REST y UI web de CouchDB (Fauxton)

Cómo acceder

API REST

CouchDB expone una API HTTP directamente. Puedes interactuar con curl o cualquier cliente HTTP:

# Verificar que CouchDB responde
curl http://<IP_DE_LA_VM>:30594/

# Con autenticación
curl http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/

Respuesta esperada:

{
  "couchdb": "Welcome",
  "version": "3.x.x",
  "features": ["access-ready", "reshard", "scheduler"],
  "vendor": { "name": "The Apache Software Foundation" }
}

UI Web — Fauxton

CouchDB incluye una interfaz web para administrar bases de datos visualmente:

http://<IP_DE_LA_VM>:30594/_utils/

Ingresa con tu usuario y contraseña para gestionar databases, documentos e índices desde el navegador.

Validar que CouchDB Está Activo

# Ver el pod de CouchDB
kubectl get pods -A | grep couchdb

# Ver log de instalación
tail -f /var/log/cuemby/bootstrap.log

# Verificar que el puerto está escuchando
ss -tlnp | grep 30594

Parámetros de configuración

Parámetro Default Descripción
COUCHDB_PASSWORD ⚠️ auto-generado Contraseña del usuario administrador. Si se deja vacío, Cuemby genera una aleatoria.
COUCHDB_USER admin Nombre del usuario administrador.
COUCHDB_DATA_SIZE 20Gi Tamaño del volumen persistente para las bases de datos.

ℹ️ Si no configuraste contraseña al desplegar, búscala en los outputs del deployment en el portal de Cuemby.

Primeros pasos (inicio rápido)

# Crear una base de datos
curl -X PUT http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/mi_database

# Insertar un documento
curl -X POST http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/mi_database \
  -H "Content-Type: application/json" \
  -d '{"nombre": "ejemplo", "activo": true}'

# Listar bases de datos
curl http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/_all_dbs

Solución rápida de problemas

Problema Causa probable Solución
Connection refused CouchDB aún iniciando Espera ~3–5 min y revisa tail -f /var/log/cuemby/bootstrap.log.
401 Unauthorized Credenciales incorrectas Revisa los outputs del deployment en el portal de Cuemby.
Fauxton no carga Puerto 30594 no alcanzable Verifica que el pod esté en Running con kubectl get pods -A.
Pod en CrashLoopBackOff Disco o RAM insuficiente Verifica con kubectl describe pod -n .

Cuemby Cloud

IaaS

Acerca de Cuemby Cloud

Cuemby Cloud es una infraestructura de nube de nivel empresarial gestionada desde una única consola, diseñada para ofrecer una seguridad más sólida, operaciones predecibles y una fácil escalabilidad en todas las regiones.

Regiones de centros de datos disponibles en Colombia, Ecuador y Chile

Respaldado por ubicaciones de centros de datos de nivel III y nivel IV

Tarifas de entrada y salida de red cero

Soporte de expertos locales 24/7

¿listo para modernizar tu empresa?

Los desafíos del futuro exigen soluciones preparadas para el futuro. ¡Empecemos!

© Derechos de autor | Cuemby® 2025