AzureStaticWebApp@0 – Bereitstellen der Aufgabe Azure Static Web App v0

Diese Aufgabe erstellt und stellt eine Azure Static Web App bereit.

Syntax

# Deploy Azure Static Web App v0
# Build and deploy an Azure Static Web App.
- task: AzureStaticWebApp@0
  inputs:
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd | rootDirectory. Working directory. Default: $(System.DefaultWorkingDirectory).
    #app_location: # string. App location. 
    #app_build_command: # string. App build command. 
    #output_location: # string. Output location. 
    #api_location: # string. Api location. 
    #api_build_command: # string. Api build command. 
    #routes_location: # string. Routes location. 
    #config_file_location: # string. Config file location. 
    #skip_app_build: # boolean. Skip app build. 
    #skip_api_build: # boolean. Skip api build. 
    #is_static_export: # boolean. Set static export. 
    #verbose: # boolean. Verbose. 
    #build_timeout_in_minutes: # string. Build timeout in minutes. 
    #azure_static_web_apps_api_token: # string. Azure Static Web Apps api token. 
    #deployment_environment: # string. Deployment Environment. 
    #production_branch: # string. Production Branch. 
    #data_api_location: # string. Data api location.

Eingänge

workingDirectory - Arbeitsverzeichnis
Eingabealias: cwd | rootDirectory. string. Standardwert: $(System.DefaultWorkingDirectory).

Gibt das absolute Arbeitsverzeichnis an, in dem diese Aufgabe ausgeführt werden soll. Wenn sie leer gelassen wird, wird das Standardarbeitsverzeichnis verwendet.

app_location - App-Speicherort
string.

Der Verzeichnisspeicherort des Anwendungsquellcodes relativ zum Arbeitsverzeichnis. Bei Verwendung mit skip_app_build: trueist dieser Wert der Buildausgabespeicherort der App.

app_build_command - App-Buildbefehl
string.

Der benutzerdefinierte Befehl zum Ausführen von Oryx beim Erstellen von Anwendungsquellcode.

output_location - Ausgabespeicherort
string.

Der Verzeichnisspeicherort des kompilierten Anwendungscodes nach Abschluss der Erstellung relativ zum Arbeitsverzeichnis. Legen Sie diese leere Zeichenfolge ('') fest, wenn sie den automatischen Build umgehen und nur bereitstellen erforderlich ist.

api_location - -API-Speicherort
string.

Der Verzeichnisspeicherort des Azure Functions-Quellcodes relativ zum Arbeitsverzeichnis.

api_build_command - API-Buildbefehl
string.

Der benutzerdefinierte Befehl zum Ausführen von Oryx beim Erstellen von Azure Functions-Quellcode.

standort routes_location - Routes
string.

Der Verzeichnisspeicherort der datei routes.json relativ zum Arbeitsverzeichnis.
Hinweis: Routes.json ist veraltet. Verwenden Sie staticwebapp.config.json.

config_file_location - Konfigurationsdateispeicherort
string.

Der Verzeichnisspeicherort der datei staticwebapp.config.json relativ zum Arbeitsverzeichnis.

skip_app_build - App-Build- überspringen
boolean.

Überspringt den Oryx-Build für den App-Ordner.

skip_api_build - Api-Build- überspringen
boolean.

Überspringt den Oryx-Build für den API-Ordner.

is_static_export - Statische Export- festlegen
boolean.

Legen Sie dieses Kennzeichen auf true fest, wenn Ihre Anwendung so konfiguriert ist, dass sie in statischen HTML-Code exportiert wird, z. B. bei Verwendung von next export.

Wenn dieses Kennzeichen auf true festgelegt ist

verbose - ausführliche
boolean.

Aktiviert ausführliche Protokollierung.

build_timeout_in_minutes - Buildtimeout in Minuten
string.

Gibt das Zeitlimit des Oryx-App-Ordnerbuilds in Minuten an.

azure_static_web_apps_api_token - Azure Static Web Apps-API-Token
string.

Gibt das API-Token für die Bereitstellung an.
Hinweis: Nicht erforderlich, wenn sie als Umgebungsvariable übergeben wird.

deployment_environment - Bereitstellungsumgebung
string.

Gibt die Umgebung an, für die bereitgestellt werden soll. Lassen Sie dies für die Produktionsumgebung leer. Diese Eingabe hat Vorrang vor dem Produktionszweig.

production_branch - Production Branch
string.

Gibt den Produktionszweig an. Wenn definiert und die Bereitstellungsumgebung leer ist, sind Bereitstellungen aus anderen Zweigstellen Vorschauumgebungen.

data_api_location - Speicherort der Daten-API
string.

Verzeichnisspeicherort der Datenquellendateien der Daten-API relativ zum Arbeitsverzeichnis.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

AZURESTATICWEBAPP_STATIC_WEB_APP_URL
URL der statischen Web App nach einer erfolgreichen Bereitstellung.

Bemerkungen

Anmerkung

Diese Aufgabe wird nur auf Linux-Agents ausgeführt.

Beispiele

trigger:
  - main

pool:
  vmImage: ubuntu-latest

steps:
  - checkout: self
    submodules: true
  - task: AzureStaticWebApp@0
    inputs:
      app_location: '/build'
      api_location: 'api'
      output_location: '/output'
      azure_static_web_apps_api_token: $(deployment_token)

Erstellen der Front-End-App überspringen und nur bereitstellen

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '20.x'
    displayName: 'Install Node.js'

  - script: |
      npm ci
      npm run build
    displayName: 'dependencies install and distribution build'

- task: AzureStaticWebApp@0
  inputs:
    app_location : '/dist'
    output_location: '' # Leave this empty
    skip_app_build: true
    skip_api_build: true
    azure_static_web_apps_api_token: $(deployment_token)

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.95.0 oder höher
Vorgangskategorie	Nützlichkeit