Aplicar atualizações ao modelo

Concluído

O processo inicial azd de provisionamento e implantação é uma ótima maneira de começar a usar seu aplicativo no Azure. No entanto, depois que o ambiente estiver em execução, você desejará começar a fazer alterações no código do aplicativo ou no ambiente do Azure.

Há alguns fluxos de trabalho diferentes para escolher para atualizar seu ambiente do Azure depois de fazer alterações no modelo azd. Você sempre pode executar azd up novamente para atualizar seu ambiente, independentemente de ter alterado o código do aplicativo ou os arquivos de infraestrutura. azd up concluirá o pacote, provisionará e implantará as etapas sempre que ele for executado, portanto, é uma maneira simples de garantir que todas as alterações sejam enviadas por push para o Azure.

No entanto, azd também oferece comandos mais granulares que são mapeados para estágios específicos do fluxo de trabalho do desenvolvedor. Esses comandos também podem economizar tempo ignorando verificações ou etapas desnecessárias que você sabe que não foram alteradas.

  • azd deploy – Esse comando empacota e reimplanta o código-fonte do aplicativo no Azure. No entanto, ele não executará nenhuma infraestrutura como arquivos de código que aplicam alterações aos recursos do Azure.

  • azd provision – Este comando cria ou atualiza os recursos do Azure com base nas alterações em sua infraestrutura como arquivos de código. Por exemplo, azd provision criará uma nova conta de armazenamento no Azure se você adicioná-la aos arquivos Bicep ou Terraform. No entanto, esse comando não empacota nem reimplanta o código-fonte do aplicativo.

Atualizar o código do aplicativo

Sua equipe está criando um aplicativo de gerenciamento de tíquetes, não um aplicativo Todo, portanto, você deseja alterar o texto do cabeçalho de acordo. Conclua as seguintes etapas para atualizar o código do aplicativo e reimplantar as alterações usando azd:

  1. Localize o arquivo header.tsx no diretório src/web/src/layout do modelo. Se você estiver usando o Visual Studio Code, também poderá usar o atalho ctrl + p para pesquisar o arquivo header.tsx diretamente.

  2. Altere o texto de exibição do cabeçalho em torno da linha 42 de Todo para Ticket Manager e salve suas alterações.

    <Stack horizontal styles={logoStyles}>
        <FontIcon aria-label="Check" iconName="SkypeCircleCheck" className={logoIconClass} />
        <Text variant="xLarge">Ticket Manager</Text>
    </Stack>
    
  3. Em uma janela de prompt de comando definida como a raiz do diretório, execute o comando azd deploy. Aguarde um momento enquanto azd reimplanta o código.

    azd deploy
    
  4. Quando o comando for concluído, confira seu aplicativo no navegador. O texto no canto superior esquerdo do cabeçalho agora deve ler Gerenciador de Tíquetes.

Atualizar os recursos do Azure

Sua equipe está planejando adicionar a capacidade de os usuários carregarem arquivos com seus tíquetes, como imagens ou capturas de tela de um problema que estão enfrentando ou outros documentos de serviço. Você deseja adicionar uma conta de Armazenamento do Azure ao seu ambiente que armazenará esses arquivos. Você também deseja garantir que a conta de armazenamento seja incluída durante a configuração inicial quando esse modelo for provisionado para ambientes futuros. Você pode atender a esses requisitos modificando a infraestrutura como arquivos de código para seu modelo usando as seguintes etapas:

  1. Na pasta infra da raiz de seu modelo, abra o arquivo main.bicep.

  2. O modelo já contém um módulo Bicep reutilizável para criar contas de armazenamento, para que você possa usá-lo para adicionar o seu próprio. Cole o seguinte trecho de código na parte inferior do arquivo main.bicep ao redor da linha 180 acima, onde as variáveis ​​de saída são definidas:

    module storage './core/storage/storage-account.bicep' = {
      name: 'storage'
      scope: rg
      params: {
        name: '${abbrs.storageStorageAccounts}${resourceToken}'
        location: location
        tags: tags
      }
    }
    
  3. Salve todas as alterações, depois execute o seguinte comando azd provision. azd provision usará a infraestrutura como arquivos de código em seu modelo para atualizar seu ambiente do Azure, mas não reimplantará nenhum código-fonte do aplicativo.

    azd provision
    
  4. Quando o comando for concluído, siga a URL que o console imprime para iniciar o portal do Azure no navegador. Você deverá ver o grupo de recursos que contém todos os recursos provisionados originalmente, incluindo a nova conta de armazenamento.

    Uma captura de tela mostrando a conta de armazenamento implantada.

Observação

Ao trabalhar com azd, lembre-se de que a infraestrutura como arquivos de código é idempotente, ou seja, não importa quantas vezes você os execute, o estado final desejado permanecerá consistente. O Bicep ou Terraform aplicará alterações no Azure para que seu ambiente corresponda ao estado de seus arquivos de infraestrutura, mas as alterações não serão aplicadas a recursos que já correspondem ao estado desejado.