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 | rootDirectory
。
string
。 預設值:$(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 或更新 |
工作類別 | 效用 |