Implantar no Serviço de Aplicativo do Azure usando o Azure Pipelines

Defina um pipeline criando um arquivo YAML azure-pipelines.yml no repositório de código.

1. No menu de navegação à esquerda do seu projeto do Azure DevOps, selecione Pipelines.
2. Na página Pipelines, selecione Novo pipeline ou Criar pipeline se esse pipeline for o primeiro no projeto.
3. Na tela Onde está o código, selecione o local do código-fonte, Git do Azure Repos ou GitHub. Se necessário, entre no GitHub.
4. Na tela Selecionar um repositório, selecione seu repositório de código.
5. Na página Configurar seu pipeline, selecione Pipeline inicial.

Adicione a tarefa .NET Core (DotNetCoreCLI@2) ao pipeline e crie e publique seu aplicativo.

1. Na tela Examinar o YAML do pipeline, exclua todo o código após a linha steps:.
2. Selecione o final do arquivo e, em seguida, selecione Mostrar assistente à direita.
3. Em Tarefas, selecione .NET Core.
4. Na tela de configuração do .NET Core, na conexão do Azure Resource Manager, selecione sua assinatura do Azure e selecione Autorizar para criar a conexão de serviço necessária.
5. Em Comando, selecione publicar.
6. Certifique-se de que as caixas de seleção Publicar projetos da Web e Compactar projetos publicados estejam marcadas e, em seguida, selecione Adicionar.
7. A tarefa é exibida no pipeline do YAML. Examine o código YAML para ver o que ele faz. Quando estiver pronto, selecione Salvar e executar e selecione Salvar e executar novamente.
8. Na tela Resumo da compilação, em Trabalhos, selecione o link Permissão necessária. Na tela Verificações, selecione Permitir e selecione Permitir novamente. A concessão de permissão aqui permite o uso da conexão de serviço autorizada para todas as execuções deste pipeline.

1. No menu de navegação à esquerda do seu projeto do Azure DevOps, selecione Pipelines.
2. Na página Pipelines, selecione Novo pipeline ou Criar pipeline se esse pipeline for o primeiro no projeto.
3. Na tela Onde está o código, selecione Usar o editor clássico para criar um pipeline sem YAML.
4. Na tela Selecionar um repositório, selecione o local do código-fonte, o Git do Azure Repos ou o GitHub e selecione o Repositório de código e o branch Padrão. Selecione Continuar.
5. Na tela Escolher um modelo, selecione ASP.NET Core e selecione Aplicar.
6. Na nova tela de pipeline, em Especificação do Agente à direita, selecione uma especificação do agente, como ubuntu-latest ou windows-latest, dependendo da plataforma e da versão do aplicativo.
7. Examine o pipeline para ver o que ele faz. Quando estiver pronto, selecione Salvar & Enfileirar.
8. Selecione Salvar & enfileirar novamente e, na tela Executar pipeline, selecione Salvar e executar.

1. Na tela Resumo da execução do pipeline, selecione o ícone Mais ações no canto superior direito e, em seguida, selecione Editar pipeline.
2. Selecione o final do arquivo YAML e selecione Mostrar assistente se a lista Tarefas não estiver sendo exibida.
3. Na lista Tarefas, pesquise e selecione a tarefa Aplicativo Web do Azure. Como alternativa, você pode usar a tarefa de implantação do Serviço de Aplicativo do Azure.
4. Na tela de configuração do Aplicativo Web do Azure, na assinatura do Azure, selecione a mesma conexão de serviço configurada para a etapa anterior. Você não precisa reautorizar essa conexão.
5. Para o Tipo de aplicativo, selecione Aplicativo Web do Azure no Linux ou Aplicativo Web do Azure no Windows, dependendo do seu código.
6. Para Nome do aplicativo, selecione ou insira o nome do aplicativo do Serviço de Aplicativo.
7. Selecione Adicionar.
8. Selecione Validar e salvar e, em seguida, selecione Salvar.
9. Selecione Executar e, em seguida, selecione Executar novamente.

O pipeline YAML completo deve ser semelhante ao seguinte código:

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

• azureSubscription: nome da conexão de serviço autorizada à sua assinatura do Azure.
• appName: nome do aplicativo existente.
• package: Caminho do arquivo para o pacote ou pasta que contém o conteúdo do Serviço de Aplicativo. Os caracteres curinga têm suporte.

Para pipelines clássicos, é mais fácil definir estágios de build e lançamento em pipelines separados.

1. No menu de navegação à esquerda do projeto, selecionePipelines>Lançamentos e selecione Novo pipeline para criar um pipeline de lançamento.

2. Em Selecionar um modelo, selecione o modelo de implantação do Serviço de Aplicativo do Azure e selecione Aplicar. Esse modelo adiciona automaticamente as tarefas necessárias.

   Observação

   Se você estiver implantando um aplicativo Node.js no Serviço de Aplicativo no Windows, selecione Implantar um aplicativo Node.js no modelo do Serviço de Aplicativo do Azure. Esse modelo configura a tarefa para gerar um arquivo web.config que contém um parâmetro que inicia o serviço iisnode.

3. Na página Novo pipeline de lançamento, selecione a guia Tarefas, selecione Estágio 1 e conclua os seguintes campos em Parâmetros:

   • Assinatura do Azure: Se você ainda não tiver uma conexão de serviço do Azure, selecione sua assinatura do Azure e selecione Autorizar para criar a conexão de serviço necessária.
   • Tipo de aplicativo: Selecione o Aplicativo Web do Azure no Linux ou Aplicativo Web do Azure no Windows para corresponder à especificação de código e agente.
   • Nome do serviço de aplicativo: Selecione seu aplicativo do Serviço de Aplicativo.

4. Na guia Pipeline da tela Novo pipeline de lançamento, ao lado de Artefatos, selecione Adicionar.

5. Na tela Adicionar um artefato, verifique se o Build está selecionado e, em Origem (pipeline de build), selecione o pipeline que você criou na seção anterior.

6. Selecione Adicionar.

7. Na página do pipeline, selecione Salvar no canto superior direito e, em seguida, selecione OK.

8. Para executar o pipeline, na página de pipeline, selecione Criar versão e, em seguida, selecione Criar.

A tarefa aplicativo Web do Azure é implantada no aplicativo raiz no aplicativo Web do Azure. Você pode fazer a implantação em um aplicativo virtual específico usando a propriedade VirtualApplication da tarefa de implantação do Serviço de Aplicativo do Azure.

- task: AzureRmWebAppDeployment@5
  inputs:
    VirtualApplication: '<name of virtual application>'

VirtualApplication é o nome do aplicativo virtual configurado no portal do Azure. Confira Configurar um aplicativo do Serviço de Aplicativo no portal do Azure para obter mais detalhes.

A tarefa aplicativo Web do Azure é implantada no aplicativo raiz no aplicativo Web do Azure. Para implantar em um aplicativo virtual específico, insira seu nome na propriedade Aplicativo Virtual da tarefa de implantação do Serviço de Aplicativo do Azure.

O exemplo a seguir mostra como implantar em um slot de preparo e, em seguida, alternar para um slot de produção:

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: Sua conexão de serviço do Azure.
• appType: Tipo de aplicativo opcional, como webAppLinux implantar em um aplicativo Web no Linux.
• appName: O nome do aplicativo existente.
• deployToSlotOrASE: Booliano. Se deve ser implantado em um slot de implantação existente ou em um ambiente do Serviço de Aplicativo.
• resourceGroupName: Nome do grupo de recursos para o qual implantar, necessário se deployToSlotOrASE for true.
• slotName: Nome do slot no qual implantar, necessário se deployToSlotOrASE for true. Usa production como padrão.
• package: Caminho do arquivo para o pacote ou pasta que contém o conteúdo do aplicativo. Os caracteres curinga têm suporte.
• SourceSlot: slot enviado para a produção quando SwapWithProduction for true.
• SwapWithProduction: Booliano. Se deve trocar o tráfego do slot de origem pela produção.

Use a opção Implantar no Slot ou Ambiente do Serviço de Aplicativo na tarefa Aplicativo Web do Azure para especificar o slot no qual fazer a implantação. Para trocar os slots, use a tarefa de gerenciamento do Serviço de Aplicativo do Azure.

No seu arquivo YAML, você pode usar jobs para configurar um pipeline de desdobramentos. Usando tarefas, você pode controlar a ordem de implantação em várias aplicações web.

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

Para implantar em várias aplicações web, adicione estágios ao pipeline de liberação. Você pode controlar a ordem de implantação. Para obter mais informações, consulte Estágios.

Para implantar condicionalmente no YAML, use uma das seguintes técnicas:

• Adicione uma condição à etapa.
• Isole as etapas de implantação em um trabalho separado e adicione uma condição a esse trabalho.

O exemplo a seguir mostra como usar condições de etapa para implantar somente builds bem-sucedidos originados do branch principal:

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

Para obter mais informações sobre condições, consulte Especificar condições.

No seu pipeline de lançamento, você pode implementar diversas verificações e condições para controlar a implantação:

• Defina filtros de branch para configurar o gatilho de implantação contínua no artefato do pipeline de lançamento.
• Defina as aprovações de pré-implantação ou configure portões como uma pré-condição para a implantação em um estágio.
• Especifique as condições para uma tarefa ser executada.

Para obter mais informações, consulte os seguintes artigos:

• Gatilhos de versão clássicos
• Controle de implantação usando aprovações
• Conceitos de portões de implantação

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

- task: AzureRmWebAppDeployment@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

Se você estiver usando o modelo de implantação do Serviço de Aplicativo do Azure em um pipeline de lançamento, siga estas etapas para implantar na Implantação da Web.

1. Selecione a guia Tarefas e, em seguida, selecione Implantar o Serviço de Aplicativo do Azure, a tarefa de implantação do Serviço de Aplicativo do Azure.
2. Na tela de configuração, verifique se o Tipo de conexão está definido como Azure Resource Manager.
3. Expanda Opções adicionais de implantação e escolha Selecionar método de implantação. Verifique se a opção Implantação da Web está marcada como o método de implantação.
4. Salve o pipeline de lançamento.