Edge Functions
Напишите функцию в TypeScript, разверните ее одной командой и вызовите из приложения с помощью открытого ключа.
Одна функция, три способа ее активировать#
Edge Function — это часть серверного кода, который Aurabase сохраняет для вашего проекта и запускается по требованию. Вы запускаете одну и ту же функцию тремя способами:
- Вызов: ваше приложение вызывает
aura.functions.invoke('name')или отправляет HTTP-запрос и получает ответ. - Задание: вы ставите вызов в очередь для выполнения в фоновом режиме с задержкой и автоматическими повторными попытками.
- Расписание: запись cron ставит задание в очередь в выбранное вами время.
Существует две среды выполнения: Deno (TypeScript или JavaScript, по умолчанию) и WASM (скомпилированный двоичный файл Rust). Каждый вызов выполняется в отдельном изолированном рабочем процессе с ограничением памяти и тайм-аутом.
Контракт функции#
Функция Deno — это один файл, который вызывает Deno.serve. Он получает описанный вами запрос и возвращает Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
export default никогда не вызывается. Функция представляет собой отдельный файл : относительный импорт не поставляется, поэтому используйте импорт npm: или https://esm.sh/.
Найдите то, что вам нужно#
| Я хочу… | Читать |
|---|---|
| Развертывание и вызов моей первой функции | Ваша первая краевая функция |
| Вызовите функцию и узнайте, кто звонит | Вызов функции |
| Обработка сбоев, тайм-аутов и повторных попыток | Ошибки, тайм-ауты и повторные попытки |
| Возврат текста, изображения или HTML | Возвращает текст, двоичный код и HTML |
| Дайте функции ключ API | Секреты и переменные среды |
| Запускайте работу в фоновом режиме или по расписанию | Задания, cron и очередь недоставленных сообщений |
| Будьте предупреждены, если что-то пойдет не так | Оповещения |
| Тестируйте локально и развертывайте из CI | Тестирование и развертывание из CI |
| Найти команду | функции ауры и секреты ауры |
| Найти маршрут | Ссылка на HTTP API |
| Найдите метод SDK | JavaScript SDK: функции |
| Знайте размеры, продолжительность и квоты | Лимиты и квоты |
| Поймите, что происходит во время разговора | Как работает вызов |
| Поймите, кто что может сделать | Модель безопасности |
| Перейти на SDK 0.6 | Обновление до SDK 0.6 |
Факты, которые нужно знать в первую очередь#
- Только , вызывающий функцию, работает с открытым ключом. Все остальное требует ключа
service_roleи принадлежит вашему серверу. - Запросы и ответы должны оставаться ниже примерно 256 КиБ. Используйте хранилище для больших данных.
- Каждый вызов не имеет состояния. Не храните данные в памяти между вызовами.
- Секреты — это переменные функции, заданные с помощью
aura secrets setилиPUT /env. Неактивное шифрование применяется только по путиPUTи только в том случае, если у развертывания есть ключ. - То, что пишет функция с помощью
console.log, вам пока недоступно. См. ограничения Limits and quotas для текущих пробелов. - Есть один регион и нет истории версий: храните свои функции в Git.