La pestaña de Complementos le permite conectar una base de datos PostgreSQL gestionada o una instancia Redis gestionada a un sitio sin necesidad de crear o mantener un servidor para ello. KapsuleHost la aprovisiona, le entrega una cadena de conexión y la elimina de forma limpia cuando usted la retira.
Dónde se encuentran los complementos
Abra Sitios web, haga clic en el sitio, abra el grupo Aplicaciones en el menú izquierdo del sitio y elija Complementos. La página se titula Complementos gestionados.
Hay dos opciones en el catálogo:
| Complemento | Uso habitual |
|---|---|
| PostgreSQL | El almacén de datos principal para una aplicación que no está en MySQL |
| Redis | Almacenamiento en caché, almacenamiento de sesiones y colas de tareas en segundo plano |
Estos son independientes de la base de datos MySQL que viene incluida con un sitio de alojamiento estándar. Esa se encuentra en la pestaña Base de datos y no necesita aprovisionamiento: consulte Conexión a su base de datos mediante un túnel SSH.
Solicitar un complemento
- Busque el complemento en la sección Añadir una base de datos gestionada.
- Haga clic en Añadir al sitio.
La solicitud se registra de inmediato y el complemento aparece en Sus complementos con una insignia PENDING y la nota Waiting for provisioner. La página se actualiza automáticamente cada quince segundos, por lo que puede dejarla abierta.
Un proceso en segundo plano recoge las solicitudes pendientes cada pocos minutos, crea una base de datos y un usuario dedicados para su sitio, y escribe de vuelta una cadena de conexión cifrada. El estado entonces pasa a ACTIVE.
Solicitar o eliminar un complemento requiere el permiso sites:write. Los miembros del equipo con acceso de solo lectura pueden ver qué complementos existen y su estado, pero los botones permanecen ocultos.
Uno de cada tipo, por sitio
Un sitio puede tener un complemento PostgreSQL y un complemento Redis. Solicitar un segundo del mismo tipo se rechaza con un mensaje que indica que ya está aprovisionado, y el catálogo oculta una opción una vez instalada. Cuando ambos están instalados, la sección del catálogo muestra All available addons are installed.
Interpretar el estado
| Estado | Significado |
|---|---|
| PENDING | Solicitado, en espera del aprovisionador |
| PROVISIONING | Creándose en este momento |
| ACTIVE | Listo para usar |
| FAILED | El aprovisionamiento no se completó; el motivo se muestra en la fila |
| DELETED | Eliminado, ya no aparece en la lista |
Una fila FAILED muestra el texto del error real debajo en lugar de un mensaje genérico. Si el motivo no es algo que pueda resolver, cítelo textualmente en un ticket de soporte: consulte Abrir un ticket de soporte.
Obtener la cadena de conexión
Una vez que un complemento está ACTIVE, su fila muestra una cadena de conexión enmascarada con la contraseña reemplazada por puntos, de modo que pueda confirmar el host y el nombre de la base de datos de un vistazo sin exponer la credencial.
Haga clic en Copiar conexión para colocar la cadena de conexión completa en su portapapeles. Se descifra en el servidor para esa única solicitud y nunca se muestra en la página, de modo que las capturas de pantalla y las pantallas compartidas no la filtran. Cada revelación queda registrada en el historial de auditoría del sitio y aparece en el registro de actividad del sitio.
La cadena tiene el formato de URL habitual para cada motor, con el host, el puerto, el usuario, la contraseña y el nombre de la base de datos creados para este sitio.
Usarla en su aplicación
Pegue la cadena de conexión donde su aplicación lea su configuración. En un sitio Node.js, el lugar adecuado para ella es la pestaña Secrets, bajo una clave como DATABASE_URL o REDIS_URL, en el entorno production.
No incorpore la cadena de conexión de forma fija en un archivo que suba al repositorio. Contiene una contraseña activa. Si llega a un repositorio remoto de git, debe tratarse como filtrada, y la única solución real es eliminar el complemento y solicitar uno nuevo, ya que la credencial no se puede rotar directamente desde el panel.
Eliminar un complemento
Haga clic en Delete en la fila. KPanel le pide confirmación y es directo sobre lo que ocurre: esto elimina la base de datos gestionada, y los datos no se pueden recuperar.
La fila se marca como eliminada de inmediato y el aprovisionador elimina la base de datos y el usuario subyacentes en su siguiente ciclo. Las conexiones existentes se terminan como parte de ese proceso.
No se realiza ninguna copia de seguridad de un complemento gestionado al eliminarlo, y no hay forma de deshacer la acción. Si hay algo en él que quiera conservar, expórtelo primero con pg_dump o redis-cli --rdb mientras el complemento sigue activo y la cadena de conexión aún funciona.
Elegir entre las opciones
Use PostgreSQL cuando su aplicación necesite una base de datos relacional y esté escrita para Postgres: restricciones estrictas, transacciones, columnas JSON y búsqueda de texto completo que de otro modo tendría que añadir por su cuenta.
Use Redis para cosas que pueden desaparecer sin problema: fragmentos en caché, contadores de límite de velocidad, almacenamiento de sesiones y colas de tareas. Trátelo como rápido y volátil, no como un sistema de registro.
Use la base de datos MySQL integrada para WordPress y para cualquier cosa ya escrita para MySQL. Añadir un complemento Postgres a un sitio WordPress no sirve de nada, porque WordPress no puede comunicarse con él.
Solución de problemas
El complemento lleva mucho tiempo en PENDING. El aprovisionador se ejecuta según un calendario, no de forma instantánea. Deje la página abierta, ya que se actualiza sola, y vuelva a comprobarlo más tarde. Si no ha cambiado tras varios ciclos, abra un ticket de soporte con el dominio del sitio y el tipo de complemento.
El aprovisionamiento FAILED. Lea el error en la fila. Elimine el complemento fallido y vuelva a solicitarlo, lo cual es seguro: una fila fallida nunca tuvo una base de datos activa detrás.
Copiar conexión no hace nada. Algunos navegadores bloquean la escritura en el portapapeles cuando la pestaña no está enfocada. Haga clic primero en la página y luego vuelva a hacer clic en el botón.
La aplicación no puede conectarse. Compruebe tres cosas en orden: que el estado del complemento sea ACTIVE, que haya copiado la cadena en lugar de volver a escribirla, y que su aplicación esté leyendo el valor que realmente estableció y no uno antiguo de un despliegue anterior. Por lo general es necesario reiniciar antes de que se aplique la nueva configuración.
Las conexiones se rechazan tras un nuevo despliegue. Confirme que la cadena de conexión en su configuración sigue coincidiendo con la de esta página. Eliminar y volver a solicitar un complemento crea un nuevo usuario y una nueva contraseña, por lo que una cadena antigua no funcionará.
A dónde ir a continuación
- Almacenar secretos de aplicación para un sitio, el lugar adecuado para guardar la cadena de conexión.
- Conexión a su base de datos mediante un túnel SSH para la base de datos MySQL integrada.
- Configuración del sitio para el resto de la configuración a nivel de sitio.