jobs.deployment.strategy.runOnce 定義
runOnce 部署策略會執行每個步驟一次來推出變更。
runOnce:
preDeploy: # Pre deploy hook for runOnce deployment strategy.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where pre deploy steps will run.
deploy: # Deploy hook for runOnce deployment strategy.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where deploy steps will run.
routeTraffic: # Route traffic hook for runOnce deployment strategy.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where route traffic steps will run.
postRouteTraffic: # Post route traffic hook for runOnce deployment strategy.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where post route traffic steps will run.
on: # On success or failure hook for runOnce deployment strategy.
failure: # Runs on failure of any step.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where post on failure steps will run.
success: # Runs on success of all of the steps.
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
pool: string | pool # Pool where on success steps will run.
參考此定義的定義： jobs.deployment.strategy
屬性
preDeploypreDeployHook。
針對 runOnce 部署策略預先部署攔截。
deploydeployHook。
部署 runOnce 部署策略的攔截。
routeTrafficrouteTrafficHook。
路由傳送 runOnce 部署策略的流量攔截。
postRouteTrafficpostRouteTrafficHook。
發佈 RunOnce 部署策略的路由流量攔截。
ononSuccessOrFailureHook。
在 runOnce 部署策略的成功或失敗勾點時。
備註
runOnce是最簡單的部署策略，其中所有生命週期勾點， preDeploydeploy 也就是 、 routeTraffic 和 postRouteTraffic 都會執行一次。 然後會執行 on:success 或 on:failure。
生命週期勾點的描述
preDeploy：用來執行在應用程式部署開始之前初始化資源的步驟。
deploy：用來執行部署應用程式的步驟。 下載成品工作只會在部署作業的勾點中 deploy 自動插入。 若要停止下載成品，請使用 - download: none 或選擇要下載的特定成品，方法是指定 [下載管線成品] 工作。
routeTraffic：用來執行提供已更新版本流量的步驟。
postRouteTraffic：用來在路由傳送流量之後執行步驟。 一般而言，這些工作會監視已更新版本的健全狀況，以取得定義的間隔。
on: failure 或 on: success ：用來執行復原動作或清除的步驟。
範例
下列範例 YAML 程式碼片段示範使用 runOnce 部署策略來簡單使用部署作業。 此範例包含結帳步驟。
jobs:
# Track deployments on the environment.
- deployment: DeployWeb
displayName: deploy Web App
pool:
vmImage: ubuntu-latest
# Creates an environment if it doesn't exist.
environment: 'smarthotel-dev'
strategy:
runOnce:
deploy:
steps:
- checkout: self
- script: echo my first deployment
每次執行此作業時，都會針對 smarthotel-dev 環境記錄部署歷程記錄。
注意
- 您也可以建立具有空白資源的環境，並使用該環境作為抽象殼層來記錄部署歷程記錄，如上一個範例所示。
下一個範例示範管線如何參考環境和資源，作為部署作業的目標。
jobs:
- deployment: DeployWeb
displayName: deploy Web App
pool:
vmImage: ubuntu-latest
# Records deployment against bookings resource - Kubernetes namespace.
environment: 'smarthotel-dev.bookings'
strategy:
runOnce:
deploy:
steps:
# No need to explicitly pass the connection details.
- task: KubernetesManifest@0
displayName: Deploy to Kubernetes cluster
inputs:
action: deploy
namespace: $(k8sNamespace)
manifests: |
$(System.ArtifactsDirectory)/manifests/*
imagePullSecrets: |
$(imagePullSecret)
containers: |
$(containerRegistry)/$(imageRepository):$(tag)
此方法具有下列優點：
- 記錄環境中特定資源的部署歷程記錄，而不是記錄環境中所有資源的歷程記錄。
- 部署作業中的步驟 會自動繼承 資源 (的連線詳細資料，在此案例中為 Kubernetes 命名空間
smarthotel-dev.bookings) ，因為部署作業已連結至環境。 這在針對作業的多個步驟設定相同的連線詳細資料的情況下很有用。