Statikus webalkalmazás üzembe helyezése az Azure Static Web Apps parancssori felületével

Cikk
02/12/2024

Az Azure Static Web Apps CLI (SWA CLI) az deploy aktuális projekt Azure Static Web Appsben való üzembe helyezésére vonatkozó parancsot tartalmazza.

Gyakori üzembehelyezési forgatókönyvek a következők:

API nélküli előtér-alkalmazás
Előtérbeli alkalmazás API-val
Blazor-alkalmazások

Üzembehelyezési jogkivonat

Az SWA CLI támogatja az üzembe helyezést egy üzembehelyezési jogkivonat használatával a CI/CD-környezetek beállításainak engedélyezéséhez.

Az üzembehelyezési jogkivonatot a következő forrásból szerezheti be:

Azure Portal: Kezdőlap → Statikus webalkalmazás → A példány → áttekintése → Üzembehelyezési jogkivonat kezelése

Azure CLI: A parancs használata secrets list :

az staticwebapp secrets list --name <APPLICATION_NAME> --query "properties.apiKey"

Azure Static Web Apps CLI: A deploy parancs használata:
```
swa deploy --print-token
```

Ezután használhatja a jogkivonat értékét, --deployment-token <TOKEN> vagy létrehozhat egy környezeti változót, amelyet meghívhat SWA_CLI_DEPLOYMENT_TOKEN , és beállíthatja az üzembehelyezési jogkivonatra.

Fontos

Ne tárolja az üzembehelyezési jogkivonatokat nyilvános adattárban.

Előtérbeli alkalmazás üzembe helyezése API nélkül

Api nélkül is üzembe helyezhet egy előtérbeli alkalmazást az Azure Static Web Appsben. Ha az előtérbeli alkalmazás buildelési lépésre van szüksége, futtassa swa build vagy tekintse meg az alkalmazás buildelési utasításait.

Válassza ki az igényeinek leginkább megfelelő beállítást az üzembe helyezés konfigurálásához

1. lehetőség: Az üzembe helyezni kívánt buildmappából futtassa az üzembe helyezési parancsot:
```
cd build/
swa deploy
```
Feljegyzés

A buildmappának tartalmaznia kell az alkalmazás üzembe helyezendő statikus tartalmát.
2. lehetőség: Egy adott mappát is üzembe helyezhet:
1. Ha az előtérbeli alkalmazás buildelési lépésre van szüksége, futtassa swa build vagy tekintse meg az alkalmazás buildelési utasításait.
2. Az alkalmazás üzembe helyezése:
```
swa deploy ./my-dist
```

Előtérbeli alkalmazás üzembe helyezése API-val

Az alábbi lépésekkel üzembe helyezhet egy API-végpontokkal rendelkező alkalmazást.

Ha az előtérbeli alkalmazás buildelési lépésre van szüksége, futtassa swa build vagy tekintse meg az alkalmazás buildelési utasításait.
Győződjön meg arról, hogy az API nyelvi futtatókörnyezetének verziója helyesen van beállítva a staticwebapp.config.json fájlban, például:
```
{
  "platform": {
    "apiRuntime": "node:16"
  }
}
```
Feljegyzés

Ha a projekt nem rendelkezik a staticwebapp.config.json fájllal, vegyen fel egyet a outputLocation mappájába.

Az alkalmazás üzembe helyezése:

swa deploy ./my-dist --api-location ./api

Blazor-alkalmazás üzembe helyezése

A Blazor-alkalmazásokat az alábbi lépésekkel helyezheti üzembe.

Hozza létre a Blazor-alkalmazást kiadási módban:
```
dotnet publish -c Release -o bin/publish
```
A projekt gyökeréből futtassa az üzembe helyezési parancsot:
```
swa deploy ./bin/publish/wwwroot --api-location ./Api
```

Üzembe helyezés konfigurációs fájl használatával

Feljegyzés

A elérési útnak outputLocation a appLocation.

Ha egyetlen swa-cli.config.json konfigurációs bejegyzéssel rendelkező konfigurációs fájlt használ a projektben, az alábbi lépések végrehajtásával telepítheti az alkalmazást.

Hivatkozásként egy példa egyetlen konfigurációs bejegyzésre az alábbi kódrészlethez hasonlóan néz ki.

{
  "configurations": {
    "my-app": {
      "appLocation": "./",
      "apiLocation": "api",
      "outputLocation": "frontend",
      "start": {
        "outputLocation": "frontend"
      },
      "deploy": {
        "outputLocation": "frontend"
      }
    }
  }
}

Ha az előtérbeli alkalmazás buildelési lépésre van szüksége, futtassa swa build vagy tekintse meg az alkalmazás buildelési utasításait.
Az alkalmazás üzembe helyezése.

swa deploy

Ha több konfigurációs bejegyzéssel rendelkezik, megadhatja a bejegyzés azonosítóját, és megadhatja, hogy melyiket használja:

swa deploy my-otherapp

Beállítások

Az alábbiakban a következő lehetőségeket használhatja swa deploy:

-a, --app-location <path>: az előtérbeli alkalmazás forráskódját tartalmazó mappa (alapértelmezett: ".")
-i, --api-location <path>: az API-alkalmazás forráskódját tartalmazó mappa
-O, --output-location <path>: az előtérbeli alkalmazás beépített forrását tartalmazó mappa. Az elérési út relatív --app-location (alapértelmezett: ".")
-w, --swa-config-location <swaConfigLocation>: az a könyvtár, ahol a staticwebapp.config.json fájl található
-d, --deployment-token <secret>: a statikus webalkalmazásokkal való hitelesítéshez használt titkos jogkivonat
-dr, --dry-run: üzembe helyezési folyamat szimulálása anélkül, hogy ténylegesen futtatta volna (alapértelmezett: false)
-pt, --print-token: az üzembehelyezési jogkivonat nyomtatása (alapértelmezett: false)
--env [environment]: az üzembehelyezési környezet típusa, ahol a projektet üzembe kell helyezni (alapértelmezett: "preview")
-S, --subscription-id <subscriptionId>: A projekt által használt Azure-előfizetés azonosítója (alapértelmezett: process.env.AZURE_SUBSCRIPTION_ID)
-R, --resource-group <resourceGroupName>: A projekt által használt Azure-erőforráscsoport
-T, --tenant-id <tenantId>: Azure-bérlőazonosító (alapértelmezett: process.env.AZURE_TENANT_ID)
-C, --client-id <clientId>: Azure-ügyfélazonosító
-CS, --client-secret <clientSecret>: Azure-ügyfél titkos kódja
-n, --app-name <appName>: Azure Static Web App-alkalmazás neve
-cc, --clear-credentials: a megőrzött hitelesítő adatok törlése bejelentkezés előtt (alapértelmezett: false)
-u, --use-keychain: engedélyezze az operációs rendszer natív kulcskarika használatát az állandó hitelesítő adatokhoz (alapértelmezett: true)
-nu, --no-use-keychain: tiltsa le az operációs rendszer natív kulcskarika használatát
-h, --help: a parancs súgójának megjelenítése

Használat

Üzembe helyezés üzembe helyezési jogkivonat használatával.

swa deploy ./dist/ --api-location ./api/ --deployment-token <TOKEN>

Üzembe helyezés a környezeti változókból származó üzembehelyezési jogkivonat használatával.

SWA_CLI_DEPLOYMENT_TOKEN=123 swa deploy ./dist/ --api-location ./api/

Üzembe helyezés fájl használatával swa-cli.config.json

swa deploy
swa deploy myconfig

Az üzembehelyezési jogkivonat nyomtatása.

swa deploy --print-token

Üzembe helyezés egy adott környezetben.

swa deploy --env production

Következő lépések

Az üzembe helyezés konfigurálása

Megosztás a következőn keresztül: