共用方式為


AzureStaticWebApp@0 - 部署 Azure Static Web App v0 工作

此工作會建置及部署 Azure 靜態 Web 應用程式。

語法

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

輸入

workingDirectory - 工作目錄
輸入別名:cwd | rootDirectorystring。 預設值:$(System.DefaultWorkingDirectory)

指定要在其中執行這項工作的絕對工作目錄。 如果保留空白,則會使用預設的工作目錄。


app_location - 應用程式位置
string

應用程式原始碼的目錄位置,相對於工作目錄。 搭配 skip_app_build: true使用時,此值是應用程式的組建輸出位置。


app_build_command - 應用程式建置命令
string

建置應用程式原始程式碼時用來執行 Oryx 的自訂命令。


output_location - 輸出位置
string

建置完成後所編譯應用程式程式代碼的目錄位置,相對於工作目錄。 當略過自動建置且只需要部署時,請將此設定為空字串 ('')。


api_location - Api 位置
string

Azure Functions 原始程式碼的目錄位置,相對於工作目錄。


api_build_command - Api 建置命令
string

建置 Azure Functions 原始程式碼時用來執行 Oryx 的自定義命令。


routes_location - 路由位置
string

routes.json 檔案的目錄位置,相對於工作目錄。
注意: Routes.json 已被取代。 使用 staticwebapp.config.json。


config_file_location - 組態檔位置
string

staticwebapp.config.json 檔案的目錄位置,相對於工作目錄。


skip_app_build - 略過應用程式建置
boolean

略過應用程式資料夾的 Oryx 組建。


skip_api_build - 略過 api 組建
boolean

略過 API 資料夾的 Oryx 組建。


is_static_export - 設定靜態匯出
boolean

當您的應用程式設定為匯出至靜態 HTML 時,請將此旗標設定為 true,例如使用 next export時。

當此旗標設定為 true


verbose - 詳細資訊
boolean

啟用詳細信息記錄。


build_timeout_in_minutes - 分鐘 建置逾時
string

指定 Oryx 應用程式資料夾建置時間限制,以分鐘為單位。


azure_static_web_apps_api_token - Azure Static Web Apps api 令牌
string

指定部署的 API 令牌。
注意: 傳遞為環境變數時不需要。


deployment_environment - 部署環境
string

指定要部署的環境。 針對生產環境保留空白。 此輸入的優先順序高於生產分支。


production_branch - 生產分支
string

指定生產分支。 定義且部署環境是空的,來自其他分支的部署將會是預覽環境。


data_api_location - 數據 API 位置
string

數據 API 來源檔案相對於工作目錄的目錄位置。


工作控制選項

除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制項選項和一般工作屬性

輸出變數

此工作會定義下列 輸出變數,您可以在下游步驟、作業和階段中取用這些變數。

AZURESTATICWEBAPP_STATIC_WEB_APP_URL
成功部署之後, 靜態 Web 應用程式的 URL。

言論

注意

此工作只會在Linux代理程式上執行。

例子


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)

略過建置前端應用程式並只執行部署


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)

要求

要求 描述
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任何
Settable 變數 任何
代理程式版本 1.95.0 或更新
工作類別 效用