Bereitstellen einer statischen Web-App mithilfe der CLI von Azure Static Web Apps

Artikel
02/08/2024

Die Azure Static Web-Apps CLI (SWA CLI) bietet den deploy Befehl zum Bereitstellen des aktuellen Projekts in Azure Static Web-Apps.

Zu den allgemeinen Bereitstellungsszenarien gehören:

Eine Front-End-App ohne API
Eine Front-End-App mit einer API
Blazor-Apps

Bereitstellungstoken

Die SWA CLI unterstützt die Bereitstellung mithilfe eines Bereitstellungstokens, um Setups in CI/CD-Umgebungen zu ermöglichen.

Sie können ein Bereitstellungstoken von:

Azure-Portal: Home → Static Web App → Ihrer Instanz → Übersicht → Verwalten des Bereitstellungstokens

Azure CLI: Verwenden des secrets list Befehls:

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

Azure Static Web-Apps CLI: Verwenden des deploy Befehls:
```
swa deploy --print-token
```

Sie können dann den Tokenwert mit der oder Sie können eine Umgebungsvariable erstellen, die --deployment-token <TOKEN> aufgerufen SWA_CLI_DEPLOYMENT_TOKEN wird, und sie auf das Bereitstellungstoken festlegen.

Wichtig

Speichern Sie Keine Bereitstellungstoken in einem öffentliches Repository.

Bereitstellen einer Front-End-App ohne API

Sie können eine Front-End-Anwendung ohne API in Azure Static Web-Apps bereitstellen. Wenn Für Ihre Front-End-Anwendung ein Buildschritt erforderlich ist, führen swa build Sie die Anweisungen zum Erstellen ihrer Anwendung aus, oder verweisen Sie darauf.

Wählen Sie die Option aus, die Ihren Anforderungen am besten entspricht, um Ihre Bereitstellung zu konfigurieren.

Option 1: Führen Sie im Buildordner, den Sie bereitstellen möchten, den Befehl "Bereitstellen" aus:
```
cd build/
swa deploy
```
Hinweis

Der Buildordner muss den statischen Inhalt Ihrer App enthalten, der bereitgestellt werden soll.
Option 2: Sie können auch einen bestimmten Ordner bereitstellen:
1. Wenn Für Ihre Front-End-Anwendung ein Buildschritt erforderlich ist, führen swa build Sie die Anweisungen zum Erstellen ihrer Anwendung aus, oder verweisen Sie darauf.
2. Stellen Sie Ihre App bereit:
```
swa deploy ./my-dist
```

Bereitstellen einer Front-End-App mit einer API

Führen Sie die folgenden Schritte aus, um eine Anwendung mit API-Endpunkten bereitzustellen.

Wenn Für Ihre Front-End-Anwendung ein Buildschritt erforderlich ist, führen swa build Sie die Anweisungen zum Erstellen ihrer Anwendung aus, oder verweisen Sie darauf.
Stellen Sie sicher, dass die API-Sprachlaufzeitversion in der datei staticwebapp.config.json ordnungsgemäß festgelegt ist, z. B.:
```
{
  "platform": {
    "apiRuntime": "node:16"
  }
}
```
Hinweis

Wenn Ihr Projekt nicht über die staticwebapp.config.json Datei verfügt, fügen Sie eine unter Ihrem outputLocation Ordner hinzu.

Stellen Sie Ihre App bereit:

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

Bereitstellen einer Blazor-App

Sie können eine Blazor-App mithilfe der folgenden Schritte bereitstellen.

Erstellen Sie Ihre Blazor-App im Releasemodus :
```
dotnet publish -c Release -o bin/publish
```
Führen Sie im Stammverzeichnis Des Projekts den Befehl "Bereitstellen" aus:
```
swa deploy ./bin/publish/wwwroot --api-location ./Api
```

Bereitstellen mithilfe einer Konfigurationsdatei

Hinweis

Der Pfad muss outputLocation relativ zum appLocation.

Wenn Sie eine swa-cli.config.json Konfigurationsdatei in Ihrem Projekt mit einem einzigen Konfigurationseintrag verwenden, können Sie Ihre Anwendung bereitstellen, indem Sie die folgenden Schritte ausführen.

Als Referenz sieht ein Beispiel für einen einzelnen Konfigurationseintrag wie der folgende Codeausschnitt aus.

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

Wenn Für Ihre Front-End-Anwendung ein Buildschritt erforderlich ist, führen swa build Sie die Anweisungen zum Erstellen ihrer Anwendung aus, oder verweisen Sie darauf.
Stellen Sie Ihre App bereit.

swa deploy

Wenn Sie über mehrere Konfigurationseinträge verfügen, können Sie die Eintrags-ID angeben, die sie verwenden soll:

swa deploy my-otherapp

Optionen

Die folgenden Optionen können Sie verwenden swa deploy:

-a, --app-location <path>: der Ordner, der den Quellcode der Front-End-Anwendung enthält (Standard: ".")
-i, --api-location <path>: der Ordner mit dem Quellcode der API-Anwendung
-O, --output-location <path>: der Ordner, der die integrierte Quelle der Front-End-Anwendung enthält. Der Pfad ist relativ zu --app-location (Standard: ".")
-w, --swa-config-location <swaConfigLocation>: das Verzeichnis, in dem sich die datei staticwebapp.config.json befindet
-d, --deployment-token <secret>: das geheime Token, das für die Authentifizierung mit dem statischen Web-Apps verwendet wird
-dr, --dry-run: Simulieren eines Bereitstellungsprozesses, ohne ihn tatsächlich auszuführen (Standard: false)
-pt, --print-token: Drucken des Bereitstellungstokens (Standard: false)
--env [environment]: Der Typ der Bereitstellungsumgebung, in der das Projekt bereitgestellt werden soll (Standard: "preview")
-S, --subscription-id <subscriptionId>: Azure-Abonnement-ID, die von diesem Projekt verwendet wird (Standard: process.env.AZURE_SUBSCRIPTION_ID)
-R, --resource-group <resourceGroupName>: Von diesem Projekt verwendete Azure-Ressourcengruppe
-T, --tenant-id <tenantId>: Azure-Mandanten-ID (Standard: process.env.AZURE_TENANT_ID)
-C, --client-id <clientId>: Azure-Client-ID
-CS, --client-secret <clientSecret>: Geheimer Azure-Clientschlüssel
-n, --app-name <appName>: Name der Azure Static Web App-Anwendung
-cc, --clear-credentials: Löschen beibehaltener Anmeldeinformationen vor der Anmeldung (Standard: false)
-u, --use-keychain: Aktivieren der Verwendung des systemeigenen Betriebssystemschlüsselbunds für persistente Anmeldeinformationen (Standard: true)
-nu, --no-use-keychain: Deaktivieren der Verwendung des systemeigenen Schlüsselbundes des Betriebssystems
-h, --help: Anzeigen der Hilfe zum Befehl

Verbrauch

Bereitstellen mithilfe eines Bereitstellungstokens.

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

Bereitstellen mithilfe eines Bereitstellungstokens aus den Umgebungsvariablen.

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

Bereitstellen mit swa-cli.config.json Datei

swa deploy
swa deploy myconfig

Drucken sie das Bereitstellungstoken.

swa deploy --print-token

Bereitstellen in einer bestimmten Umgebung.

swa deploy --env production

Nächste Schritte

Konfigurieren Der Bereitstellung

Share via