मुख्य सामग्री पर जाएं

Kazzle CLI

विकास और पूर्वावलोकन में ऐप कमांड चलाने के लिए Kazzle CLI का उपयोग करें:
kazzle run -- <command>
-- के बाद सब कुछ वास्तविक कमांड है। Kazzle पहले रनटाइम वातावरण इंजेक्ट करता है। kazzle run केवल विकास और पूर्वावलोकन के लिए है। यह dev स्क्रिप्ट में जाता है, कभी start में नहीं। उत्पादन में, तैनात रनटाइम PORT, HOST, और गोपनीयता सीधे इंजेक्ट करता है, और उत्पादन कमांड नंगी कमांड है (जैसे bun run index.ts)। kazzle CLI तैनात इमेज में स्थापित नहीं है, इसलिए एक उत्पादन कमांड जो kazzle run को कॉल करती है kazzle: command not found के साथ क्रैश हो जाती है।

kazzle run क्या इंजेक्ट करता है

  • kazzle.config.ts में घटक की env प्रविष्टि से गोपनीयता
  • PORT और HOST
  • भाई घटक URL जैसे KAZZLE_APP_COMPONENT_SERVER_URL
  • Kazzle रनटाइम पहचान जैसे ऐप ID और घटक नाम

उदाहरण

{
  "scripts": {
    "dev": "kazzle run -- bun --watch server/index.ts",
    "start": "bun server/index.ts"
  }
}
dev kazzle run के माध्यम से चलता है ताकि Kazzle पूर्वावलोकन पोर्ट और रनटाइम env इंजेक्ट कर सके। start नंगी कमांड है — उत्पादन PORT/HOST/गोपनीयता को स्वयं इंजेक्ट करता है। package.json में गोपनीयता संग्रह नाम न रखें। उन्हें kazzle.config.ts में रखें।
components: [
  {
    name: 'server',
    type: 'process',
    path: './server/index.ts',
    env: { collection: 'my-app', environment: 'local' },
  },
]

एक चेकआउट को एक ऐप से जोड़ना

kazzle run को जानना होगा कि यह निर्देशिका किस ऐप से संबंधित है। समाधान क्रम:
  1. कमांड लाइन पर --app=<appId>
  2. KAZZLE_APP_ID env वेरिएबल (जब Kazzle एक निरीक्षित घटक शुरू करता है तो स्वचालित रूप से सेट)
  3. वर्तमान निर्देशिका से ऊपर की ओर चलने वाली .kazzle/link.json
यदि इनमें से कोई भी समाधान नहीं होता है, तो kazzle run इसके साथ बाहर निकलता है:
Error: This directory is not linked to a Kazzle app. Run `kazzle link` to fix.
app { action: "create" } स्वचालित रूप से <checkout>/.kazzle/link.json लिखता है — Vercel के .vercel/project.json की तरह। फ़ाइल प्रति-क्लोन है और gitignored है। एक मौजूदा ऐप के ताज़े git clone के बाद, चलाएँ:
kazzle link              # वर्तमान निर्देशिका को अपने Space के ऐप चेकआउट के विरुद्ध मिलाएँ
kazzle link --app=<id>   # एक विशिष्ट ऐप को बाध्य करें
kazzle unlink            # लिंक फ़ाइल हटाएँ
AI एक thread से app { action: "link", appId } के साथ एक लापता लिंक की मरम्मत कर सकता है।