Visión general de bases de datos

Opfield trabaja con bases de datos de dos formas: una instancia gestionada que Opfield aprovisiona y ejecuta en un nodo Storage, y una conexión externa a una base de datos que se ejecuta en otro lugar. Ambas aparecen en la misma lista con las mismas comprobaciones de estado, métricas, Explorer, Console y copias de seguridad.

Elige el modelo antes de incorporar una aplicación. Usa una conexión externa para una base de datos cuyo motor ya ejecuta otra plataforma u otro equipo. Usa una instancia gestionada cuando Opfield deba ejecutar el motor: la aprovisiona en un disco local acotado, muestra su estado y sus acciones de ciclo de vida y crea vinculaciones privadas para las aplicaciones. Convertir un modelo en el otro es una migración, no un ajuste.

Bases de datos gestionadas y externas de un vistazo

Ambos modelos admiten PostgreSQL, almacenes clave-valor y ClickHouse y aparecen en la misma lista Databases. Un almacén clave-valor funciona con clientes de Redis; los nuevos almacenes gestionados ejecutan Valkey (consulta Almacenes clave-valor). La tabla muestra lo que Opfield aprovisiona y ejecuta, y aquello con lo que solo se conecta.

Capacidad	Base de datos gestionada	Conexión externa
Quién aprovisiona y ejecuta el motor	Opfield, como un contenedor con almacenamiento de tamaño fijo en un nodo Storage	El responsable actual de la base de datos, fuera de Opfield
Versiones del motor	Un catálogo seleccionado de imágenes de PostgreSQL, Valkey y ClickHouse fijadas por digest; los almacenes creados antes de la 2.12 conservan Redis hasta Move to Valkey	Lo que ejecute el responsable
Prueba de conexión, estado y métricas	Sí, incluidos CPU, memoria, swap y procesos del contenedor	Sí, estado y métricas del motor
Explorer de esquemas y datos	PostgreSQL y ClickHouse	PostgreSQL y ClickHouse
Consola SQL o consola de comandos clave-valor	Sí	Sí
Extensiones de PostgreSQL	Activar o desactivar las extensiones incluidas en la imagen	No
Logs del motor	Sí	No
Pausar, reanudar, reiniciar y reintentar un aprovisionamiento fallido	Sí	No
Redimensionar CPU, memoria, swap y almacenamiento	Sí; el almacenamiento solo puede crecer	No
Ajustes del motor	Máximo de conexiones de PostgreSQL, ajustes de persistencia y memoria clave-valor, configuración XML de ClickHouse	No
Publicación TCP directa con TLS nativo	Opcional, se puede cambiar más adelante	No aplicable
Cómo verifica Opfield TLS	Opfield llega a la instancia a través del túnel de Relay con autenticación mutua; el TLS de PostgreSQL también se verifica con la CA de bases de datos de Opfield	La cadena de certificados y el nombre de host se verifican por defecto; CA personalizada opcional; desactivación explícita. Consulta Verificación del certificado TLS
Credenciales	Opfield mantiene interna la credencial de propietario; la revelación y la rotación se aplican a un usuario de acceso directo aparte de una instancia publicada	Datos de conexión guardados, cifrados en reposo y que se pueden revelar con `databases:credentials:reveal`; una URI de PostgreSQL revelada usa `sslmode=verify-full` cuando la verificación está activada y `sslmode=require` cuando está desactivada
Vinculaciones privadas con Containers, Deployments y servicios de Compose	Sí, con una identidad del motor distinta por vinculación	No; entrega los valores de conexión como secretos de la carga de trabajo
Actualización de la versión del motor	A través de la API y de MCP, a una versión más reciente del catálogo del mismo motor: PostgreSQL dentro de su versión mayor, Valkey y ClickHouse a la siguiente versión del catálogo. Otra versión mayor de PostgreSQL implica restaurar una copia de seguridad en una base de datos nueva	Responsabilidad del responsable de la base de datos
Copia de seguridad y restauración	Copias de seguridad nativas programadas en una conexión de almacenamiento; restauración en una base de datos gestionada nueva, o en una base de datos existente vacía a través de la API	Igual que las bases de datos gestionadas
Varios servidores con conmutación por error	En Business y Enterprise, de 2 a 5 nodos Storage con un primario y copias; consulta Bases de datos y almacenamiento en varios servidores	Responsabilidad del responsable de la base de datos
Eliminar	Elimina el motor, su almacenamiento y sus datos; bloqueado mientras existan vinculaciones	Elimina solo el registro guardado en Opfield
Plan	Personal o superior	Personal o superior

El acceso a Explorer y a la consola requiere los ámbitos separados databases:query:read, databases:query:write o databases:query:admin, además de databases:view. Opfield clasifica cada sentencia de la consola como operación de lectura, de escritura o administrativa y exige el ámbito correspondiente.

Verificación del certificado TLS en las conexiones externas

Cuando una conexión externa usa TLS, Opfield verifica la cadena de certificados del servidor y que el certificado se emitió para el host configurado. Es la opción predeterminada para las conexiones nuevas. En los ajustes de la conexión:

Verify server certificate activa o desactiva la verificación para esta conexión. Desactivarla mantiene el tráfico cifrado, pero permite que cualquiera en el camino de red suplante la base de datos y capture sus credenciales; úsalo solo como una excepción deliberada.
CA certificate acepta un paquete PEM de una CA privada en la que se confía en lugar del paquete de CA públicas. Solo se aceptan certificados; una clave privada pegada se rechaza.

Opfield prueba la conexión con los ajustes nuevos antes de guardar una conexión nueva o modificada. Si no se puede verificar el certificado, el cambio se rechaza con DATABASE_TLS_VERIFICATION_FAILED (HTTP 422) y la conexión guardada no cambia. Desactivar la verificación, o cambiar una conexión verificada a otra CA, requiere volver a introducir la contraseña de la base de datos, porque de lo contrario la contraseña guardada podría llegar a un servidor no verificado.

Una conexión que usa TLS sin verificación muestra TLS certificate is not verified en su página de detalle. Test and enable verification activa la verificación tras una prueba correcta, y Add CA certificate abre los ajustes para añadir una CA privada. Las conexiones de PostgreSQL y Redis que usaban TLS antes de la 2.11 empiezan en este estado sin verificar para que la actualización las mantenga conectadas; las conexiones HTTPS de ClickHouse ya estaban verificadas. Las copias de seguridad de bases de datos usan el mismo ajuste.

Modelo de recursos

Las instancias gestionadas de PostgreSQL, clave-valor y ClickHouse son privadas por defecto. Opfield coordina la configuración del motor, el almacenamiento, las credenciales, el estado, los logs, las operaciones y las vinculaciones con las aplicaciones. El nodo Storage seleccionado ejecuta el motor, mientras que Opfield conserva el estado deseado del recurso y sus relaciones con las cargas de trabajo.

Una conexión externa no transfiere la propiedad de la base de datos a Opfield. Opfield guarda su configuración de conexión y sus credenciales cifradas en reposo detrás de permisos explícitos y puede hacer copias de seguridad de la base de datos; la disponibilidad de la base de datos externa, su política de acceso y el ciclo de vida de su motor siguen siendo responsabilidad de su operador.

Trata las credenciales guardadas como secretos de infraestructura privilegiados. Concede los permisos de visualización, edición, revelación y consulta por separado cuando el modelo de roles lo permita, y evita compartir una cuenta de propietario o de superusuario cuando haya disponible una cuenta de servicio más restringida. Eliminar una conexión externa elimina la relación guardada en Opfield; no elimina la base de datos remota, su almacenamiento ni sus usuarios.

Acceso privado por defecto

Usa una vinculación de aplicación cuando una carga de trabajo gestionada necesite acceder a una base de datos gestionada. Una vinculación concede una identidad del motor separada con privilegios a nivel de aplicación (nunca la credencial de propietario ni de superusuario) y un endpoint privado que Opfield conserva a lo largo de las recreaciones normales de la carga de trabajo. No hay ningún servicio adicional por vinculación que deba operar el equipo de la aplicación. Las vinculaciones no están disponibles para las conexiones externas.

Este transporte es distinto del conector de Secure Link entre nginx y las cargas de trabajo. El Secure Link sigue siendo un componente separado para su propia función de ingress y relay. No trates un fallo de una vinculación como prueba de que haya que eliminar, recrear o configurar el componente Secure Link como transporte de bases de datos.

La publicación TCP directa es una opción explícita para clientes externos. No abre automáticamente los cortafuegos de los hosts y solo debe activarse para un camino de cliente identificado con las credenciales y la confianza en certificados adecuadas. Publicar una instancia no cambia el modelo de vinculaciones privadas que usan las cargas de trabajo.

Ciclo de vida y límites operativos

La vista de detalle de la base de datos reúne el estado, las métricas, los ajustes del motor, las credenciales, los certificados, el redimensionamiento, la pausa y la reanudación, el reinicio, los logs y el acceso a Explorer o Console cuando corresponda. Las acciones disponibles dependen del motor, de la conectividad del nodo, del estado de la instancia y de los permisos concedidos.

Pausar conserva los datos mientras desactiva intencionadamente el cómputo del motor. Una instancia pausada no ofrece el comportamiento normal de estado, métricas, Explorer ni Console hasta que se reanuda. Reiniciar es útil como acción operativa controlada; no repara fallos sin resolver de almacenamiento, autenticación o nodos.

Línea base de preparación

Antes de entregar una base de datos a un equipo de aplicación, verifica todo el límite de propiedad:

El nodo Storage seleccionado está en línea e informa de capacidades de almacenamiento compatibles.
La instancia gestionada está Ready, o el endpoint externo es accesible con la verificación del certificado TLS activada.
La propiedad, la retención y las pruebas de restauración de las copias de seguridad están documentadas fuera de la propia instancia.
La aplicación usa una identidad específica de la vinculación u otra cuenta con el mínimo privilegio en lugar de una credencial de propietario.
La monitorización recopila datos sin que un operador tenga que mantener abierta la página de detalle.
Un reinicio o una reconexión controlados demuestran que el cliente se recupera como se espera.

Una insignia verde del motor por sí sola no es una prueba de principio a fin. Confirma al menos una consulta real de la aplicación, el límite de permisos esperado y la ausencia de credenciales en el control de código fuente, los logs, la salida de los Tasks y la configuración de ejecución pública.

Disponibilidad y limitaciones

Una instancia gestionada se ejecuta en un nodo Storage salvo que la ejecutes en varios servidores, algo que ofrecen Business y Enterprise: entonces una copia en otro host toma el relevo cuando se pierde el primario, y la página indica lo que puede perder una conmutación por error. En un solo servidor, Opfield conserva el estado deseado y coordina la recuperación, pero perder el nodo significa perder la base de datos hasta que vuelva o se restaure desde una copia de seguridad. En ambos casos, planifica copias de seguridad fuera del nodo y el tiempo de recuperación según la criticidad de la base de datos para el negocio.

Las copias de seguridad de la configuración de Opfield no contienen datos de las bases de datos. Eliminar una base de datos gestionada elimina su almacenamiento gestionado; ten una copia de seguridad verificada o un destino de migración antes de eliminarla.

Detalles para operadores: transporte privado

La carga de trabajo llega a la base de datos a través del conector de Secure Links compartido de su nodo Docker, en una pequeña red privada propia para la vinculación; no hay un contenedor conector por vinculación ni un listener en el host. Opfield concilia el enlace y la identidad de la vinculación como estado deseado duradero. Consulta Vinculaciones de bases de datos para el transporte y la actualización a la 2.11.1.

Siguientes pasos

Aprovisiona y retira una base de datos gestionada
Almacenes clave-valor y Move to Valkey
Ejecuta una base de datos o un almacenamiento en varios servidores
Crea vinculaciones privadas para aplicaciones
Supervisa y recupera las operaciones con bases de datos
Conecta una aplicación a una base de datos privada de principio a fin
Vincula una base de datos a un Container, a un Deployment o a un servicio de Compose
Planifica la protección de los datos con Actualizaciones, copias de seguridad y restauración