PostgreSQL

Base de datos relacional open-source avanzada. Reconocida por su robustez, cumplimiento de estándares SQL y soporte nativo para tipos de datos complejos como JSON, arrays y datos geoespaciales.

Versión:

17.8

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
30432 TCP Protocolo PostgreSQL

Cómo acceder

Con psql

# Conectar como usuario de aplicación
psql -h <IP_DE_LA_VM> -p 30432 -U <USUARIO> -d <DATABASE>

# Conectar como postgres (superusuario)
psql -h <IP_DE_LA_VM> -p 30432 -U postgres

Connection string para aplicaciones

postgresql://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30432/<DATABASE>

Ejemplos por lenguaje

# Python (psycopg2)
import psycopg2
conn = psycopg2.connect(
    host="<IP_DE_LA_VM>", port=30432,
    user="<USUARIO>", password="<PASSWORD>", dbname="<DATABASE>"
)
// Node.js (pg)
const client = new Client({
    host: "<IP_DE_LA_VM>", port: 30432,
    user: "<USUARIO>", password: "<PASSWORD>", database: "<DATABASE>"
});
# Python (SQLAlchemy)
engine = create_engine("postgresql://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30432/<DATABASE>")

Validar que PostgreSQL Está Activo

# Ver el pod de PostgreSQL
kubectl get pods -A | grep postgresql

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

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

Respuesta esperada

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

Parámetros de configuración

Credenciales y bases de datos

Parámetro Default Descripción
POSTGRES_PASSWORD ⚠️ auto-generado Contraseña del usuario de aplicación. Si se deja vacío, Cuemby genera una aleatoria.
POSTGRES_USER cuemby Application username.
POSTGRES_DB app Nombre de la base de datos creada automáticamente al desplegar.
POSTGRESQL_DATA_SIZE 20Gi Tamaño del volumen persistente para las bases de datos.

Tuning de rendimiento

Parameter Default Description
POSTGRESQL_MAX_CONNECTIONS 100 Número máximo de conexiones simultáneas. Aumenta con precaución: cada conexión consume memoria.
POSTGRESQL_SHARED_BUFFERS 128MB Memoria reservada para caché de datos. Recomendado: 25% de la RAM total.
POSTGRESQL_WORK_MEM 4MB Memoria por operación de ordenamiento o hash. Multiplica por MAX_CONNECTIONS para estimar el uso total.

💡 Para una VM con 4 GB de RAM, una configuración balanceada sería: SHARED_BUFFERS=1GB, WORK_MEM=16MB, MAX_CONNECTIONS=100.

Primeros pasos (inicio rápido)

-- Listar bases de datos
\l

-- Conectar a la base de datos de la aplicación
\c app

-- Crear una tabla
CREATE TABLE usuarios (
    id SERIAL PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    email VARCHAR(150) UNIQUE NOT NULL,
    creado_en TIMESTAMPTZ DEFAULT NOW()
);

-- Insertar un registro
INSERT INTO usuarios (nombre, email) VALUES ('Martin', 'martin@cuemby.com');

-- Consultar
SELECT * FROM usuarios;

-- Ver tablas existentes
\dt

Solución rápida de problemas

Problema Causa probable Solución
password authentication failed Password incorrecto Revisa los outputs del deployment en el portal de Cuemby.
could not connect to server PostgreSQL aún iniciando Espera ~2–3 min y revisa tail -f /var/log/cuemby/bootstrap.log.
too many connections MAX_CONNECTIONS alcanzado Use a connection pooler like PgBouncer or increase POSTGRESQL_MAX_CONNECTIONS.
out of shared memory SHARED_BUFFERS muy alto Reduce SHARED_BUFFERS a no más del 25% de la RAM disponible.
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