Ana içeriğe atla

​
Bileşenler

Bileşenler, uygulamanızın çalıştırılabilir parçalarıdır. Her bileşenin nasıl çalıştığını belirleyen bir type özelliği vardır.

​
UI bileşenleri

UI bileşeni, bir web ön ucu — React, Vue, Svelte, düz HTML veya bir port üzerinde çalışan herhangi bir çerçevedir. 
{ name: 'Dashboard', type: 'ui', path: '.', runtime: { dev: 'bun run dev' } }
  • Uygulama başına en fazla 1 — Kazzle, uygulama başına tek bir önizleme URL’si atar
  • runtime.dev — dev sunucusu için komut (“Önizlemeyi başlat” tarafından kullanılır)
  • runtime.run — üretim derlemesini sunmak için komut
runtime.dev ayarlanmamışsa, önizleme sistemi package.json dosyanızdan bun run dev komutunu çalıştırır.

​
İşlem bileşenleri

İşlem bileşeni, bir arka uç hizmeti, worker veya zamanlanmış görevdir. 
{ name: 'API', type: 'process', path: './server/index.ts' }

​
Yaşam döngüsü: processMode

İşlem bileşeninin iki yaşam döngüsünden biri vardır:
  • processMode: 'persistent' (varsayılan) — uzun süreli HTTP sunucusu. Tetikleyiciler, çalışan sunucuya bildirilen path konumuna POST edilir.
  • processMode: 'triggered' — giriş betiği tetikleyici başına oluşturulur ve çıkar. Üretimde boşta makine yok.

​
Tetikleyiciler

Zamanlama ve webhook tetikleyicileri bileşen üzerinde bildirilir. Bir bileşen birçok tetikleyici taşıyabilir. Her tetikleyicinin bir name (bileşen içinde benzersiz) ve bir kind özelliği vardır. 
{
  name: 'events',
  type: 'process',
  path: './components/events/index.ts',
  processMode: 'persistent',
  triggers: [
    { name: 'cleanup', kind: 'schedule', schedule: '0 * * * *', path: '/cron/cleanup' },
    { name: 'stripe',  kind: 'webhook',                          path: '/webhook/stripe' },
  ],
}
path, processMode: 'persistent' için gereklidir. processMode: 'triggered' için atlanır — betik bunun yerine ortamdan TRIGGER_NAME okur. Tam tetikleyici modeli, ortam değişkeni sözleşmesi ve HTTP kimlik doğrulama başlığı için Otomasyonlar bölümüne bakın.

​
Çalışma zamanı komutları

AşamaNe zaman çalışırÖrnek
devTaslak önizlemesi sırasındabun run dev, vite, next dev
runÜretimdebun run start, node dist/server.js
Taslak önizleme paket betikleri, Kazzle’nin yerel portları ve kardeş bileşen URL’lerini enjekte edebilmesi için kazzle run -- <command> komutunu kullanabilir. Üretim işlem bileşenleri, dağıtım bu komutu üretim görüntüsünde çalıştırdığı için runtime.run içinde gerçek komutu bildirmelidir.