aura fonksiyonları ve aura sırları
Her aura functions ve aura secrets komutu, seçenekleri, okuduğu dosyalar ve ihtiyaç duyduğu ortamla birlikte.
1. Kurulum
Projenizle konuşan komutların üç şeye ihtiyacı vardır:
| İhtiyaç | Nasıl |
|---|---|
| Bir oturum | aura login, ardından aura link --project-id <uuid>, bu da aurabase.toml yazar |
| Proje URL'si | AURA_PROJECT_URL veya aurabase.toml içinde project_url |
Bir service_role anahtarı | AURA_API_KEY veya AURA_SERVICE_ROLE_KEY, ortamda veya .env dosyasında |
| Değişken | Varsayılan | Rol |
|---|---|---|
AURA_GATEWAY_URL | https://api.aurabase.cloud | login, orgs ve projects tarafından kullanılan Yönetim API'si. Başka bir yığınla çalışırken bunu açıkça ayarlayın: varsayılan, barındırılan buluttur. |
AURA_PROJECT_URL | project_url / aurabase.toml | Projenizin veri düzlemi |
AURA_STUDIO_URL | http://localhost:3000 | Stüdyo aura studio tarafından açıldı |
AURA_GATEWAY_URL olmadan, aura login ve aura projects create https://api.aurabase.cloud ile konuşur. Test etmeden önce kendi yığınınızın URL'sini dışa aktarın.
2. aura fonksiyonları
aura functions new <name> [--runtime deno|wasm]
aurabase/functions/<name>/ oluşturur. Varsayılan çalışma zamanı deno'dir ( index.ts ve deno.json içeren TypeScript şablonu). --runtime wasm ile bir Rust sandığı (Cargo.toml, src/lib.rs) oluşturur. Mevcut bir adı reddediyor.
aura functions serve [name] [--port 54321]
index.ts veya index.js öğesini deno run --allow-net --allow-env --allow-read --watch ile çalıştırır, böylece kaydettiğinizde işlev yeniden başlar. Deno kurulu olması gerekiyor; o olmadan komut, nasıl kurulacağını açıklar. İsimsiz olarak yerel işlevleri listeler.
Sunucu http://127.0.0.1:<port>'yi dinler ve işlev, isteği üretimde olduğu gibi (yöntem, yol, başlıklar, gövde) platform olmadan alır: x-aura-* kimlik başlığı yok, sır yok, sınır yok. PORT ve DENO_SERVE_ADDRESS sizin için ayarlanmıştır, dolayısıyla düz bir Deno.serve(handler) seçilen bağlantı noktasını kullanır.
Bir WASM işlevi yerel olarak sunulamaz: komut, bunun nasıl dağıtılacağını yazdırır.
aura functions deploy <name>
index.ts (veya index.js) okur ve işlevi oluşturarak veya değiştirerek bunu projeye gönderir. Mevcut sırlar saklanır. index.ts veya index.js olmayan bir işlev için, cargo build --target wasm32-unknown-unknown --release komutunu çalıştırır ve derlenmiş ikili dosyayı gönderir.
Bir Deno işlevi, tek bir dosyadır: komut, göreli içe aktarmaları reddeder (./helper.ts, ../lib.ts). Uzaktan içe aktarmaları (npm:<package> veya https://esm.sh/<package>) kullanın veya kodu satır içi olarak kullanın.
aura functions invoke <name> [--data '<json>']
Dağıtılan işlevi çağırır ve yanıt zarfını yazdırır. --data istek gövdesidir. Geçerli olmayan bir JSON --data bir hatadır: {} ile değiştirilmez.
aura functions list [--json]
Yerel işlevleri çalışma zamanlarıyla (Deno / TypeScript veya Rust / WASM) ve bir proje bağlandığında dağıtılanları actif veya inactif ile listeler.
aura functions logs <name> [--limit 50]
İşlev için en son HTTP isteklerini listeler: zaman, yöntem, yol, durum, süre ve istek kimliği. Kodunuzun çıktısını göstermez (console.log). sınırlarına bakın.
aura functions download <name>
Dağıtılan kodu aurabase/functions/<name>/ öğesine yazar: Deno işlevi için index.ts, WASM işlevi için <name>.wasm. WASM işlevinin Rust kaynağı sunucuda depolanmaz.
aura functions delete <name> [--force]
Onaylandıktan sonra dağıtılan işlevi siler. --force (veya -f), komut dosyalarında ihtiyaç duyduğunuz onayı atlar.
3. auranın sırları
| Komut | Etki |
|---|---|
aura secrets list --function <name> [--json] | Anahtarları listeler; değerler maskelenmiştir (sk_l***) |
aura secrets set --function <name> KEY=VALUE … | Anahtarları ekler veya günceller, diğerlerini korur |
aura secrets unset --function <name> KEY … | Anahtarları kaldırır |
--function -f yazılabilir. Bu komutlar değerleri verildiği gibi saklar ve bunları şifrelemez: şifrelenmiş yol için sırlar ve ortam konusuna bakın.