Entender los Disparadores<\/h2>\n
Antes de crear operaciones de mantenimiento para tu base de datos, es importante comprender las distintas formas en que se pueden disparar. Cada desencadenante sirve para fines distintos a la hora de facilitar las tareas de mantenimiento. Los tres disparadores principales que se utilizan habitualmente son:<\/p>\n
- \n
- Manual, basado en API<\/strong>: Este disparador te permite ejecutar operaciones puntuales mediante una llamada a la API. Es \u00fatil en situaciones como la restauraci\u00f3n de una copia de seguridad de la base de datos o la reconstrucci\u00f3n de \u00edndices cuando el rendimiento cae repentinamente.<\/li>\n
- Programado (como CRON)<\/strong>: Este disparador te permite automatizar actividades de mantenimiento programadas durante periodos de bajo tr\u00e1fico de usuarios. Es ideal para ejecutar operaciones que consumen muchos recursos, como el archivado y la limpieza. Puedes utilizar paquetes como node-schedule<\/a> para configurar programaciones en Node.js que disparen las operaciones autom\u00e1ticamente cuando sea necesario.<\/li>\n
- Notificaciones de la base de datos<\/strong>: Este disparador te permite realizar operaciones de mantenimiento en respuesta a cambios en la base de datos. Por ejemplo, cuando un usuario publica un comentario en una plataforma, los datos guardados pueden disparar instant\u00e1neamente comprobaciones de caracteres irregulares, lenguaje ofensivo o emojis. Implementar esta funcionalidad en Node.js es posible utilizando paquetes como pg-listen<\/a>.<\/li>\n<\/ul>\n
Requisitos Previos<\/h2>\n
Para seguir esta gu\u00eda, debes tener las siguientes herramientas en tu ordenador local:<\/p>\n
- \n
- Git<\/a>: Para gestionar el control de versiones del c\u00f3digo fuente de tu aplicaci\u00f3n<\/li>\n
- Node.js<\/a>: Para construir tu aplicaci\u00f3n backend<\/li>\n
- psql<\/a>: Para interactuar con tu base de datos PostgreSQL remota utilizando tu terminal<\/li>\n
- PGAdmin<\/a> (Opcional): Para interactuar con tu base de datos PostgreSQL remota utilizando una Interfaz Gr\u00e1fica de Usuario (GUI).<\/li>\n<\/ul>\n
Crear y Alojar una Aplicaci\u00f3n Node.js<\/h3>\n
Vamos a crear un proyecto Node.js, hacer commit en GitHub y configurar un canal de despliegue autom\u00e1tico en Kinsta. Tambi\u00e9n necesitas aprovisionar una base de datos PostgreSQL en Kinsta<\/a> para probar tus rutinas de mantenimiento en ella.<\/p>\n
Empieza creando un nuevo directorio en tu sistema local utilizando el siguiente comando:<\/p>\n
mkdir node-db-maintenance<\/code><\/pre>\nA continuaci\u00f3n, cambia a la carpeta reci\u00e9n creada y ejecuta el siguiente comando para crear un nuevo proyecto:<\/p>\n
cd node-db-maintenance\nyarn init -y # or npm init -y<\/code><\/pre>\nEsto inicializa un proyecto Node.js para ti con la configuraci\u00f3n por defecto. Ahora puedes instalar las dependencias necesarias ejecutando el siguiente comando:<\/p>\n
yarn add express pg nodemon dotenv<\/code><\/pre>\nAqu\u00ed tienes una breve descripci\u00f3n de cada paquete:<\/p>\n
- \n
express<\/code>: te permite configurar una API REST basada en Express.<\/li>\npg<\/code>: te permite interactuar con una base de datos PostgreSQL a trav\u00e9s de tu aplicaci\u00f3n Node.js.<\/li>\nnodemon<\/code> permite que tu versi\u00f3n de desarrollo (dev build) se actualice a medida que desarrollas tu aplicaci\u00f3n, liber\u00e1ndote de la constante necesidad de parar e iniciar tu aplicaci\u00f3n cada vez que haces un cambio.<\/li>\ndotenv<\/code>: te permite cargar variables de entorno de un archivo .env<\/strong> en tu objetoprocess.env<\/code>.<\/li>\n<\/ul>\nA continuaci\u00f3n, a\u00f1ade los siguientes scripts en tu archivo package.json<\/strong> para que puedas iniciar f\u00e1cilmente tu servidor dev y ejecutar tambi\u00e9n tu servidor en producci\u00f3n:<\/p>\n
{\n \/\/ ... \n \"scripts\": {\n \"start-dev\": \"nodemon index.js\",\n \"start\": \"NODE_ENV=production node index.js\"\n },\n \/\/ \u2026\n}<\/code><\/pre>\nAhora puedes crear un archivo index.js<\/strong> que contenga el c\u00f3digo fuente de tu aplicaci\u00f3n. Pega el siguiente c\u00f3digo en el archivo:<\/p>\n
const express = require(\"express\")\nconst dotenv = require('dotenv');\n\nif (process.env.NODE_ENV !== 'production') dotenv.config();\nconst app = express()\nconst port = process.env.PORT || 3000\n\napp.get(\"\/health\", (req, res) => res.json({status: \"UP\"}))\n\napp.listen(port, () => {\n console.log(`Server running at port: ${port}`);\n});<\/code><\/pre>\nEste c\u00f3digo anterior inicializa un servidor Express<\/a> y configura variables de entorno utilizando el paquete
dotenv<\/code> si no est\u00e1 en modo de producci\u00f3n. Tambi\u00e9n configura una ruta\/health<\/code> que devuelve un objeto JSON{status: \"UP\"}<\/code>. Por \u00faltimo, inicia la aplicaci\u00f3n utilizando la funci\u00f3napp.listen()<\/code> para escuchar en el puerto especificado, por defecto3000<\/code> si no se proporciona ning\u00fan puerto a trav\u00e9s de la variable de entorno.<\/p>\nAhora que ya tienes lista una aplicaci\u00f3n b\u00e1sica, inicializa un nuevo repositorio git con tu proveedor git preferido (BitBucket<\/a>, GitHub<\/a> o GitLab<\/a>) y env\u00eda tu c\u00f3digo. Kinsta soporta el despliegue de aplicaciones desde todos estos proveedores git. Para este art\u00edculo, vamos a utilizar GitHub.<\/p>\n
Cuando tu repositorio est\u00e9 listo, sigue estos pasos para desplegar tu aplicaci\u00f3n en Kinsta:<\/p>\n
- \n
- Inicia sesi\u00f3n o crea una cuenta para ver tu panel MyKinsta<\/a>.<\/li>\n
- Autoriza a Kinsta con tu proveedor de Git.<\/li>\n
- En la barra lateral izquierda, haz clic en Aplicaciones<\/strong> y luego en A\u00f1adir aplicaci\u00f3n<\/strong>.<\/li>\n
- Selecciona el repositorio y la rama desde la que deseas desplegar.<\/li>\n
- Selecciona una de las ubicaciones de centros de datos disponibles en la lista de 27 opciones. Kinsta detecta autom\u00e1ticamente la configuraci\u00f3n de construcci\u00f3n de tus aplicaciones a trav\u00e9s de Nixpacks<\/a>.<\/li>\n
- Elige los recursos de tu aplicaci\u00f3n, como RAM y espacio en disco.<\/li>\n
- Haz clic en Crear aplicaci\u00f3n<\/strong>.<\/li>\n<\/ol>\n
Una vez completado el despliegue, copia el enlace de la aplicaci\u00f3n desplegada y navega a
\/health<\/code>. Deber\u00edas ver el siguiente JSON en tu navegador:<\/p>\n{status: \"UP\"}<\/code><\/pre>\nEsto indica que la aplicaci\u00f3n se ha configurado correctamente.<\/p>\n
Configurar una Instancia PostgreSQL en Kinsta<\/h3>\n
Kinsta proporciona una interfaz sencilla para aprovisionar instancias de bases de datos. Empieza por crear una nueva cuenta Kinsta<\/a> si a\u00fan no tienes una. A continuaci\u00f3n, sigue los siguientes pasos:<\/p>\n
- \n
- Accede a tu panel MyKinsta.<\/li>\n
- En la barra lateral izquierda, haz clic en Bases de datos<\/strong> y luego en A\u00f1adir base de datos<\/strong>.<\/li>\n
- Selecciona PostgreSQL<\/strong> como tipo de Base de Datos y elige la versi\u00f3n que prefieras. Elige un nombre para tu base de datos y modifica el nombre de usuario y la contrase\u00f1a si lo deseas.<\/li>\n
- Selecciona una ubicaci\u00f3n de centro de datos de la lista de 27 opciones.<\/li>\n
- Elige el tama\u00f1o de tu base de datos.<\/li>\n
- Haz clic en Crear base de datos<\/strong>.<\/li>\n<\/ol>\n
Una vez creada la base de datos, aseg\u00farate de recuperar el host, el puerto, el nombre de usuario y la contrase\u00f1a de la base de datos.<\/p>\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/11\/database-credentials-from-kinsta-1024x435.jpg\")
Credenciales de la base de datos generadas por Kinsta<\/figcaption><\/figure>\n A continuaci\u00f3n, puedes introducir estos valores en tu CLI psql (o GUI PGAdmin) para gestionar la base de datos. Para probar tu c\u00f3digo localmente, crea un archivo .env<\/strong> en el directorio root de tu proyecto y almacena en \u00e9l los siguientes secretos:<\/p>\n
DB_USER_NAME=your database user name\nDB_HOST=your database host\nDB_DATABASE_NAME=your database\u2019s name\nDB_PORT=your database port\nPGPASS=your database password<\/code><\/pre>\nCuando despliegues en Kinsta, deber\u00e1s a\u00f1adir estos valores como variables de entorno<\/a> al despliegue de tu aplicaci\u00f3n.<\/p>\n
Para prepararte para las operaciones con la base de datos, descarga y ejecuta este script SQL<\/a> para crear tablas (usuarios, entradas, comentarios) e insertar datos de ejemplo. Utiliza el siguiente comando, sustituyendo los marcadores de posici\u00f3n por tus datos espec\u00edficos, para a\u00f1adir los datos a tu base de datos PostgreSQL reci\u00e9n creada:<\/p>\n
psql -h <host> -p <port> -U <username> -d <db_name> -a -f <sql file e.g. test-data.sql><\/code><\/pre>\nAseg\u00farate de introducir el nombre de archivo y la ruta exactos en el comando anterior. La ejecuci\u00f3n de este comando te pide que introduzcas la contrase\u00f1a de tu base de datos para autorizarte.<\/p>\n
Una vez que este comando termine de ejecutarse, estar\u00e1s listo para empezar a escribir operaciones para el mantenimiento de tu base de datos. No dudes en enviar tu c\u00f3digo a tu repositorio Git cuando termines con cada operaci\u00f3n para verlo en acci\u00f3n en la plataforma Kinsta.<\/p>\n
Escribir Rutinas de Mantenimiento<\/h2>\n
En esta secci\u00f3n se explican varias operaciones de uso com\u00fan para el mantenimiento de bases de datos PostgreSQL.<\/p>\n
1. Crear Copias de Seguridad<\/h3>\n
Hacer copias de seguridad peri\u00f3dicas de las bases de datos es una operaci\u00f3n com\u00fan y esencial. Consiste en crear una copia de todo el contenido de la base de datos, que se almacena en una ubicaci\u00f3n segura. Estas copias de seguridad son cruciales para restaurar los datos en caso de p\u00e9rdida accidental o de errores que afecten a su integridad.<\/p>\n
Aunque plataformas como Kinsta ofrecen copias de seguridad automatizadas<\/a> como parte de sus servicios, es importante saber c\u00f3mo configurar una rutina de copia de seguridad personalizada si es necesario.<\/p>\n
PostgreSQL ofrece la herramienta pg_dump<\/a> para crear copias de seguridad de la base de datos. Sin embargo, debe ejecutarse directamente desde la l\u00ednea de comandos, y no existe un paquete npm para ella. As\u00ed que tienes que utilizar el paquete @getvim\/execute<\/a> para ejecutar el comando
pg_dump<\/code> en el entorno local de tu aplicaci\u00f3n Node.<\/p>\nInstala el paquete ejecutando el siguiente comando:<\/p>\n
yarn add @getvim\/execute<\/code><\/pre>\nA continuaci\u00f3n, importa el paquete en tu archivo index.js <\/strong>a\u00f1adiendo esta l\u00ednea de c\u00f3digo en la parte superior:<\/p>\n
const {execute} = require('@getvim\/execute');<\/code><\/pre>\nLas copias de seguridad se generan como archivos en el sistema de archivos local de tu aplicaci\u00f3n Node. Por tanto, es mejor crear un directorio dedicado para ellas con el nombre de backup<\/strong> en el directorio root del proyecto.<\/p>\n
Ahora, puedes utilizar la siguiente ruta para generar y descargar copias de seguridad de tu base de datos cuando sea necesario:<\/p>\n
app.get('\/backup', async (req, res) => {\n\n \/\/ Create a name for the backup file\n const fileName = \"database-backup-\" + new Date().valueOf() + \".tar\";\n\n \/\/ Execute the pg_dump command to generate the backup file\n execute(\"PGPASSWORD=\" + process.env.PGPASS + \" pg_dump -U \" + process.env.DB_USER_NAME \n + \" -d \" + process.env.DB_DATABASE_NAME \n + \" -h \" + process.env.DB_HOST\n + \" -p \" + process.env.DB_PORT\n + \" -f backup\/\" + fileName + \" -F t\"\n\n).then(async () => {\n console.log(\"Backup created\");\n res.redirect(\"\/backup\/\" + fileName)\n }).catch(err => {\n console.log(err);\n res.json({message: \"Something went wrong\"})\n })\n\n})<\/code><\/pre>\nAdem\u00e1s, tienes que a\u00f1adir la siguiente l\u00ednea al principio de tu archivo index.js<\/strong> despu\u00e9s de inicializar la aplicaci\u00f3n Express:<\/p>\n
app.use('\/backup', express.static('backup'))<\/code><\/pre>\nEsto permite que la carpeta de backup<\/strong> se sirva est\u00e1ticamente utilizando la funci\u00f3n de middleware
express.static<\/code>, permitiendo al usuario descargar los archivos de copia de seguridad generados desde la app Node.<\/p>\n - Selecciona PostgreSQL<\/strong> como tipo de Base de Datos y elige la versi\u00f3n que prefieras. Elige un nombre para tu base de datos y modifica el nombre de usuario y la contrase\u00f1a si lo deseas.<\/li>\n
- Node.js<\/a>: Para construir tu aplicaci\u00f3n backend<\/li>\n
- Programado (como CRON)<\/strong>: Este disparador te permite automatizar actividades de mantenimiento programadas durante periodos de bajo tr\u00e1fico de usuarios. Es ideal para ejecutar operaciones que consumen muchos recursos, como el archivado y la limpieza. Puedes utilizar paquetes como node-schedule<\/a> para configurar programaciones en Node.js que disparen las operaciones autom\u00e1ticamente cuando sea necesario.<\/li>\n