Сеть Deploy

Публичные HTTPS-точки доступа, собственные домены, WebSocket, тайм-ауты, адрес клиента, частная сеть и исходящий доступ.

Публичные точки доступа

  • Точка доступа даёт сервису публичный адрес вида https://<имя>.app.acdn.uz. Имя генерируется: его нельзя выбрать, и оно не меняется, пока существует точка доступа. Как получить выбранное имя или собственный домен, описано ниже в разделе «Собственные домены».
  • TLS завершается на стороне ACDN с действительным сертификатом для этого имени хоста. Клиенты могут использовать HTTP/1.1 или HTTP/2; контейнер получает обычный HTTP/1.1 на порт точки доступа.
  • На запросы к http:// возвращается перенаправление 301 на https://.
  • У сервиса может быть несколько точек доступа, по одной на порт контейнера. Маршрутизируется только HTTP: опубликовать «сырые» порты TCP и UDP нельзя.
  • Точка доступа работает, пока у сервиса есть активный релиз. Пока сервис остановлен, заменяется при релизе с томами или ещё ни разу не развёртывался, точка доступа отвечает статусом ошибки, например 503.
  • Запросы распределяются между экземплярами сервиса без привязки сессий. Храните состояние сессии вне отдельного экземпляра.
  • Запросы с именем заголовка, содержащим подчёркивание, отклоняются со статусом 400.

Собственные домены

Чтобы сервис отвечал на вашем домене или на выбранном вами имени в зоне vvvv.uz, поставьте перед его точкой доступа pull-зону CDN. Pull-зона даёт имена хостов и TLS-сертификаты для них и передаёт каждый запрос сервису. CNAME с вашего домена напрямую на сгенерированное имя хоста в зоне app.acdn.uz не работает.

Shell
# 1. привяжите pull-зону к точке доступа; сервис начнёт отвечать на chat.vvvv.uz
python3 acdn-agent.py call /api/user/pull-zones -- --json '{
  "name": "chat",
  "source_type": "deploy",
  "source_deploy_endpoint_id": "ENDPOINT_ID",
  "tier": "std"
}'

# 2. добавьте своё имя хоста; в ответе вернётся cname_target
python3 acdn-agent.py call /api/user/pull-zones/hostnames/PULL_ZONE_ID -- \
  --json '{"hostname":"chat.example.com"}'

# 3. создайте DNS-запись: chat.example.com CNAME chat.vvvv.uz
# 4. запросите сертификат и опрашивайте статус, пока не получите "status":"active"
python3 acdn-agent.py call /api/user/pull-zones/hostnames/check/PULL_ZONE_ID -- \
  --json '{"hostname":"chat.example.com"}'
python3 acdn-agent.py call '/api/user/pull-zones/hostnames/status/PULL_ZONE_ID?hostname=chat.example.com'
  • ENDPOINT_ID — идентификатор точки доступа сервиса; он возвращается в поле endpoints в ответах сервиса и приложения. Для создания pull-зоны нужны подтверждённый адрес электронной почты и баланс больше нуля.
  • Pull-зона сервиса поддерживает CORS, Edge Rules, блокировку POST и корневых путей, загрузку файлов и WebSocket. Эти настройки действуют только на доменах CDN; сгенерированная точка доступа остаётся доступна напрямую. Token Auth и Origin Shield недоступны. Заголовки Host, Connection и Upgrade нельзя переопределять через Edge Rules; Host и TLS SNI остаются именем точки доступа даже при переопределении origin URL правилом.
  • Для Deploy TTL по умолчанию не задан: приложение управляет кешированием через Cache-Control или Expires. Для публичного контента возвращайте Cache-Control: public, max-age=3600. Без срока кеширования ответы не кешируются; ответы с private/no-store и Set-Cookie исключаются. Запросы с Cookie, Authorization или WebSocket Upgrade обходят кеш. Сортировка ключа, coalescing и нарезка больших файлов доступны в настройках CDN. Сортировка ключа не меняет порядок query-параметров, передаваемых приложению.
  • Для поддомена используйте CNAME. Для корневого домена разместите зону в ACDN DNS: запись тогда создаётся и обновляется автоматически.
  • В заголовке Host сервис получает сгенерированное имя хоста точки доступа. Имя хоста, по которому обратился посетитель, передаётся в X-Forwarded-Host.
  • Запросы приходят через два прокси, поэтому адрес посетителя стоит на другой позиции в X-Forwarded-For (см. «Адрес клиента»).
  • На именах хостов pull-зоны HTTP по умолчанию не перенаправляется на HTTPS. Включите перенаправление для каждого имени хоста операцией force-ssl; не определяйте обычный HTTP по заголовку X-Forwarded-Proto.
  • Через pull-зону принимаются тела запросов до 100 МиБ. Запросы к типовым чувствительным путям, таким как /.env и /.git, отклоняются со статусом 403 и до сервиса не доходят.
  • Ограничение 5 минут простоя для WebSocket и ограничение 15 секунд на ответ действуют без изменений.
  • Трафик через pull-зону оплачивается дважды: как доставка CDN по цене тарифа pull-зоны и как исходящий трафик сервиса.
  • Сгенерированное имя хоста точки доступа продолжает работать. Удаление точки доступа, её сервиса или приложения также безвозвратно удаляет CDN pull-зоны, связанные с удаляемыми точками доступа, включая настройки собственных доменов и DNS-записи, управляемые ACDN. Кабинет предупреждает перед удалением; API выполняет каскадное удаление без дополнительного параметра подтверждения. DNS-записи у внешнего провайдера удалите отдельно.

WebSocket и тайм-ауты

  • WebSocket поддерживается на каждой точке доступа, на том же порту, что и HTTP, без дополнительных настроек. Подключайтесь по wss:// к имени хоста точки доступа.
  • Соединение WebSocket закрывается после 5 минут без данных в обоих направлениях. Кадры ping и pong WebSocket считаются данными. Отправляйте ping или прикладной heartbeat не реже раза в минуту.
  • У активного соединения WebSocket нет максимального времени жизни, но оно завершается при замене экземпляра.
  • Обычный HTTP-ответ должен быть полностью отдан в течение 15 секунд после того, как запрос получен целиком. Иначе запрос обрывается; если ответ ещё не начался, клиент получает статус 504.
  • Эти 15 секунд распространяются также на потоковые ответы, такие как Server-Sent Events и long polling, и на загрузки, которые длятся дольше. Для долгоживущих соединений используйте WebSocket, а для больших файлов — ACDN Storage или CDN.
  • Время, за которое клиент отправляет тело запроса, в эти 15 секунд не входит.
  • Во время релиза открытые соединения со старым экземпляром обрываются при его завершении. Клиенты должны переподключаться.

Адрес клиента

  • Контейнер видит соединения от шлюза ACDN, а не от посетителя. Адрес посетителя передаётся в заголовке X-Forwarded-For.
  • На сгенерированном имени хоста точки доступа между клиентом и контейнером ровно один прокси. Шлюз добавляет адрес подключившегося клиента последним значением X-Forwarded-For в каждом запросе, включая запрос на переключение в WebSocket. Значения перед ним прислал сам клиент, и доверять им нельзя.
  • Для ограничения частоты запросов по IP используйте последнее значение X-Forwarded-For. Во фреймворках с настройкой доверенных прокси укажите один доверенный прокси.
  • Через pull-зону (собственный домен) прокси два: последнее значение — адрес edge-узла ACDN, а адрес посетителя стоит перед ним.
  • Клиент, который обращается напрямую к сгенерированному имени хоста, может подставить перед последним значением свои, поэтому предпоследнему значению можно доверять только для запросов, действительно пришедших через pull-зону. Для защиты собственного домена от злоупотреблений лучше использовать ограничения запросов и соединений на IP в настройках pull-зоны: они применяются на edge-узле по реальному адресу посетителя.
  • X-Forwarded-Proto для переданных запросов равен https, X-Request-Id содержит уникальный идентификатор каждого запроса, а Host — имя хоста точки доступа.

Частная сеть между сервисами

  • Сервисы одного приложения обращаются друг к другу по имени сервиса, например http://api:8080. Точка доступа для этого не нужна.
  • Сервис доступен по имени на своём http_port и на портах своих точек доступа. Чтобы сделать доступным сервис без HTTP, например базу данных, укажите его порт в http_port и оставьте health_check_path пустым; проверка работоспособности тогда лишь убеждается, что порт принимает соединения.
  • Сервисы разных приложений могут обращаться друг к другу только через публичные точки доступа.
  • Из интернета доступны только публичные точки доступа.

Исходящий доступ

  • Контейнеры могут открывать исходящие соединения к публичным адресам интернета только на TCP-порты 80 и 443, а также выполнять DNS-запросы.
  • Все остальные исходящие порты закрыты. В том числе SMTP (25, 465, 587), базы данных и кеши на их собственных портах, SSH и любые UDP-сервисы.
  • Отправляйте почту через HTTPS API почтового провайдера, а к внешним сервисам обращайтесь по HTTPS.
  • Частные и link-local диапазоны адресов недоступны. ACDN Storage доступен по адресу https://storage.acdn.uz.
  • Исходящие соединения идут с общих адресов ACDN; фиксированный или выделенный исходящий адрес не предоставляется.
  • Исходящий трафик ограничен 1 Gbit/s на экземпляр и оплачивается за ГиБ.

Точные поля запросов и ответов, ограничения и ответы с ошибками приведены в справочнике Management API.