Implementar no Serviço de Aplicações com o Azure Pipelines

1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

2. Vá para Pipelines e selecione New Pipeline.

3. Quando solicitado, selecione o local do seu código-fonte: Azure Repos Git ou GitHub.

   Poderá ser redirecionado para o GitHub para iniciar sessão. Em caso afirmativo, insira suas credenciais do GitHub.

4. Quando a lista de repositórios aparecer, selecione seu repositório.

5. Você pode ser redirecionado para o GitHub para instalar o aplicativo Azure Pipelines. Em caso afirmativo, selecione Aprovar e instalar.

6. Quando a guia Configurar for exibida, selecione ASP.NET Core.

7. Quando seu novo pipeline aparecer, dê uma olhada no YAML para ver o que ele faz. Quando estiver pronto, selecione Salvar e executar.

Para começar:

1. Crie um pipeline e selecione o modelo ASP.NET Core . Essa seleção adiciona automaticamente as tarefas necessárias para criar o código no repositório de exemplo.

2. Salve o pipeline e enfileire uma compilação para vê-la em ação.

   O modelo de pipeline ASP.NET Core publica o arquivo ZIP de implantação como um artefato do Azure para a tarefa de implantação posteriormente.

1. Clique no final do arquivo YAML e selecione Mostrar assistente.'

2. Use o Assistente de tarefas para adicionar a tarefa do Aplicativo Web do Azure.

   

   Como alternativa, você pode adicionar a tarefa de implantação do Serviço de Aplicativo do Azure (AzureRmWebAppDeployment).

3. Escolha sua assinatura do Azure. Certifique-se de Autorizar sua conexão. A autorização cria a conexão de serviço necessária.

4. Selecione o Tipo de aplicativo, o nome do aplicativo e a pilha de tempo de execução com base no seu aplicativo do Serviço de Aplicativo. Seu YAML completo deve ser semelhante ao código a seguir.

   variables:
     buildConfiguration: 'Release'
   
   steps:
   - task: DotNetCoreCLI@2
     inputs:
       command: 'publish'
       publishWebProjects: true
   - task: AzureWebApp@1
     inputs:
       azureSubscription: '<service-connection-name>'
       appType: 'webAppLinux'
       appName: '<app-name>'
       package: '$(System.DefaultWorkingDirectory)/**/*.zip'
   

   • azureSubscription: Nome da conexão de serviço autorizado à sua assinatura do Azure.
   • appName: nome do seu aplicativo existente.
   • package: caminho do arquivo para o pacote ou uma pasta que contém o conteúdo do serviço de aplicativo. Curingas são suportados.

Para começar:

1. Crie um pipeline de liberação selecionando Releases no menu à esquerda e selecione New pipeline.

2. Selecione o modelo de implantação do Serviço de Aplicativo do Azure para seu estágio. Isso 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 Node.js Aplicativo no Serviço de Aplicativo do Azure. A única diferença entre esses modelos é que Node.js modelo configura a tarefa para gerar um arquivo web.config contendo um parâmetro que inicia o serviço iisnode .

3. Para vincular esse pipeline de liberação ao artefato do Azure da etapa anterior, selecione Adicionar uma compilação de artefato>.

4. Em Origem (pipeline de compilação), selecione o pipeline de compilação criado na seção anterior e selecione Adicionar.

5. Salve o pipeline de liberação e crie uma versão para vê-lo em ação.

Para implantar um pacote Web .zip (por exemplo, de um aplicativo Web ASP.NET) em um Aplicativo Web do Azure, use o trecho a seguir para implantar a compilação em um aplicativo.

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

• azureSubscription: sua assinatura do Azure.
• appType: seu tipo de aplicativo Web.
• appName: o nome do seu serviço de aplicativo existente.
• Pacote: o caminho do arquivo para o pacote ou uma pasta que contém o conteúdo do serviço de aplicativo. Curingas são suportados.

Para pipelines clássicos, é mais fácil definir estágios de compilação e liberação em páginas separadas (Pipelines e Releases, respectivamente). Em geral, você:

• Na página Pipelines, crie e teste seu aplicativo usando o modelo de sua escolha, como ASP.NET Core, Node.js com Grunt, Maven ou outros, e publique um artefato.
• Na página Versão, use o modelo genérico de implantação do Serviço de Aplicativo do Azure para implantar o artefato.

Pode haver modelos para linguagens de programação específicas para escolher.

Por padrão, sua implantação acontece com o aplicativo raiz no Aplicativo Web do Azure. Você pode implantar em um aplicativo virtual específico usando a VirtualApplication propriedade da tarefa de implantaçãoAzureRmWebAppDeployment () do Serviço de Aplicativo do Azure:

- task: AzureRmWebAppDeployment@4
  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 .

Por padrão, sua implantação acontece com o aplicativo raiz no Aplicativo Web do Azure. Se você quiser 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, trocar 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>'
    appType: webAppLinux
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: sua assinatura do Azure.
• appType: (opcional) Use webAppLinux para implantar em um aplicativo Web no Linux.
• appName: o nome do seu serviço de aplicativo existente.
• deployToSlotOrASE: Booleano. Implante em um slot de implantação existente ou no Ambiente do Serviço de Aplicativo do Azure.
• resourceGroupName: Nome do grupo de recursos. Obrigatório se deployToSlotOrASE for verdadeiro.
• slotName: Nome do slot, cujo padrão é production. Obrigatório se deployToSlotOrASE for verdadeiro.
• Pacote: o caminho do arquivo para o pacote ou uma pasta que contém o conteúdo do serviço de aplicativo. Curingas são suportados.
• SourceSlot: Slot enviado para produção quando SwapWithProduction for verdadeiro.
• SwapWithProduction: Booleano. Troque o tráfego do slot de origem pela produção.

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

Você pode usar trabalhos em seu arquivo YAML para configurar um pipeline de implantações. Usando trabalhos, você pode controlar a ordem de implantação em vários aplicativos 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'

Se você quiser implantar em vários aplicativos Web, adicione estágios ao seu pipeline de lançamento. Você pode controlar a ordem de implantação. Para saber mais, consulte Estágios.

O trecho a seguir mostra um exemplo de substituição de variáveis usando a tarefa Implantar do Serviço de Aplicativo do Azure (AzureRmWebAppDeployment):

jobs:
- job: test
  variables:
    connectionString: <test-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Test stage Azure service connection>'
      WebAppName: '<name of test stage web app>'
      enableXmlVariableSubstitution: true

- job: prod
  dependsOn: test
  variables:
    connectionString: <prod-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Prod stage Azure service connection>'
      WebAppName: '<name of prod stage web app>'
      enableXmlVariableSubstitution: true

Para alterar connectionString usando a substituição de variáveis:

1. Crie um pipeline de liberação com dois estágios.
2. Vincule o artefato da versão à compilação que produz o pacote da Web.
3. Defina connectionString como variável em cada uma das etapas. Defina o valor apropriado.
4. Selecione a opção de substituição de variável XML em Transformações de Arquivo e Opções de Substituição de Variáveis para a tarefa Implantar do Serviço de Aplicativo do Azure.

Para fazer isso no YAML, você pode usar uma das seguintes técnicas:

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

O exemplo a seguir mostra como usar condições de etapa para implantar somente compilações originárias 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 saber mais 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 as aprovações de pré-implantação como uma pré-condição para a implantação em um estágio.
• Configure portas como uma pré-condição para a implantação em um estágio.
• Especifique as condições para que uma tarefa seja executada.

Para saber mais, consulte Gatilhos de liberação, ramificação e estágio, Controle de implantação de liberação usando aprovações, Controle de implantação de liberação usando portas e Especificar condições para executar uma tarefa.

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@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

No pipeline de versão, supondo que você esteja usando o modelo de implantação do Serviço de Aplicativo do Azure:

1. Selecione a guia Tarefas e, em seguida, selecione Implantar o Serviço de Aplicativo do Azure. Esta é a AzureRmWebAppDeployment tarefa.

2. Na caixa de diálogo, verifique se Tipo de conexão está definido como Azure Resource Manager.

3. Na caixa de diálogo, expanda Opções de implantação adicionais e selecione Selecionar método de implantação. Certifique-se de que a Implantação da Web esteja selecionada como o método de implantação.

4. Salve o pipeline de liberação.