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

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

1. No menu de navegação esquerdo 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 do projeto.
3. Na tela Onde está seu código , selecione o local do seu código-fonte, Azure Repos Git ou GitHub. Se necessário, faça login no GitHub.
4. Na tela Selecione um repositório , selecione seu repositório de código.
5. Na tela Configurar seu pipeline , selecione Pipeline inicial.

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

1. Na tela Revisar seu pipeline YAML , exclua todo o código após a steps: linha.
2. Selecione o final do ficheiro e, em seguida, selecione Mostrar assistente à direita.
3. Em Tarefas, selecione .NET Core.
4. Na tela de configuração do .NET Core , em 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. Verifique se as caixas de seleção Publicar projetos da Web e Executar projetos publicados estão marcadas e selecione Adicionar.
7. A tarefa aparece no pipeline do YAML. Revise o código YAML para ver o que ele faz. Quando estiver pronto, selecione Salvar e executar e, em seguida, selecione Salvar e executar novamente.
8. Na tela Resumo da compilação, em Trabalhos, selecione o link Permissão necessária . No ecrã Verificações , selecione Permitir e, em seguida, selecione Permitir novamente. Conceder permissão aqui permite o uso da conexão de serviço que você autorizou para todas as execuções desse pipeline.

1. No menu de navegação esquerdo 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 do projeto.
3. Na tela Onde está seu código , selecione Usar o editor clássico para criar um pipeline sem YAML.
4. Na tela Selecione um repositório , selecione o local do seu código-fonte, Azure Repos Git ou GitHub, e selecione seu código Repositório e ramificação padrão. Selecione Continuar.
5. No ecrã Escolher um modelo , selecione ASP.NET Núcleo e, em seguida, selecione Aplicar.
6. Na nova tela de pipeline, em Especificação do agente à direita, selecione uma especificação de agente, como ubuntu-latest ou windows-latest dependendo da plataforma e da versão do seu aplicativo.
7. Olhe para o pipeline para ver o que ele faz. Quando estiver pronto, selecione Salvar fila de desejos.
8. Selecione Salvar fila & 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 aparecendo.
3. Na lista Tarefas , procure e selecione a tarefa do 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 , em Assinatura do Azure, selecione a mesma conexão de serviço que você configurou para a etapa anterior. Não é necessário reautorizar esta ligação.
5. Para Tipo de aplicativo, selecione Aplicativo Web do Azure no Linux ou Aplicativo Web do Azure no Windows, dependendo do seu código.
6. Em Nome do aplicativo, selecione ou insira o nome do aplicativo do Serviço de Aplicativo.
7. Selecione Adicionar.
8. Selecione Validar e guardar e, em seguida, selecione Guardar.
9. Selecione Executar e, em seguida, selecione Executar novamente.

O pipeline YAML completo deve se parecer com o 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 para sua assinatura do Azure.
• appName: Nome do seu aplicativo existente.
• package: Caminho do arquivo para o pacote ou pasta que contém o conteúdo do Serviço de Aplicativo. Caracteres universais são suportados.

Para pipelines clássicos, é mais fácil definir estágios de construção e liberação em pipelines separados.

1. No menu de navegação esquerdo do seu projeto, selecione Pipelines>Releases e, em seguida, selecione New pipeline para criar um pipeline de release.

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

   Nota

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

3. Na página Novo pipeline de versão , selecione a guia Tarefas , selecione Estágio 1 e preencha 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 Aplicativo Web do Azure no Linux ou Aplicativo Web do Azure no Windows, para corresponder ao seu código e especificação do agente.
   • Nome do serviço de aplicativo: selecione seu aplicativo do Serviço de Aplicativo.

4. Na guia Pipeline da tela Novo pipeline de versão , ao lado de Artefatos, selecione Adicionar.

5. Na tela Adicionar um artefato , verifique se Build está selecionado e, em Source (pipeline de compilação), selecione o pipeline criado 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 do pipeline, selecione Criar versão e, em seguida, selecione Criar.

A tarefa do Aplicativo Web do Azure é implantada no aplicativo raiz no aplicativo Web do Azure. Você pode implantar em um aplicativo virtual específico usando a VirtualApplication propriedade 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. Para obter mais informações, consulte Configurar um aplicativo do Serviço de Aplicativo no portal do Azure.

A tarefa do 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 num slot intermediário 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 seu aplicativo existente.
• deployToSlotOrASE: Booleano. Se deseja implantar em um slot de implantação existente ou em um ambiente do Serviço de Aplicativo.
• resourceGroupName: Nome do grupo de recursos para implantar, obrigatório se deployToSlotOrASE for verdadeiro.
• slotName: Nome do slot a ser implantado, obrigatório se deployToSlotOrASE for verdadeiro. O padrão é production.
• package: Caminho do arquivo para o pacote ou pasta que contém o conteúdo do aplicativo. Caracteres universais são suportados.
• SourceSlot: Slot enviado para produção quando SwapWithProduction é verdadeiro.
• SwapWithProduction: Booleano. Se o tráfego do slot de origem deve ser trocado pela produção.

Use a opção Implantar no Slot ou no Ambiente do Serviço de Aplicações na tarefa do Azure Web App para especificar o slot para implantar. Para trocar os slots, use a tarefa de Gerir Serviço de Aplicativo do Azure.

Você pode usar jobs no seu arquivo YAML para definir um pipeline de implantações. Ao utilizar tarefas, pode controlar a ordem de distribuiçã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ários aplicativos Web, adicione estágios ao seu pipeline de lançamento. 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 compilações bem-sucedidas originadas da ramificação 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.

Em seu pipeline de liberação, você pode implementar várias verificações e condições para controlar a implantação:

• Defina filtros de ramificação para configurar o gatilho de implantação contínua no artefato do pipeline de liberação.
• Defina aprovações de pré-implantação ou configure portões como uma pré-condição para a implantação num estágio.
• Especifique as condições para que uma tarefa seja executada.

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

• Gatilhos de lançamento clássicos
• Controle de implantação usando aprovações
• Conceitos de portas 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 versão, 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 Tipo de conexão está definido como Gerenciador de Recursos do Azure.
3. Expanda Opções de implantação adicionais e escolha Selecionar método de implantação. Certifique-se de que Web Deploy esteja selecionado como o método de implementação.
4. Salve o pipeline de lançamento.