> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Môi trường

> Các biến nền tảng và URL anh chị em được đưa vào ứng dụng của bạn.

# Môi trường

Kazzle đưa một tập hợp nhỏ các biến nền tảng vào các quy trình ứng dụng. Thông tin xác thực của bạn đến từ vault thông qua `kazzle.config.ts`.

## Biến quy trình

| Biến             | Mô tả                                                  | Ví dụ                    |
| ---------------- | ------------------------------------------------------ | ------------------------ |
| `PORT`           | Cổng mà quy trình của bạn nên lắng nghe                | `3000`                   |
| `HOST`           | Host để liên kết                                       | `0.0.0.0`                |
| `KAZZLE_API_URL` | URL cơ sở được sử dụng bởi trình hỗ trợ runtime Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` và `KAZZLE_API_URL` được đặt cho các thành phần quy trình. Kazzle không tự động tạo khóa API cho các quy trình ứng dụng; chỉ thêm thông tin xác thực rõ ràng khi ứng dụng của bạn thực sự cần chúng.

Quy trình của bạn nên liên kết với `HOST:PORT`. Kazzle xử lý định tuyến xem trước và miền sản xuất trên đó.

## URL thành phần anh chị em

Khi một ứng dụng có nhiều thành phần, Kazzle có thể đưa vào các URL cho phép một thành phần tiếp cận thành phần khác:

| Biến                              | Mô tả                                         |
| --------------------------------- | --------------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL cho một thành phần anh chị em tại runtime |

Tên đến từ trường `name` của thành phần: viết hoa, các ký tự không phải chữ và số trở thành dấu gạch dưới. Một thành phần có tên `API Server` trở thành `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Các URL này trỏ đến thành phần anh chị em được triển khai khi tồn tại. Nếu không, chúng trỏ đến địa chỉ phát triển hiện tại cho thành phần anh chị em đó.

## Thông tin xác thực ứng dụng

Thông tin xác thực ứng dụng đến một thành phần thông qua bộ sưu tập bí mật + môi trường. Lưu trữ bí mật trong vault với tên bạn muốn làm khóa biến môi trường (ví dụ `KAZZLE_API_KEY`), sau đó trỏ thành phần đến bộ sưu tập + môi trường đó:

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

Sử dụng `KAZZLE_API_KEY` cho các lệnh gọi đến các điểm cuối `/ai/*` của Kazzle từ một ứng dụng được tạo. Không bao giờ để lộ khóa riêng tư thông qua `VITE_*`; những giá trị đó được đóng gói vào mã trình duyệt.