Az Azure Static Web Apps parancssori felületének konfigurálása

Az Azure Static Web Apps (SWA) parancssori felülete kétféleképpen kapja meg a statikus webalkalmazás konfigurációs adatait:

• Parancssori felület beállításai (futásidőben átadva)
• Egy swa-cli.config.json nevű parancssori felület konfigurációs fájlja

Feljegyzés

Alapértelmezés szerint az SWA CLI egy swa-cli.config.json nevű konfigurációs fájlt keres az aktuális könyvtárban.

A konfigurációs fájl több konfigurációt is tartalmazhat, amelyek mindegyike egyedi konfigurációs névvel van azonosítva.

• Ha csak egyetlen konfiguráció található a swa-cli.config.json fájlban, swa start alapértelmezés szerint használja.

• Ha a beállítások egy konfigurációs fájlból töltődnek be, a parancssori beállítások figyelmen kívül lesznek hagyva.

Példa konfigurációs fájlra

Az alábbi kódrészlet a konfigurációs fájl alakját mutatja.

{
  "configurations": {
    "app": {
      "appDevserverUrl": "http://localhost:3000",
      "apiLocation": "api",
      "run": "npm run start",
      "swaConfigLocation": "./my-app-source"
    }
  }
}

Ha csak egy konfigurációs szakaszsal rendelkezik, ahogyan az ebben a példában látható, a parancs automatikusan ezeket az swa start értékeket használja.

Konfigurációs fájl inicializálása

A konfigurációs fájlt inicializálhatja a swa init paranccsal. Ha egy meglévő projekten futtatja a parancsot, próbálja swa init kitalálni a konfigurációs beállításokat.

A folyamat alapértelmezés szerint ezeket a beállításokat a projekt aktuális munkakönyvtárában lévő swa-cli.config.json hozza létre. Ez a könyvtár a projektkonfigurációs értékek keresésekor használt swa alapértelmezett fájlnév és hely.

swa --config <PATH>

Ha a fájl csak egy elnevezett konfigurációt tartalmaz, akkor a rendszer alapértelmezés szerint ezt a konfigurációt használja. Ha több konfiguráció van definiálva, akkor lehetőségként adja meg a kívánt konfigurációnevet.

swa --<CONFIG_NAME>

A konfigurációs fájl beállítás használatakor a beállítások JSON formátumban lesznek tárolva. A létrehozás után manuálisan szerkesztheti a fájlt a beállítások frissítéséhez, vagy használhatja swa init a frissítéseket.

Konfiguráció megtekintése

A Static Webs CLI lehetőséget biztosít --print-config , hogy áttekinthesse az aktuális konfigurációt.

Íme egy példa arra, hogyan néz ki ez a kimenet egy új, alapértelmezett beállításokkal rendelkező projekten való futtatáskor.

swa --print-config

Options:
 - port: 4280
 - host: localhost
 - apiPort: 7071
 - appLocation: .
 - apiLocation: <undefined>
 - outputLocation: .
 - swaConfigLocation: <undefined>
 - ssl: false
 - sslCert: <undefined>
 - sslKey: <undefined>
 - appBuildCommand: <undefined>
 - apiBuildCommand: <undefined>
 - run: <undefined>
 - verbose: log
 - serverTimeout: 60
 - open: false
 - githubActionWorkflowLocation: <undefined>
 - env: preview
 - appName: <undefined>
 - dryRun: false
 - subscriptionId: <undefined>
 - resourceGroupName: <undefined>
 - tenantId: <undefined>
 - clientId: <undefined>
 - clientSecret: <undefined>
 - useKeychain: true
 - clearCredentials: false
 - config: swa-cli.config.json
 - printConfig: true

A futtatás swa --print-config az aktuális konfiguráció alapértelmezett értéke.

Feljegyzés

Ha a projekt még nem definiált konfigurációs fájlt, ez automatikusan elindítja a swa init munkafolyamatot, hogy segítsen létrehozni egyet.

Konfiguráció ellenőrzése

A swa-cli.config.json fájlt a következő sémán ellenőrizheti:https://aka.ms/azure/static-web-apps-cli/schema