jobs.deployment.strategy.runOnce definition
A estratégia de implementação runOnce implementa as alterações ao executar cada um dos seus passos uma vez.
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.
Definições que referenciam esta definição: jobs.deployment.strategy
Propriedades
preDeploypreDeployHook.
Implementar previamente o hook para a estratégia de implementação runOnce.
deploydeployHook.
Implementar o hook para a estratégia de implementação runOnce.
routeTrafficrouteTrafficHook.
Encaminhar o gancho de tráfego para a estratégia de implementação runOnce.
postRouteTrafficpostRouteTrafficHook.
Post route traffic hook for runOnce deployment strategy.
ononSuccessOrFailureHook.
No gancho de êxito ou falha para a estratégia de implementação runOnce.
Observações
runOnce é a estratégia de implementação mais simples em que todos os ganchos de ciclo de vida, nomeadamente preDeploydeploy, routeTraffice postRouteTraffic, são executados uma vez. Em seguida, on:success ou on:failure é executado.
Descrições de ganchos de ciclo de vida
preDeploy: utilizado para executar passos que inicializam recursos antes do início da implementação da aplicação.
deploy: utilizado para executar passos que implementam a sua aplicação. A tarefa transferir artefacto será injetada automaticamente apenas no deploy gancho para tarefas de implementação. Para parar a transferência de artefactos, utilize - download: none ou escolha artefactos específicos para transferir ao especificar a tarefa Transferir Artefacto do Pipeline.
routeTraffic: utilizado para executar passos que servem o tráfego para a versão atualizada.
postRouteTraffic: utilizado para executar os passos após o encaminhamento do tráfego. Normalmente, estas tarefas monitorizam o estado de funcionamento da versão atualizada para um intervalo definido.
on: failure ou on: success: utilizado para executar passos para ações de reversão ou limpeza.
Exemplos
O fragmento YAML de exemplo seguinte mostra uma utilização simples de uma tarefa de implementação através da runOnce estratégia de implementação. O exemplo inclui um passo de saída.
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
Com cada execução desta tarefa, o histórico de implementações é registado no smarthotel-dev ambiente.
Nota
- Também é possível criar um ambiente com recursos vazios e utilizá-lo como uma shell abstrata para registar o histórico de implementações, conforme mostrado no exemplo anterior.
O exemplo seguinte demonstra como um pipeline pode referenciar um ambiente e um recurso a utilizar como destino para uma tarefa de implementação.
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)
Esta abordagem tem os seguintes benefícios:
- Regista o histórico de implementações num recurso específico no ambiente, em vez de registar o histórico em todos os recursos dentro do ambiente.
- Os passos na tarefa de implementação herdam automaticamente os detalhes de ligação do recurso (neste caso, um espaço de nomes do Kubernetes),
smarthotel-dev.bookingsporque a tarefa de implementação está ligada ao ambiente. Isto é útil nos casos em que o mesmo detalhe de ligação está definido para vários passos da tarefa.