Свяжите репозиторий
Укажите URL GitHub/GitLab или локальную папку. Платформа определит язык, зависимости и точку входа автоматически.
Начало работы
Пошаговое руководство по первому деплою на SnapApi: создайте аккаунт, настройте функцию, запустите приложение и освойте несколько команд CLI. Без лишней настройки и без сюрпризов.
Шаг 1 · Регистрация аккаунта
Регистрация занимает меньше минуты и не требует банковской карты. Сразу после входа вы получите доступ к консоли, CLI и 100 тыс. бесплатных запросов в месяц.
Перейдите на страницу входа и выберите способ аутентификации: e-mail, GitHub или Google. Мы отправим одноразовый код подтверждения — введите его, и аккаунт будет создан.
После входа система автоматически создаёт вашу рабочую область (workspace) с названием вида my-team. В ней будут храниться все проекты, ключи API и логи деплоя. Вы можете сменить имя области в настройках в любой момент.
На бесплатном тарифе «Пробный» доступно до трёх функций, 1 ГБ трафика и 256 МБ памяти на функцию. Этого достаточно для прототипов, личных проектов и небольших сервисов.
Шаг 2 · Настройка первой функции
SnapApi использует простой формат: каждая функция — это один JavaScript-модуль с экспортированной обработкой. Ниже минимальный пример, который можно скопировать и развернуть как есть.
Создайте проект в консоли (кнопка «Новый проект» → «Функция»), назовите его, например, hello-api и выберите рантайм Node.js 20. Затем откройте файл index.js и вставьте код ниже.
Функция отвечает на любой GET-запрос к корню, возвращает JSON и измеряет время ответа. При первом вызове платформа прогревает рантайм, при последующих — использует кэш, поэтому задержка падает до десятков миллисекунд.
Когда код готов, сохраните файл — консоль предложит задеплоить новую версию. Так вы переходите к следующему шагу.
Шаг 3 · Первый деплой
Деплой на SnapApi не требует сборки, контейнеров или настройки серверов. Достаточно одной команды — платформа возьмёт код из репозитория и поднимет его на ближайшем узле.
Укажите URL GitHub/GitLab или локальную папку. Платформа определит язык, зависимости и точку входа автоматически.
Команда snap deploy собирает артефакт, загружает его в CDN и переключает трафик без простоя. Весь процесс занимает около 90 секунд.
Откройте публичный URL вида https://hello-api.my-team.snapapi.app — вы увидите JSON с полем message и задержкой в миллисекундах.
Шаг 4 · Основные команды CLI
Установите CLI (npm i -g @snapapi/cli), выполните snap login — и вы готовы. Ниже команды, которые пригодятся в первые дни.
snap initСоздаёт проект с конфигом snap.config.js, подключает локальный рантайм и готовит структуру для деплоя.
snap deployПубликует новую версию. Флаги --env production и --region eu-central позволяют выбрать окружение и узел.
snap logsСтриминг логов в терминал. Добавьте --follow для постоянного обновления и --since 5m для вывода за последние 5 минут.
snap metricsПоказывает QPS, p95 задержки и расход памяти по функциям. Удобно для быстрой диагностики перед релизом.
snap rollbackМгновенно возвращает предыдущую стабильную версию без пересборки. Идеально, если новый релиз ведёт себя не так, как ожидалось.
snap envУправляет переменными окружения: set, list, remove. Секреты шифруются при хранении и доступны только в рантайме.
В цифрах
Создайте аккаунт, подключите репозиторий и запустите snap deploy. Через минуту ваше приложение будет отвечать на реальные запросы.
Вопросы
Не нашли ответ — напишите нам в чат, отвечаем в течение рабочего дня.
snap.config.js.snap deploy ./my-app возьмёт код прямо из текущей папки, соберёт артефакт и опубликует его. Это удобно для локального тестирования перед пушем в репозиторий.