Ресурсы для субхостинга

Для создания субхостинга с помощью Deno Deploy полезно понимать некоторые ключевые ресурсы системы. Эти ресурсы также представлены в REST API.

overview of subhosting resources

Организации

Организации — это контейнер для всех данных, связанных с реализацией субхостинга. Ваша организация будет иметь имя и идентификатор. Каждая организация имеет конечную точку аналитики, которая может использоваться для получения метрик (таких как количество запросов и использованная полоса пропускания) по всей организации.

Другие пользователи Deploy могут быть приглашены для сотрудничества в рамках организации, и токены доступа могут предоставить разработчикам с доступом к организации возможность модифицировать ресурсы в рамках организации через API. Новые организации могут быть созданы в панели управления Deploy.

Проекты

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

Проекты бесплатны и могут быть настроены по мере необходимости.

Для отслеживания использования отдельными пользователями для выставления счетов существует конечная точка API, которая сообщает аналитику (использование полосы пропускания, количество запросов и т. д.) по каждому проекту с разрешением в 15 минут.

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

Развертывания

Развертывания: развертывание — это набор конфигурации, исполняемого кода и поддерживающих статических файлов, которые могут выполняться в изоляции в Deno Deploy. Развертывания имеют входной файл, который может запускать сервер, может иметь базу данных Deno KV, связанную с ними, и может быть настроен на выполнение на пользовательских доменах.

Развертывание — это неизменяемый объект, состоящий из:

Исходный код для выполнения
Статические ресурсы
Переменные окружения
Связки баз данных
Другие настройки

Мы предоставляем конечные точки для запроса или потоковой передачи логов сборки и запроса или потоковой передачи логов выполнения.

Если вам нужно заблокировать или разблокировать развертывание, вы можете сделать это, удалив развертывание, которое нужно заблокировать, или удалив его домены. Это сделает развертывание недоступным.

Система субхостинга построена таким образом, что поведение или нагрузка одного развертывания не влияют на другие развертывания. Это также относится к различным развертываниям в рамках одной организации. Ёмкость автоматически масштабируется по запросу. Если вы хотите ограничить ресурсы конкретного развертывания или приложения, вы можете использовать API аналитики, чтобы получить подробные метрики (количество запросов, полоса пропускания и т. д.) на уровне проекта. Вы можете использовать это, чтобы принять решение о том, отключить ли развертывания и сделать их недоступными.

ПРИМЕЧАНИЕ. Развертывания неизменяемы, однако вы можете создать новое развертывание и затем переназначить его домен на новое развертывание. Конечная точка повторного развертывания может создать новое развертывание из существующего с другими настройками.

Пользовательские домены

Пользовательские домены могут быть динамически сопоставлены с развертываниями, обеспечивая им уникальный URL (например, mycompany.com).

Прежде чем домен можно будет использовать, вам необходимо подтвердить владение и предоставить или загрузить сертификаты TLS.

Если вы используете уровень Builder, вы можете использовать домены с подстановочными символами. После регистрации домена с подстановочным символом вы можете использовать его двумя способами:

Отправлять все запросы для *.mycompany.com на конкретное развертывание
(Скоро) Назначать различные поддомены (например, foo.mycompany.com и bar.mycompany.com) отдельным развертываниям.

Рабочие и производственные среды

Платформа Deno Deploy для конечных пользователей автоматически создает предварительные развертывания, когда разработчик открывает запрос на изменение в GitHub, а коммиты в ветвь «main» автоматически преобразуются в производственные развертывания. Хотя субхостинг не предоставляет интеграцию с GitHub из коробки, он содержит все необходимые первоэлементы для определения собственных семантик для создания предварительных и производственных развертываний.

Подключение базы данных KV

База данных (KV) хранит пары «ключ-значение». Вы можете сделать базу данных доступной для развертывания при его создании. Базы данных KV могут использоваться несколькими развертываниями одновременно.

Для использования KV с субхостингом:

Создайте базу данных с помощью API
При создании развертывания с помощью API субхостинга укажите созданную базу данных.

ПРИМЕЧАНИЕ. Deno Cron и очереди в настоящее время не работают для субхостинга.

Спецификация OpenAPI и инструменты

Спецификация OpenAPI для API Deploy находится здесь:

https://api.deno.com/v1/openapi.json

Этот документ спецификации может быть использован с большим количеством совместимых с OpenAPI инструментов здесь. В дополнение к документации REST API, размещенной здесь, вы можете найти автоматически сгенерированную документацию API (включая инструмент тестирования в браузере) здесь.