Preskočiť na obsah
Pred spustením – zapojte sa do bety

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.

Potrebujete pomôcť s nastavením?

Napíšte nám – radi poradíme s nastavením domény, DNS aj hostingu.

info@feather-host.eu

Ďalšie návody