메인 콘텐츠로 건너뛰기

​
환경

Kazzle은 앱 프로세스에 소수의 플랫폼 변수를 주입합니다. 자신의 자격증명은 kazzle.config.ts를 통해 Vault에서 가져옵니다.

​
프로세스 변수

변수설명예시
PORT프로세스가 수신 대기할 포트3000
HOST바인딩할 호스트0.0.0.0
KAZZLE_API_URLKazzle 런타임 헬퍼가 사용하는 기본 URLhttps://api.kazzle.app
PORT, HOST, KAZZLE_API_URL은 프로세스 컴포넌트에 설정됩니다. Kazzle은 앱 프로세스에 대해 API 키를 자동으로 생성하지 않습니다. 앱이 실제로 필요할 때만 명시적 자격증명을 추가하세요. 프로세스는 HOST:PORT에 바인딩해야 합니다. Kazzle은 그 위에 미리보기 라우팅 및 프로덕션 도메인을 처리합니다.

​
형제 컴포넌트 URL

앱에 여러 컴포넌트가 있을 때, Kazzle은 한 컴포넌트가 다른 컴포넌트에 접근할 수 있도록 하는 URL을 주입할 수 있습니다:
변수설명
KAZZLE_APP_COMPONENT_{NAME}_URL런타임에 형제 컴포넌트의 URL
이름은 컴포넌트의 name 필드에서 가져옵니다: 대문자로 변환되고, 영숫자가 아닌 문자는 언더스코어가 됩니다. API Server라는 형제는 KAZZLE_APP_COMPONENT_API_SERVER_URL이 됩니다. 이 URL은 배포된 형제가 있을 때는 그것을 가리키고, 없으면 해당 형제 컴포넌트의 현재 개발 주소를 가리킵니다.

​
앱 자격증명

앱 자격증명은 시크릿 컬렉션 + 환경을 통해 컴포넌트에 전달됩니다. Vault에 환경 변수 키로 원하는 이름으로 시크릿을 저장하고(예: KAZZLE_API_KEY), 컴포넌트가 해당 컬렉션 + 환경을 가리키도록 설정하세요: 
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
생성된 앱에서 Kazzle의 /ai/* 엔드포인트를 호출할 때 KAZZLE_API_KEY를 사용하세요. VITE_*를 통해 개인 키를 노출하지 마세요. 이 값들은 브라우저 코드에 번들됩니다.