Skip to main content

Kazzle CLI

Gunakan Kazzle CLI untuk menjalankan perintah aplikasi dalam pengembangan dan pratinjau:
Semua yang setelah -- adalah perintah sebenarnya. Kazzle menyuntikkan lingkungan runtime terlebih dahulu. kazzle run hanya untuk pengembangan dan pratinjau. Letakkan di skrip dev, jangan di start. Dalam produksi, runtime yang diterapkan menyuntikkan PORT, HOST, dan rahasia secara langsung, dan perintah produksi adalah perintah biasa (misalnya bun run index.ts). CLI kazzle tidak dipasang di gambar yang diterapkan, jadi perintah produksi yang memanggil kazzle run akan gagal dengan kazzle: command not found.

Apa yang disuntikkan kazzle run

  • rahasia dari entri env komponen di kazzle.config.ts
  • PORT dan HOST
  • URL komponen saudara seperti KAZZLE_APP_COMPONENT_SERVER_URL
  • identitas runtime Kazzle seperti ID aplikasi dan nama komponen

Contoh

dev berjalan melalui kazzle run sehingga Kazzle dapat menyuntikkan port pratinjau dan env runtime. start adalah perintah biasa — produksi menyuntikkan PORT/HOST/rahasia itu sendiri. Jangan letakkan nama koleksi rahasia di package.json. Letakkan di kazzle.config.ts.

Menautkan checkout ke aplikasi

kazzle run perlu tahu aplikasi mana yang dimiliki direktori ini. Urutan resolusi:
  1. --app=<appId> di baris perintah
  2. variabel env KAZZLE_APP_ID (diatur secara otomatis saat Kazzle memulai komponen yang diawasi)
  3. .kazzle/link.json dilacak dari direktori saat ini
Jika tidak ada yang terselesaikan, kazzle run keluar dengan:
app { create: {} } menulis <checkout>/.kazzle/link.json secara otomatis — seperti .vercel/project.json Vercel. File ini per-klon dan diabaikan git. Setelah git clone segar dari aplikasi yang ada, jalankan:
AI dapat memperbaiki tautan yang hilang dari thread dengan app { link: { appId } }.