Exercício – Atualizar o gatilho do fluxo de trabalho

  • 3 minutos

Um colega solicita que você ative o recurso de Always On do Serviço de Aplicativo no site da empresa, para que o aplicativo do site esteja sempre em execução.

Neste exercício, você atualizará o fluxo de trabalho criado anteriormente para ser executado automaticamente sempre que um arquivo for atualizado na ramificação main. Você usará o fluxo de trabalho atualizado para implantar a alteração de configuração solicitada no site.

Durante o processo, você vai:

  • Atualize o fluxo de trabalho para que ele seja disparado automaticamente sempre que os arquivos mudarem na pasta deploy e na ramificação main.
  • Faça uma alteração no arquivo Bicep.
  • Verifique se o fluxo de trabalho é executado automaticamente.

Atualizar o gatilho para ser baseado em branch

  1. No Visual Studio Code, abra o arquivo .github/workflows/workflow.yml.

  2. Na parte superior do arquivo, após a linha name: deploy-toy-website, adicione o seguinte código para evitar várias execuções de fluxos de trabalho simultâneas:

    name: deploy-toy-website
concurrency: toy-company

  3. Remova o gatilho manual, que é a linha que o lê on: [workflow_dispatch] atualmente.

  4. Entre concurrency: e permissions:, adicione a seguinte definição de gatilho:

    concurrency: toy-company

on:
  push:
    branches:
      - main
    paths:
      - 'deploy/**'

permissions:

  5. Salve as alterações no arquivo.

  6. Faça commit de suas alterações, mas não efetue push ainda. Você enviará as alterações por push em breve.

    git add .
git commit -m 'Add branch trigger'

Atualizar o arquivo Bicep

  1. No Visual Studio Code, abra o arquivo main.bicep.

  2. Na propriedade siteConfig da definição de recurso appServiceApp, adicione a propriedade alwaysOn com um valor de true:

    
resource appServiceApp 'Microsoft.Web/sites@2022-03-01' = {
  name: appServiceAppName
  location: location
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
    siteConfig: {
      alwaysOn: true
      appSettings: [
        {
          name: 'ToyManualsStorageAccountConnectionString'
          value: toyManualsStorageAccountConnectionString
        }
      ]
    }
  }

  3. Salve as alterações no arquivo.

  4. No terminal do Visual Studio Code, execute o seguinte comando para confirmar as suas alterações e efetuar push de ambas as confirmações:

    git add .
git commit -m 'Configure app Always On setting'
git push

Verifique se o fluxo de trabalho falhou

  1. No navegador, selecione o menu Ações do GitHub e selecione o seu fluxo de trabalho.

  2. Selecione a execução mais recente do fluxo de trabalho para conferir se ele foi executado automaticamente. O fluxo de trabalho foi executado porque você efetuou push das suas alterações para uma ramificação monitorada pelo gatilho de envio. Se o fluxo de trabalho ainda estiver em execução, espere um pouco e atualize a página.

    Screenshot of the GitHub interface showing the failed workflow run.

    O fluxo de trabalho mostra uma falha na implantação.

  3. Para diagnosticar a falha, selecione o trabalho deploy e selecione a tarefa arm-deploy que falhou.

    Observe que ela inclui o seguinte texto:

    There was a conflict. AlwaysOn cannot be set for this site as the plan does not allow it.
For more information on pricing and features, please see: https://aka.ms/appservicepricingdetails

    Essa mensagem de erro indica que a implantação falhou porque o aplicativo do Serviço de Aplicativo foi implantado usando a camada F1 gratuita, que não dá suporte ao recurso Always On.

    Importante

    Esse exemplo ilustra como é importante testar seus arquivos Bicep, incluindo todos os valores de parâmetro que você usa. É fácil ver erros sutis serem adicionados em sua configuração de recurso ou em outro código. Talvez você não descubra um problema até que o fluxo de trabalho implante o código e ele falhe. Em um módulo futuro, você aprenderá algumas estratégias que poderá usar para verificar e testar seu código Bicep.

Corrija o arquivo Bicep e veja o fluxo de trabalho disparado novamente

Você fala com seu colega sobre a implantação com falha. Juntos, vocês decidem que a configuração de Always On só precisa ser aplicada ao seu ambiente de produção. Aqui, você corrige o problema que causou a falha de implantação aplicando a nova regra que você decide usar.

  1. No Visual Studio Code, adicione novas propriedades de cada tipo de ambiente à variável environmentConfigurationMap:

    var environmentConfigurationMap = {
  nonprod: {
    appServiceApp: {
      alwaysOn: false
    }
    appServicePlan: {
      sku: {
        name: 'F1'
        capacity: 1
      }
    }
    toyManualsStorageAccount: {
      sku: {
        name: 'Standard_LRS'
      }
    }
  }
  prod: {
    appServiceApp: {
      alwaysOn: true
    }
    appServicePlan: {
      sku: {
        name: 'S1'
        capacity: 2
      }
    }
    toyManualsStorageAccount: {
      sku: {
        name: 'Standard_ZRS'
      }
    }
  }
}

  2. Altere a configuração do aplicativo alwaysOn a fim de usar o valor do mapa de configuração apropriado para o tipo de ambiente:

    resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
  name: appServiceAppName
  location: location
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
    siteConfig: {
      alwaysOn: environmentConfigurationMap[environmentType].appServiceApp.alwaysOn
      appSettings: [
        {
          name: 'ToyManualsStorageAccountConnectionString'
          value: toyManualsStorageAccountConnectionString
        }
      ]
    }
  }
}

  3. Salve as alterações no arquivo.

  4. No terminal do Visual Studio Code, confirme as alterações e efetue push delas:

    git add .
git commit -m 'Enable App Service Always On for production environments only'
git push

Verifique se o fluxo de trabalho teve êxito

  1. No GitHub, retorne à lista de fluxos de trabalho. Selecione o seu fluxo de trabalho.

  2. Selecione a execução mais recente. Se o fluxo de trabalho ainda estiver em execução, espere um pouco e atualize a página.

    A execução do fluxo de trabalho é exibida.

    Screenshot of the GitHub interface showing the successful workflow run.

    O fluxo de trabalho mostra uma implantação bem-sucedida. Ele foi bem-sucedido dessa vez porque você usou um arquivo válido do Bicep.

Limpar os recursos

Agora que você concluiu o exercício, remova os recursos para não ser cobrado por eles.

No Terminal do Visual Studio Code, execute o seguinte comando:

az group delete --resource-group ToyWebsite --yes --no-wait

O grupo de recursos é excluído em segundo plano.

Remove-AzResourceGroup -Name ToyWebsite -Force