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

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.

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.

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

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

1. Hozza létre a Blazor-alkalmazást kiadási módban:

   dotnet publish -c Release -o bin/publish
   

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

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"
      }
    }
  }
}

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

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