{ "version": "https:\/\/jsonfeed.org\/version\/1.1", "title": "Yuriy Gavrilov: posts tagged DevOps", "_rss_description": "Welcome to my personal place for love, peace and happiness 🤖 Yuiry Gavrilov", "_rss_language": "en", "_itunes_email": "yvgavrilov@gmail.com", "_itunes_categories_xml": "", "_itunes_image": "https:\/\/gavrilov.info\/pictures\/userpic\/userpic-square@2x.jpg?1643451008", "_itunes_explicit": "no", "home_page_url": "https:\/\/gavrilov.info\/tags\/devops\/", "feed_url": "https:\/\/gavrilov.info\/tags\/devops\/json\/", "icon": "https:\/\/gavrilov.info\/pictures\/userpic\/userpic@2x.jpg?1643451008", "authors": [ { "name": "Yuriy Gavrilov - B[u]g - for charity.gavrilov.eth", "url": "https:\/\/gavrilov.info\/", "avatar": "https:\/\/gavrilov.info\/pictures\/userpic\/userpic@2x.jpg?1643451008" } ], "items": [ { "id": "307", "url": "https:\/\/gavrilov.info\/all\/svoy-heroku-doma-zapustil-dokku-doma-i-nakatil-novogodnego\/", "title": "Свой Heroku: запустил Dokku дома и накатил новогоднего :)", "content_html": "

Мы привыкли, что для развертывания веб-приложений нужно платить за VPS или разбираться в дебрях Kubernetes. Но если у вас есть домашний сервер (в моем случае — Asustor), вы можете создать свою собственную PaaS-платформу (Platform as a Service), которая работает по принципу *“git push — и готово”*.<\/p>\n

Сегодня я расскажу, как настроить Dokku<\/b> через Portainer, запустить веселое Python-приложение к Новому 2026 году и поделюсь лайфхаками по оптимизации сборки и масштабированию.<\/p>\n

\n\"\"\n<\/div>\n
\n

Часть 1. Фундамент: Запуск Dokku в Portainer<\/h3>\n

Dokku — это Docker-контейнер, который управляет другими Docker-контейнерами. Чтобы он заработал на NAS, его нужно правильно запустить. Я использовал Portainer Stack.<\/p>\n

Docker Compose конфигурация<\/h4>\n

Вот рабочий `docker-compose.yml`, который решает главную проблему — доступность приложений из локальной сети.<\/p>\n

# version: '3.2'\nservices:\n  agent:\n    image: dokku\/dokku:${VERSION}\n    pid: host.  # ⚠️ важно для работы на NAS\n    network_mode: bridge # ⚠️ важно для работы на NAS\n    environment:\n      DOKKU_HOSTNAME: ${DOKKU_HOSTNAME}\n      DOKKU_HOST_ROOT: ${DOKKU_HOST_ROOT}\n    volumes:\n      - \/var\/run\/docker.sock:\/var\/run\/docker.sock\n      - ${VOLUME_PATH:-\/var\/lib\/dokku}:\/mnt\/dokku\n    ports:\n      - "3022:22" # ⚠️ важно для работы через ssh и что бы не конфликтовал с 22 \n      - "80:80"    # Внешний порт 80 -> порт 80 внутри контейнера Dokku\n      - "443:443"<\/code><\/pre>
Нюансы сети:<\/b>
\nЧтобы обращаться к приложениям по красивым домегам типа `my-app.dokku.datahub.mother`, я настроил AdGuard Home<\/b> в качестве локального DNS-сервера (фильтры получил бонусом – где-то 20% это всякие счетчики, ужас:). Добавил правило Rewrite: `*.dokku.datahub.mother` → `192.168.0.20` (IP моего NAS). Теперь все поддомены (приложения) автоматически ведут на Dokku.<\/p>\n
Также для удобства я настроил `~\/.ssh\/config` на ноутбуке, чтобы не вводить порты вручную:<\/p>\n
Host dokku.datahub.mother\n  HostName 192.168.0.20\n  Port 3022\n  User dokku<\/code><\/pre>
ну и ключ сам так можно добавить<\/p>\n
echo "ВАШ_ПУБЛИЧНЫЙ_КЛЮЧ" | dokku ssh-keys:add dokku<\/code><\/pre>
\n
Часть 2. Приложение “my-first-app”: Новогоднее гадание<\/h3>\n
Для теста я написал простое Flask-приложение, которое рассчитывает ваш возраст в наступающем 2026 году.<\/p>\n
Код приложения (`app.py`)<\/h4>\n
from flask import Flask, request\n\napp = Flask(__name__)\n\n@app.route('\/')\ndef home():\n    return """\n    <h1>Приветствую в игре Нового 2026 года! 🎉<\/h1>\n    <p>Это веселая интерактивная игра в честь Нового года. Угадай свой возраст на 1 января 2026!<\/p>\n    <p>Введи свой год рождения:<\/p>\n    <form action="\/result" method="get">\n        <input type="number" name="birth_year" min="1900" max="2025" required>\n        <button type="submit">Угадать возраст на Новогодний 2026!<\/button>\n    <\/form>\n    """\n\n@app.route('\/result')\ndef result():\n    birth_year = request.args.get('birth_year')\n    if not birth_year or not birth_year.isdigit():\n        return "Ошибка: введи корректный год рождения!"\n    \n    birth_year = int(birth_year)\n    age_in_2026 = 2026 - birth_year\n    return f"""\n    <h2>Результат: 🎇<\/h2>\n    <p>В 2026 году тебе будет {age_in_2026} лет!<\/p>\n    <p>Счастливого Нового 2026 года! Пусть все твои желания сбудутся!<\/p>\n    <a href="\/">Играть снова<\/a>\n    """\n\nif __name__ == '__main__':\n    app.run(host='0.0.0.0', port=5000)<\/code><\/pre>
Подготовка к деплою<\/h4>\n
Чтобы Dokku понял, как запускать это чудо, нужны два файла в корне проекта:<\/p>\n
    \n
  1. `requirements.txt`<\/b> (зависимости):<\/li>\n<\/ol>\n
    Flask==2.3.2\ngunicorn==20.1.0\nWerkzeug==2.3.3<\/code><\/pre>
      \n
    1. `Procfile`<\/b> (команда запуска):<\/li>\n<\/ol>\n
      web: gunicorn app:app --bind 0.0.0.0:5000<\/code><\/pre>
        \n
      1. `.python-version`<\/b> (опционально, явная версия Python):<\/li>\n<\/ol>\n
        3.11.14<\/code><\/pre>
        Процесс деплоя<\/h4>\n
        Все делается через Git, как на “взрослых” платформах:<\/p>\n
          \n
        1. Создаем приложение на сервере:<\/b><\/li>\n<\/ol>\n
          ssh dokku@dokku.datahub.mother apps:create my-first-app<\/code><\/pre>
            \n
          1. Отправляем код:<\/b><\/li>\n<\/ol>\n
            git init\n    git add .\n    git commit -m "Happy New Year 2026 version"\n    git remote add dokku dokku@dokku.datahub.mother:my-first-app\n    git push dokku master<\/code><\/pre>
            Если вы до этого еще что-то деплоили, то лучше проверить куда гит смотрит<\/p>\n
            git remote -v<\/code><\/pre>
            ну и поменяем еще не верное<\/p>\n
            git remote remove dokku<\/code><\/pre>
            git init\n    git add .\n    git commit -m "Happy New Year 2026 version"\n    git remote add dokku dokku@dokku.datahub.mother:my-first-app\n    git push dokku master<\/code><\/pre>
            После пуша Dokku сам скачает Python, установит Flask и запустит Gunicorn. Через минуту-две приложение доступно по адресу `http:\/\/my-first-app.dokku.datahub.mother<\/a>`.<\/p>\n
            Еще нужно домен установить<\/p>\n
            ssh dokku@dokku.datahub.mother domains:set my-first-app my-first-app.dokku.datahub.mother<\/code><\/pre>
            или можно сразу глобально его установить:<\/p>\n
            ssh dokku@dokku.datahub.mother domains:set-global dokku.datahub.mother\n# но тогда придется удалить ручную привязку \nssh dokku@dokku.datahub.mother domains:clear my-first-app\n\n# не забыть перебрать nginx ( на всякий случай ) \nssh dokku@dokku.datahub.mother proxy:build-config my-first-app<\/code><\/pre>
            Сертификат сгенерировать<\/p>\n
            ssh dokku@dokku.datahub.mother certs:generate my-first-app my-first-app.dokku.datahub.mother<\/code><\/pre>
            и проверить порты<\/p>\n
            ssh dokku@dokku.datahub.mother ports:report my-first-app<\/code><\/pre>
            если порты не корректные, то можно их установить так:<\/p>\n
            ssh dokku@dokku.datahub.mother ports:set my-first-app http:80:5000 https:443:5000<\/code><\/pre>
            \n
            Часть 3. Уровень PRO: Скорость (uv) и Marimo<\/h3>\n
            Аппетит приходит во время еды. После простого Flask-приложения я решил развернуть что-то посерьезнее — Data Science ноутбук на Marimo<\/b>, и столкнулся с реальными сложностями и особенностями. Для примера брал их дело ноутбук https:\/\/marimo.app<\/a><\/p>\n
            1. Ускорение сборки с `uv`<\/h4>\n
            Стандартный `pip` устанавливает пакеты медленно. Если проект большой, деплой может висеть минутами.
            \nЯ перешел на uv<\/b> — новый менеджер пакетов на Rust.<\/p>\n
            Вместо `requirements.txt` я использовал `pyproject.toml` и `uv.lock`. Dokku (благодаря современным buildpacks) увидел `uv.lock` и переключился на быстрый режим. Время сборки сократилось в разы<\/b>.<\/p>\n
            2. Ловушка масштабирования (Scaling)<\/h4>\n
            Marimo — это stateful<\/b> приложение (хранит состояние в памяти). Flask, который мы делали выше — stateless<\/b>.<\/p>\n
            Когда я задеплоил Marimo, Dokku по умолчанию все было хорошо, но потом я решил масштабировать его и сделал так<\/p>\n
            ssh dokku@dokku.datahub.mother ps:scale my-marimo-app web=3<\/code><\/pre>
            далее Dokku запустил 3 копии<\/b> контейнера (`web=3`).
            \nНачался хаос:<\/p>\n