Перейти к содержимому
WebShield Docs

Как опубликовать приложение на Python

Создайте небольшое приложение на Flask, опубликуйте его на своём домене в WebShield и пройдите весь путь — от первой сборки до обновления и отката.

Приложению на Python нужен постоянно доступный процесс, который принимает запросы из интернета. В разделе Приложения WebShield собирает код, запускает его и подключает ваш домен с HTTPS.

Начнём с Flask: одна страница спрашивает имя и выводит приветствие. База данных для этого примера не нужна.

Что получится: приложение на app.example.com, которое можно обновлять из терминала и возвращать к прежней версии из кабинета. Понадобится: аккаунт WebShield, свой домен и терминал Linux, macOS или WSL. Для проверки на компьютере — Python 3.10 или новее. Время: около 30 минут, без ожидания обновления DNS.

Откройте Услуги → Приложения в кабинете. Посмотрите цены и условия оплаты по факту, затем создайте проект hello. При первом создании подтвердите условия оплаты в появившемся окне. Внутри него создайте приложение web: вид Приложение, порт 8080. Остальные настройки оставьте исходными.

Проект объединяет связанные приложения и базы, а web — отдельный сервис, куда мы загрузим код. После создания его карточка должна появиться внутри hello.

Создайте пустой каталог flask-hello, а внутри — папку templates:

Terminal window
mkdir -p flask-hello/templates
cd flask-hello

Сохраните следующие пять файлов. Имена и расположение должны совпадать с примером.

requirements.txt — зависимости:

Flask==3.1.2
gunicorn==23.0.0

app.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 = 1
accesslog = "-"
errorlog = "-"

Сервер слушает порт, который передаст платформа, и пишет запросы и ошибки в журнал. Для публикации используем Gunicorn.

railpack.json — команда запуска при публикации:

{
"$schema": "https://schema.railpack.com",
"deploy": {
"startCommand": "gunicorn app:app"
}
}

app:app означает объект app из файла app.py. Зависимости установятся при сборке по requirements.txt; Dockerfile для этого примера не нужен.

В каталоге flask-hello выполните:

Terminal window
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txt
gunicorn app:app

Откройте http://localhost:8080/. Должно появиться приветствие и поле для имени. Введите Анна & Борис: страница покажет эти символы как обычный текст. Остановите сервер сочетанием Ctrl+C.

Создайте .webshieldignore, чтобы локальные зависимости и секреты не попали в архив:

.venv/
venv/
__pycache__/
*.pyc
.env
.env.*

Рядом сохраните webshield.toml с именами из первого шага:

[app]
project = "hello"
name = "web"

Установите клиент командной строки, затем проверьте наличие команды:

Terminal window
webshield apps --help

В карточке проекта hello выпустите Токен для CI. Он позволяет публиковать код только в этом проекте и читать журнал. Скопируйте его и выполните:

Terminal window
webshield auth login

Вставьте токен в приглашение CLI. Не записывайте его в файлы приложения.

Из каталога flask-hello запустите:

Terminal window
webshield apps deploy

CLI загрузит исходники и дождётся результата. В кабинете на вкладке Выкатки появится запись: В очереди → Сборка → Запуск → Работает. Первая сборка может занять несколько минут. При ошибке откройте Журнал сборки у этой записи.

Во вкладке Имена приложения добавьте app.example.com, заменив его своим именем. Если домена ещё нет в аккаунте, сначала подключите его.

  • Если DNS домена обслуживает WebShield, дождитесь создания записи и сертификата.
  • Если DNS остаётся у другого провайдера, добавьте показанные записи по инструкции подключения без смены NS.

Откройте https://app.example.com/. На своём адресе должна появиться та же форма, что при локальной проверке. Для приложения берите свободное имя: привязка меняет, куда идут запросы к нему.

7. Обновите страницу и верните прежнюю версию

Заголовок раздела «7. Обновите страницу и верните прежнюю версию»

В templates/index.html замените текст кнопки Поздороваться на Отправить привет. Повторите webshield apps deploy. После статуса Работает обновите страницу: надпись на кнопке изменится.

Теперь в кабинете откройте Выкатки и у первой успешной записи нажмите Вернуть эту версию. Дождитесь завершения: кнопка снова называется Поздороваться. Откат меняет работающую версию; файл на вашем компьютере остаётся новым.

Откройте опубликованную страницу, отправьте имя и посмотрите журнал:

Terminal window
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-записи и выпуск сертификата во вкладке Имена.
Переменная изменена, а заголовок прежний После сохранения переменной нажмите Выкатить заново у активной выкатки.

Если прежняя версия отвечает, а новая долго остаётся в статусе Запуск и в журнале нет ошибок, напишите в поддержку: укажите проект, приложение и номер выкатки.