Langsung ke konten utama

​
Kazzle CLI

Gunakan Kazzle CLI untuk menjalankan perintah aplikasi dalam pengembangan dan pratinjau: 
kazzle run -- <command>
Semua yang setelah -- adalah perintah sebenarnya. Kazzle menyuntikkan lingkungan runtime terlebih dahulu. kazzle run hanya untuk pengembangan dan pratinjau. Ini milik skrip dev, tidak pernah di start. Dalam produksi, runtime yang digunakan menyuntikkan PORT, HOST, dan rahasia secara langsung, dan perintah produksi adalah perintah biasa (misalnya bun run index.ts). CLI kazzle tidak dipasang dalam citra yang digunakan, jadi perintah produksi yang memanggil kazzle run mogok 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

{
  "scripts": {
    "dev": "kazzle run -- bun --watch server/index.ts",
    "start": "bun server/index.ts"
  }
}
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 masukkan nama koleksi rahasia di package.json. Masukkan di kazzle.config.ts. 
components: [
  {
    name: 'server',
    type: 'process',
    path: './server/index.ts',
    env: { collection: 'my-app', environment: 'local' },
  },
]

​
Menautkan checkout ke aplikasi

kazzle run perlu tahu aplikasi mana yang dimiliki direktori ini. Urutan resolusi:
  1. --app=<appId> pada baris perintah
  2. variabel env KAZZLE_APP_ID (diatur secara otomatis saat Kazzle memulai komponen yang diawasi)
  3. .kazzle/link.json berjalan naik dari direktori saat ini
Jika tidak ada yang terselesaikan, kazzle run keluar dengan: 
Error: This directory is not linked to a Kazzle app. Run `kazzle link` to fix.
app { action: "create" } menulis <checkout>/.kazzle/link.json secara otomatis — seperti .vercel/project.json Vercel. File ini per-klon dan gitignored. Setelah git clone segar dari aplikasi yang ada, jalankan: 
kazzle link              # cocokkan direktori saat ini dengan checkout aplikasi space Anda
kazzle link --app=<id>   # paksa aplikasi tertentu
kazzle unlink            # hapus file tautan
AI dapat memperbaiki tautan yang hilang dari thread dengan app { action: "link", appId }.