OpenSearch

Motor de búsqueda y análisis distribuido, fork open-source de Elasticsearch. Ideal para búsqueda de texto completo, análisis de logs, observabilidad y dashboards con OpenSearch Dashboards.

Versión:

3.0.0

Volver a Marketplace

Requisitos de VM

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

Puerto de acceso

Puerto Protocolo Uso
30920 HTTPS REST API de OpenSearch

Cómo acceder

Verificar que OpenSearch responde

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/

Respuesta esperada

{
  "name": "opensearch-node",
  "cluster_name": "...",
  "version": { "number": "2.x.x" }
}

Estado del cluster

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/_cluster/health?pretty

ℹ️ OpenSearch usa HTTPS con certificados auto-firmados. Usa -k en curl o configura tu cliente para aceptar certificados self-signed. Si no configuraste contraseña al desplegar, búscala en los outputs del deployment en el portal de Cuemby.

Validar que OpenSearch Está Activo

# Ver el pod de OpenSearch
kubectl get pods -A | grep opensearch

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

Respuesta esperada

NAME                           READY   STATUS    RESTARTS
opensearch-xxxxxxxxx-xxxxx     1/1     Running   0        ← Running ✓

⚠️ OpenSearch puede tardar 5–8 minutos en estar disponible. Es una aplicación pesada que inicializa índices del sistema en el primer arranque.

Parámetros de configuración

Parámetro Default Descripción
OPENSEARCH_PASSWORD ⚠️ auto-generado Contraseña del usuario admin.
OPENSEARCH_CLUSTER_NAME opensearch-cluster Nombre lógico del cluster.
OPENSEARCH_DATA_SIZE 30Gi Tamaño del volumen persistente para índices y datos.
OPENSEARCH_JAVA_OPTS -Xmx2g -Xms2g Opciones de heap de la JVM. Recomendado: 50% de la RAM total como máximo.
OPENSEARCH_SSL_ENABLED true Habilita HTTPS en la API con certificado automático vía sslip.io.
OPENSEARCH_HOSTNAME auto (sslip.io) Hostname personalizado. Si se deja vacío, se usa la URL generada por Cuemby.

Primeros pasos (inicio rápido)

Crear un índice

curl -k -u admin:<PASSWORD> -X PUT https://<IP_DE_LA_VM>:30920/mi-indice \
  -H "Content-Type: application/json" \
  -d '{"settings": {"number_of_shards": 1, "number_of_replicas": 0}}'

Crear un índice

curl -k -u admin:<PASSWORD> -X POST https://<IP_DE_LA_VM>:30920/mi-indice/_doc \
  -H "Content-Type: application/json" \
  -d '{"titulo": "OpenSearch en Cuemby", "contenido": "Motor de búsqueda distribuido"}'

Buscar documentos

curl -k -u admin:<PASSWORD> -X GET https://<IP_DE_LA_VM>:30920/mi-indice/_search?pretty \
  -H "Content-Type: application/json" \
  -d '{"query": {"match": {"contenido": "búsqueda"}}}'

Listar índices

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/_cat/indices?v

💡 Tip: OpenSearch es compatible con el API de Elasticsearch. Clientes como opensearch-py (Python), @opensearch-project/opensearch (Node.js) y el SDK oficial de Java funcionan directamente. También puedes usar clientes de Elasticsearch apuntando a la URL de tu instancia.

Solución rápida de problemas

Problema Causa probable Solución
Connection refused OpenSearch aún inicializando Espera 5–8 min y revisa tail -f /var/log/cuemby/bootstrap.log.
401 Unauthorized Credenciales incorrectas Revisa los outputs del deployment en el portal de Cuemby.
Cluster en red Índices con shards no asignados En nodo único, crea índices con "number_of_replicas": 0.
OutOfMemoryError Heap JVM insuficiente Aumenta OPENSEARCH_JAVA_OPTS a -Xmx4g -Xms4g y reinicia el pod.
Pod en CrashLoopBackOff RAM o disco insuficiente Verifica que la VM tiene al menos 8 GB de RAM y 50 GB de disco.

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