Функции ауры и секреты ауры
Каждая команда aura functions и aura secrets с ее параметрами, файлами, которые она читает, и необходимой ей средой.
1. Настройка
Командам, которые взаимодействуют с вашим проектом, нужны три вещи:
| Нуждаться | Как |
|---|---|
| Сеанс | aura login, затем aura link --project-id <uuid>, который записывает aurabase.toml |
| URL-адрес проекта | AURA_PROJECT_URL или project_url в aurabase.toml |
Ключ service_role | AURA_API_KEY или AURA_SERVICE_ROLE_KEY в среде или в файле .env |
| Переменная | По умолчанию | Роль |
|---|---|---|
AURA_GATEWAY_URL | https://api.aurabase.cloud | API управления, используемый login, orgs и projects. Установите его явно, когда вы работаете с другим стеком.: по умолчанию используется размещенное облако. |
AURA_PROJECT_URL | project_url из aurabase.toml | Плоскость данных вашего проекта |
AURA_STUDIO_URL | http://localhost:3000 | Студия открыта aura studio |
Без AURA_GATEWAY_URL``aura login и aura projects create общаются с https://api.aurabase.cloud. Экспортируйте URL-адрес своего собственного стека, прежде чем тестировать его.
2. функции ауры
aura functions new <name> [--runtime deno|wasm]
Создает aurabase/functions/<name>/. Средой выполнения по умолчанию является deno (шаблон TypeScript с index.ts и deno.json). С помощью --runtime wasm создается ящик Rust (Cargo.toml, src/lib.rs). Он отказывается от существующего имени.
aura functions serve [name] [--port 54321]
Запускает index.ts или index.js с deno run --allow-net --allow-env --allow-read --watch, поэтому функция перезапускается при сохранении. Требуется установка Deno; без него команда объясняет, как его установить. Без имени он перечисляет локальные функции.
Сервер прослушивает http://127.0.0.1:<port>, и функция получает запрос так же, как и в рабочей среде (метод, путь, заголовки, тело), без. Платформа: никаких идентификационных заголовков x-aura-*, никаких секретов и ограничений. PORT и DENO_SERVE_ADDRESS установлены для вас, поэтому простой Deno.serve(handler) использует выбранный порт.
Функцию WASM нельзя обслуживать локально: команда выводит информацию о том, как ее развернуть.
aura functions deploy <name>
Считывает index.ts (или index.js) и отправляет его в проект, создавая или заменяя функцию. Существующие секреты сохраняются. Для функции без index.ts или index.js она запускает cargo build --target wasm32-unknown-unknown --release и отправляет скомпилированный двоичный файл.
Функция Deno представляет собой отдельный файл : команда отказывается от относительного импорта (./helper.ts, ../lib.ts). Используйте удаленный импорт (npm:<package> или https://esm.sh/<package>) или встройте код.
aura functions invoke <name> [--data '<json>']
Вызывает развернутую функцию и печатает конверт ответа. --data — тело запроса. Недопустимый JSON --data является ошибкой: он не заменяется на {}.
aura functions list [--json]
Перечисляет локальные функции с указанием их среды выполнения (Deno / TypeScript или Rust / WASM) и, если проект связан, развернутые с actif или inactif.
aura functions logs <name> [--limit 50]
Перечисляет последние HTTP-запросы для функции: время, метод, путь, статус, продолжительность и идентификатор запроса. , а не, показывает вывод вашего кода (console.log). См. ограничения .
aura functions download <name>
Записывает развернутый код в aurabase/functions/<name>/: index.ts для функции Deno, <name>.wasm для функции WASM. Исходный код Rust функции WASM не хранится на сервере.
aura functions delete <name> [--force]
Удаляет развернутую функцию после подтверждения. --force (или -f) пропускает подтверждение, необходимое в скриптах.
3. секреты ауры
| Команда | Эффект |
|---|---|
aura secrets list --function <name> [--json] | Перечисляет ключи; значения маскированы (sk_l***) |
aura secrets set --function <name> KEY=VALUE … | Добавляет или обновляет ключи, остальные сохраняет. |
aura secrets unset --function <name> KEY … | Удаляет ключи |
--function можно записать -f. Эти команды сохраняют значения в заданном виде и не шифруют их: см. секреты и среду для зашифрованного пути.