Aplicar atualizações ao seu 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, quando o ambiente estiver em execução, você desejará começar a fazer alterações no código do seu 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 azd modelo. 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á as etapas de pacote, provisionamento e implantação sempre que ele for executado, portanto, é uma maneira simples de garantir que todas as suas alterações sejam enviadas para o Azure.

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

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

  • azd provision - Este comando cria ou atualiza recursos do Azure com base em alterações na sua infraestrutura como arquivos de código. Por exemplo, azd provision cria uma nova conta de armazenamento no Azure se você adicioná-la aos seus arquivos Bicep ou Terraform. No entanto, esse comando não empacota ou 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, então você deseja alterar o texto do cabeçalho de acordo. Conclua as etapas a seguir para atualizar o código do aplicativo e reimplantar as alterações usando azd:

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

  2. Altere o texto de exibição do cabeçalho ao redor da linha 42 de Todo para Ticket Manager e salve as 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 azd deploy comando. Aguarde um momento enquanto azd reimplanta seu código.

    azd deploy
    
  4. Quando o comando terminar, revisite seu aplicativo no navegador. O texto no canto superior esquerdo do cabeçalho deve agora ler Ticket Manager.

Atualizar os recursos do Azure

Sua equipe está planejando adicionar a capacidade de os usuários carregarem arquivos com seu ticket, como imagens ou capturas de tela de um problema que estão encontrando, 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. infra Na pasta na raiz do modelo, abra o main.bicep arquivo.

  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 em torno da linha 180 acima, onde as variáveis de main.bicep 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 as alterações e execute o azd provision comando. 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 seu aplicativo.

    azd provision
    
  4. Quando o comando terminar, siga a URL que o console imprime para iniciar o portal do Azure em seu navegador. Você 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.

Nota

Ao trabalhar com azdo , tenha em mente 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 o Terraform aplicarão alterações ao 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á correspondam ao estado desejado.