Databáza, premenné a trvalé súbory
Premenné prostredia
Tajomstvá a nastavenia patria na záložku Premenné, súbor .env nenahrávajte. Hodnoty sú uložené šifrovane a aplikácia ich číta cez process.env. Zmena sa prejaví po ďalšom nasadení. Premennú PORT nastavujeme my.
Databáza
Na záložke Databáza vyberte MariaDB alebo PostgreSQL a kliknite na Vytvoriť databázu. Databáza nie je dostupná z internetu a pripojenie sa uloží do premennej DATABASE_URL. Aplikácia ju dostane pri ďalšom nasadení. Príklad pre MariaDB s balíkom mysql2:
const mysql = require("mysql2/promise");
const pool = mysql.createPool(process.env.DATABASE_URL);
Pre PostgreSQL napríklad s balíkom pg:
const { Pool } = require("pg");
const pool = new Pool({ connectionString: process.env.DATABASE_URL });
Pri Prisme nastavte v schéme provider podľa typu databázy: mysql pre MariaDB, postgresql pre PostgreSQL. PostgreSQL beží pre celý balík vo vlastnom kontajneri a berie 256 MB z jeho pamäte, všetky jeho databázy PostgreSQL sa o ňu delia. Typ databázy sa po vytvorení nedá zmeniť – ak chcete iný, databázu zmažte a vytvorte novú.
Databázu zálohujeme každú noc na úložisko mimo servera a zálohy držíme 3 týždne. Zo zvolenej zálohy ju obnovíte sami v záložke Zálohy pri aplikácii.
Redis
Na záložke Databáza v časti Redis vyberte veľkosť a kliknite na Zapnúť Redis. Každá aplikácia má vlastný Redis (Valkey, open-source Redis s rovnakými príkazmi a knižnicami) a jeho pamäť sa odpočíta z balíka. Z internetu nie je dostupný a pripojenie sa uloží do premennej REDIS_URL. Aplikácia ju dostane pri ďalšom nasadení. Príklad s balíkom ioredis:
const Redis = require("ioredis");
const redis = new Redis(process.env.REDIS_URL);
Fronty BullMQ potrebujú pripojenie s maxRetriesPerRequest: null:
const { Queue } = require("bullmq");
const connection = new Redis(process.env.REDIS_URL, { maxRetriesPerRequest: null });
const queue = new Queue("emails", { connection });
Dáta sa ukladajú na disk každú sekundu, takže prežijú reštart aj nasadenie, a rátajú sa do disku balíka. Keď sa pamäť zaplní, Redis ďalšie zápisy odmietne a nič sám nezmaže, kľúčom v cache preto nastavte platnosť (TTL). Veľkosť zmeníte na tej istej záložke, Redis sa pri tom na pár sekúnd reštartuje. Zálohujeme ho každú noc spolu s databázami, obnovu zatiaľ robíme na požiadanie.
Migrácie
V Nastaveniach do poľa Príkazy pred nasadením napíšte príkaz na migráciu, každý na samostatný riadok. Napríklad pre Prismu:
npx prisma migrate deploy
Príkazy vidia premenné aplikácie vrátane DATABASE_URL. Keď niektorý zlyhá, nová verzia sa nespustí a predchádzajúca beží ďalej. Balík s migračným nástrojom musí byť v dependencies, pri inštalácii npm ci --omit=dev sa vývojové balíky nenainštalujú. Pri návrate na staršiu verziu sa migrácie nevracajú.
Trvalé súbory
Pri každom nasadení vzniká nová verzia aplikácie a súbory zapísané v nej sa zmažú. Čo má ostať, napríklad nahrané obrázky, ukladajte do priečinka /data:
const fs = require("fs");
fs.writeFileSync("/data/subor.txt", "ostane aj po nasadení");
Procesy na pozadí
Cron alebo spracovanie fronty pridáte na záložke Procesy tlačidlom Pridať proces. Zadajte názov, napríklad cron, a príkaz, napríklad node cron.js. Proces beží samostatne, ale má rovnaký kód, premenné a limit pamäte ako aplikácia.
Limit disku
Na disk balíka sa počíta všetko spolu: aplikácia so závislosťami, súbory v /data, statické weby a databázy. Využitie vidíte v detaile balíka a pri 90 % vám pošleme e-mail.
Keď sa disk naplní, zápis do /data skončí chybou, nové verzie sa nenasadia a databázy budú len na čítanie a mazanie. Bežiaca aplikácia pritom ďalej beží. Súbor tabuľky sa po bežnom DELETE nezmenší, miesto uvoľní TRUNCATE alebo DROP. Zápis sa obnoví do minúty po uvoľnení miesta.
Súbory mimo /data sa pri každom nasadení zmažú a jedna aplikácia si ich môže uložiť najviac 1 GB. Priečinok /tmp je v pamäti a počíta sa do jej limitu.
Zálohy
Databázy aj súbory v /data zálohujeme každú noc na úložisko mimo servera a zálohy držíme 3 týždne. Zo zvolenej zálohy ich obnovíte sami v záložke Zálohy pri aplikácii, kód vrátite staršou verziou v Nasadeniach.