Сборка и деплой

Три сценария публикации: статический сайт, приложение с бэкендом и десктопная программа. Пошаговые инструкции для каждого.

Дата составления: 2026-03-30
Статус: ✅ Актуально


Суть

После того, как вы разработали программу, не всегда понятно, как с ней поступить дальше — особенно если хочется поделиться ею со своими коллегами. В этой статье рассмотрим базовые способы поделиться программой с миром.


Сценарий 1 — Статический сайт (только фронтенд)

Инструмент: GitHub Pages Стоимость: бесплатно Время: 5–10 минут

Когда подходит: HTML-файл без бэкенда — калькулятор, конвертер, форма, визуализация.

Шаги:

  1. Создайте репозиторий на GitHub и загрузите туда .html-файл (и style.css, script.js, если есть)

  2. Перейдите в Settings → Pages

  3. В разделе Source выберите ветку main и папку /root

  4. Нажмите Save — через минуту сайт доступен по адресу https://username.github.io/repo-name

Ограничения: нет бэкенда, нет API-ключей, нет баз данных, нет загрузки файлов.


Сценарий 2 — Веб-приложение

Инструменты: Amvera (РФ), Render, Railway

Стоимость: от бесплатного тарифа с ограничениями Время: 20–40 минут при первом деплое

Когда подходит: Python-приложение, которое обращается к API нейросети, работает с файлами или хранит данные.

Что нужно подготовить:

  • Файл requirements.txt с зависимостями (нейросеть сгенерирует по запросу).

  • Переменные окружения (API-ключи) — вводятся в настройках хостинга, не в коде.

  • Код приложения в GitHub-репозитории.

Остальные инструкции получите у вашей LLM под выбранный вами сервис.

Чек-лист перед деплоем

  • requirements.txt актуален (нейросеть обновит по запросу)

  • Все секреты в .env, не в коде

  • .env добавлен в .gitignore

  • Репозиторий не содержит лишних файлов (кэш, __pycache__, тестовые данные)

  • Переменные окружения добавлены в настройки хостинга

  • Программа протестирована локально перед деплоем


Сценарий 3 — Десктопная программа (.exe / .app)

Инструменты: PyInstaller, GitHub Actions Стоимость: бесплатно Время: 30–60+ минут при первой настройке

Когда подходит: нужно передать программу коллегам без установки Python, или программа работает с локальными файлами.

Сборка через PyInstaller локально:

pip install pyinstaller pyinstaller —onefile main.py

После сборки в папке dist/ появится исполняемый файл. Его можно передать коллегам.

Автоматическая сборка через GitHub Actions:

Создайте файл .github/workflows/build.yml в репозитории. Попросите нейросеть:

«Напиши build.yml для GitHub Actions, который при каждом пуше собирает .exe для Windows и .app для macOS с помощью PyInstaller из файла main.py»

После пуша GitHub сам запустит сборку на облачных машинах. Готовые файлы появятся во вкладке Actions → выбранный запуск → Artifacts.

Ограничение: .exe собранный на Windows не запустится на macOS и наоборот. Матричная сборка в GitHub Actions решает это автоматически.

Чек-лист перед сборкой

  • Программа запускается локально без ошибок через терминал

  • Все зависимости прописаны в requirements.txt (попросите нейросеть проверить: «Проверь requirements.txt — все ли библиотеки, которые используются в проекте, туда включены?»)

  • Все секреты в .env, не в коде

  • Дополнительные файлы (иконки, шрифты, локальные данные) подготовлены и указаны в конфиге PyInstaller

  • Сделан git commit — точка возврата перед сборкой


Что учесть

  • При первом деплое закладывайте время на решение неожиданных проблем совместимости.

  • Бесплатные тарифы Render и Railway имеют лимиты — для активно используемого инструмента может понадобиться платный тариф.

  • GitHub Actions работает бесплатно только с публичными репозиториями.


Связанные статьи


Теги: #инструкция #средний #вайб-кодинг #деплой