Представляем Livops 2.0! ПромокодCEOдарит 8 000 сумов на ваш счёт.Что нового
Данные / Хранение файлов и данных

Данные

Хранение файлов и данных

Куда приложение может писать, что сохраняется и что пропадает. SQLite, загруженные файлы и DATA_DIR.

Код приложения или бота во время работы доступен только для чтения. Писать можно в два места, и они ведут себя по-разному.

Что сохраняется

Место Сохраняется Для чего
/app/data Да — и после деплоя, и после перезапуска Файл базы, загрузки, сессии
/tmp Нет — очищается при каждом перезапуске и деплое, 128 МБ Временные файлы
Папка с кодом (/app) Писать нельзя —

/app/data — собственный диск проекта. Его путь лежит и в переменной DATA_DIR: лучше брать путь оттуда, чем зашивать в код.

Если в репозитории есть папка data, диск её перекрывает: файлы из неё запущенному приложению не видны.

У проектов с Dockerfile или готовым образом диск смонтирован в /data, DATA_DIR=/data.

SQLite сам попадает на диск

Файл SQLite, имя которого прямо написано в коде, сам связывается с диском. Например:

  • sqlite3.connect('bot.db')
  • SQLAlchemy: sqlite:///app.db
  • better-sqlite3: new Database('app.db')

Такой файл пишется в /app/data и после деплоя не пропадает. Если имя приходит из переменной или конфига, платформа его не видит — тогда берите путь из DATA_DIR.

Примеры

Python, sqlite3:

import os, sqlite3

db = sqlite3.connect(os.path.join(os.environ["DATA_DIR"], "bot.db"))

Бот на aiogram, пользователи в SQLite:

import os
import aiosqlite

DB = os.path.join(os.environ.get("DATA_DIR", "data"), "users.db")

async def save_user(user_id: int):
    async with aiosqlite.connect(DB) as db:
        await db.execute("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY)")
        await db.execute("INSERT OR IGNORE INTO users VALUES (?)", (user_id,))
        await db.commit()

Node, better-sqlite3:

import path from 'node:path'
import Database from 'better-sqlite3'

const db = new Database(path.join(process.env.DATA_DIR ?? 'data', 'app.db'))

Prisma: добавьте в переменные проекта.

DATABASE_URL=file:/app/data/app.db

Папка для загрузок:

const uploads = path.join(process.env.DATA_DIR, 'uploads')
fs.mkdirSync(uploads, { recursive: true })

Для настоящих данных — база

Диск принадлежит одному приложению: другие сервисы его не видят, резервных копий с него не делается. Для небольшого бота или прототипа SQLite хватит. Если там клиенты, заказы, платежи — заведите базу PostgreSQL: у неё есть бэкапы и к ней подключаются несколько сервисов. Для множества картинок и больших файлов — хранилище S3.

Есть вопрос? — @livops_uz