> ## 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.

# Środowisko

> Zmienne platformy i adresy URL komponentów równorzędnych wstrzykiwane do aplikacji.

# Środowisko

Kazzle wstrzykuje mały zestaw zmiennych platformy do procesów aplikacji. Twoje własne poświadczenia pochodzą z magazynu przez `kazzle.config.ts`.

## Zmienne procesu

| Zmienna          | Opis                                                                             | Przykład                 |
| ---------------- | -------------------------------------------------------------------------------- | ------------------------ |
| `PORT`           | Port, na którym powinien nasłuchiwać proces                                      | `3000`                   |
| `HOST`           | Host do powiązania                                                               | `0.0.0.0`                |
| `KAZZLE_API_URL` | Podstawowy adres URL używany przez pomocników środowiska uruchomieniowego Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` i `KAZZLE_API_URL` są ustawiane dla komponentów procesów. Kazzle nie tworzy automatycznie kluczy API dla procesów aplikacji; dodaj jawne poświadczenia tylko wtedy, gdy aplikacja ich rzeczywiście potrzebuje.

Proces powinien powiązać się z `HOST:PORT`. Kazzle obsługuje routing podglądu i domeny produkcyjne na tym poziomie.

## Adresy URL komponentów równorzędnych

Gdy aplikacja ma wiele komponentów, Kazzle może wstrzykiwać adresy URL, które pozwalają jednemu komponentowi dotrzeć do innego:

| Zmienna                           | Opis                                                    |
| --------------------------------- | ------------------------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | Adres URL komponentu równorzędnego w czasie wykonywania |

Nazwa pochodzi z pola `name` komponentu: wielkie litery, znaki niealfanumeryczne stają się podkreśleniami. Komponent o nazwie `API Server` staje się `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Te adresy URL wskazują na wdrożony komponent równorzędny, jeśli istnieje. W przeciwnym razie wskazują na bieżący adres programistyczny tego komponentu równorzędnego.

## Poświadczenia aplikacji

Poświadczenia aplikacji docierają do komponentu przez kolekcję sekretów + środowisko. Przechowuj sekret w magazynie z nazwą, którą chcesz jako klucz zmiennej środowiskowej (na przykład `KAZZLE_API_KEY`), a następnie wskaż komponent na tę kolekcję + środowisko:

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

Użyj `KAZZLE_API_KEY` dla wywołań punktów końcowych `/ai/*` Kazzle z wygenerowanej aplikacji. Nigdy nie ujawniaj kluczy prywatnych przez `VITE_*`; te wartości są wbudowane w kod przeglądarki.