Как опубликовать приложение на Python
Создайте небольшое приложение на Flask, опубликуйте его на своём домене в WebShield и пройдите весь путь — от первой сборки до обновления и отката.
Приложению на Python нужен постоянно доступный процесс, который принимает запросы из интернета. В разделе Приложения WebShield собирает код, запускает его и подключает ваш домен с HTTPS.
Начнём с Flask: одна страница спрашивает имя и выводит приветствие. База данных для этого примера не нужна.
Что получится: приложение на app.example.com, которое можно обновлять из терминала
и возвращать к прежней версии из кабинета.
Понадобится: аккаунт WebShield, свой домен и терминал Linux, macOS или WSL.
Для проверки на компьютере — Python 3.10 или новее. Время: около 30 минут,
без ожидания обновления DNS.
1. Создайте проект и приложение
Заголовок раздела «1. Создайте проект и приложение»Откройте Услуги → Приложения в кабинете.
Посмотрите цены и условия оплаты по факту, затем создайте проект hello.
При первом создании подтвердите условия оплаты в появившемся окне.
Внутри него создайте приложение web: вид Приложение, порт 8080.
Остальные настройки оставьте исходными.
Проект объединяет связанные приложения и базы, а web — отдельный сервис, куда мы
загрузим код. После создания его карточка должна появиться внутри hello.
2. Подготовьте файлы
Заголовок раздела «2. Подготовьте файлы»Создайте пустой каталог flask-hello, а внутри — папку templates:
mkdir -p flask-hello/templatescd flask-helloСохраните следующие пять файлов. Имена и расположение должны совпадать с примером.
requirements.txt — зависимости:
Flask==3.1.2gunicorn==23.0.0app.py — обработчик главной страницы:
import os
from flask import Flask, render_template, request
app = Flask(__name__)
@app.get("/")def index(): # Посетительские данные передаём шаблону: он экранирует их перед выводом в HTML. return render_template( "index.html", title=os.environ.get("APP_TITLE", "Привет из WebShield!"), name=request.args.get("name", "мир"), )templates/index.html — страница с формой:
<!doctype html><html lang="ru"><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>{{ title }}</title><h1>{{ title }}</h1><p>Здравствуйте, {{ name }}!</p><form method="get"> <label>Ваше имя <input name="name" maxlength="100" required></label> <button type="submit">Поздороваться</button></form></html>Текст имени попадает в шаблон как значение. Кавычки и HTML-разметка в имени будут экранированы: посетитель не сможет превратить приветствие в исполняемый код.
gunicorn.conf.py — настройки сервера:
import os
bind = "0.0.0.0:" + os.environ.get("PORT", "8080")workers = 1accesslog = "-"errorlog = "-"Сервер слушает порт, который передаст платформа, и пишет запросы и ошибки в журнал. Для публикации используем Gunicorn.
railpack.json — команда запуска при публикации:
{ "$schema": "https://schema.railpack.com", "deploy": { "startCommand": "gunicorn app:app" }}app:app означает объект app из файла app.py. Зависимости установятся при сборке
по requirements.txt; Dockerfile для этого примера не нужен.
3. Проверьте приложение на компьютере
Заголовок раздела «3. Проверьте приложение на компьютере»В каталоге flask-hello выполните:
python3 -m venv .venv. .venv/bin/activatepython -m pip install -r requirements.txtgunicorn app:appОткройте http://localhost:8080/. Должно появиться приветствие и поле для имени.
Введите Анна & Борис: страница покажет эти символы как обычный текст.
Остановите сервер сочетанием Ctrl+C.
4. Подготовьте загрузку
Заголовок раздела «4. Подготовьте загрузку»Создайте .webshieldignore, чтобы локальные зависимости и секреты не попали в архив:
.venv/venv/__pycache__/*.pyc.env.env.*Рядом сохраните webshield.toml с именами из первого шага:
[app]project = "hello"name = "web"Установите клиент командной строки, затем проверьте наличие команды:
webshield apps --helpВ карточке проекта hello выпустите Токен для CI. Он позволяет публиковать код
только в этом проекте и читать журнал. Скопируйте его и выполните:
webshield auth loginВставьте токен в приглашение CLI. Не записывайте его в файлы приложения.
5. Опубликуйте код
Заголовок раздела «5. Опубликуйте код»Из каталога flask-hello запустите:
webshield apps deployCLI загрузит исходники и дождётся результата. В кабинете на вкладке Выкатки появится запись: В очереди → Сборка → Запуск → Работает. Первая сборка может занять несколько минут. При ошибке откройте Журнал сборки у этой записи.
6. Подключите адрес
Заголовок раздела «6. Подключите адрес»Во вкладке Имена приложения добавьте app.example.com, заменив его своим именем.
Если домена ещё нет в аккаунте, сначала подключите его.
- Если DNS домена обслуживает WebShield, дождитесь создания записи и сертификата.
- Если DNS остаётся у другого провайдера, добавьте показанные записи по инструкции подключения без смены NS.
Откройте https://app.example.com/. На своём адресе должна появиться та же форма,
что при локальной проверке. Для приложения берите свободное имя: привязка меняет,
куда идут запросы к нему.
7. Обновите страницу и верните прежнюю версию
Заголовок раздела «7. Обновите страницу и верните прежнюю версию»В templates/index.html замените текст кнопки Поздороваться на Отправить привет.
Повторите webshield apps deploy. После статуса Работает обновите страницу:
надпись на кнопке изменится.
Теперь в кабинете откройте Выкатки и у первой успешной записи нажмите Вернуть эту версию. Дождитесь завершения: кнопка снова называется Поздороваться. Откат меняет работающую версию; файл на вашем компьютере остаётся новым.
Проверка
Заголовок раздела «Проверка»Откройте опубликованную страницу, отправьте имя и посмотрите журнал:
webshield apps logsВ нём должны быть запросы к / с ответом 200. Записи могут появиться с задержкой:
если сразу после запуска журнал пуст, повторите команду через минуту.
Для проверки экранирования откройте
https://app.example.com/?name=Анна%20%26%20Борис: на странице будет Анна & Борис.
Ввод <script>alert(1)</script> должен быть заблокирован защитой или показан текстом,
без выполнения. Экранирование приложения действует и при выключенной бот-защите.
Для проверки переменных нажмите Переменные окружения, задайте APP_TITLE =
Моё первое приложение и у активной выкатки нажмите Выкатить заново.
После завершения заголовок страницы изменится.
Когда закончите знакомство, отзовите учебный токен в блоке Токен для CI проекта. Затем отвяжите имя во вкладке Имена, удалите учебное приложение и пустой проект. Пока приложение запущено, его ресурсы учитываются по условиям оплаты по факту.
Если не работает
Заголовок раздела «Если не работает»| Симптом | Причина и решение |
|---|---|
CLI не знает команду apps |
Установлена старая версия. Обновите CLI по инструкции установки. |
CLI не находит приложение или отвечает 403 |
Проверьте имена в webshield.toml и что токен выпущен для проекта hello. |
| Сборка завершилась ошибкой | Откройте Журнал сборки. Проверьте имена файлов, зависимости и что загружаете каталог с app.py и requirements.txt. |
Запуск не завершается или адрес отдаёт 502 |
Проверьте Журнал, команду gunicorn app:app и наличие gunicorn.conf.py: порт должен совпадать с настройкой приложения. |
| На своём адресе нет HTTPS или открывается прежний сайт | Проверьте статус имени, DNS-записи и выпуск сертификата во вкладке Имена. |
| Переменная изменена, а заголовок прежний | После сохранения переменной нажмите Выкатить заново у активной выкатки. |
Если прежняя версия отвечает, а новая долго остаётся в статусе Запуск и в журнале нет ошибок, напишите в поддержку: укажите проект, приложение и номер выкатки.
Что дальше
Заголовок раздела «Что дальше»- Приложения — настройки, сон, журнал и оплата.
- База данных Postgres — хранение данных между перезапусками.
- Обновление из приватного репозитория — публикация после каждого push.