Tutorial: Adicionar a Rede de Entrega de Conteúdo do Azure a um aplicativo Web do Serviço de Aplicativo do Azure

Importante

O Azure CDN Standard da Microsoft (clássico) será desativado em 30 de setembro de 2027. Para evitar qualquer interrupção do serviço, é importante migrar o Azure CDN Standard dos perfis Microsoft (clássicos) para o Azure Front Door Standard ou Premium até 30 de setembro de 2027. Para obter mais informações, consulte Azure CDN Standard da aposentadoria (clássica) da Microsoft.

A CDN do Azure de Edgio será desativada em 4 de novembro de 2025. Você deve migrar sua carga de trabalho para o Azure Front Door antes dessa data para evitar a interrupção do serviço. Para obter mais informações, consulte CDN do Azure das Perguntas frequentes sobre aposentadoria do Edgio.

Este tutorial mostra como adicionar a Rede de Entrega de Conteúdo do Azure a um aplicativo Web no Serviço de Aplicativo do Azure. Aplicativos Web são serviços para hospedar aplicativos Web, APIs REST e back-ends móveis.

Aqui está a home page do exemplo de site HTML estático com o qual você trabalha:

Home page da aplicação de exemplo

O que você aprende:

  • Crie um ponto de extremidade de rede de distribuição de conteúdo.
  • Atualizar ativos em cache.
  • Utilize cadeias de consulta para controlar versões em cache.

Pré-requisitos

Para concluir este tutorial:

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Criar a aplicação Web

Para criar o aplicativo Web com o qual você trabalha, siga o início rápido em HTML estático na etapa Procurar até o aplicativo .

Inicie sessão no portal do Azure

Abra um navegador e entre no portal do Azure.

Otimização de aceleração de site dinâmico

Se quiser otimizar seu ponto de extremidade da rede de entrega de conteúdo para aceleração dinâmica de site (DSA), use o portal da rede de entrega de conteúdo para criar seu perfil e ponto de extremidade. Com otimização DSA, o desempenho das páginas web com o conteúdos dinâmicos foi consideravelmente melhorado. Para obter instruções sobre como otimizar um ponto de extremidade de rede de entrega de conteúdo para DSA a partir do portal de rede de entrega de conteúdo, consulte Configuração de ponto de extremidade de rede de entrega de conteúdo para acelerar a entrega de arquivos dinâmicos. Caso contrário, se não quiser otimizar o seu novo ponto final, pode utilizar o portal da aplicação Web para criá-lo ao seguir os passos da próxima secção. Para a CDN do Azure a partir de perfis Edgio , não é possível alterar a otimização de um ponto de extremidade de rede de entrega de conteúdo depois que ele for criado.

Criar um perfil de rede de entrega de conteúdo e um ponto de extremidade

No painel de navegação esquerdo, selecione Serviço de Aplicações e, em seguida, selecione a aplicação que criou no início rápido HTML estático.

Captura de tela da seleção de um aplicativo do Serviço de Aplicativo no portal.

Na página Serviço de Aplicativo, na seção Configurações, selecione CDN do Azure de Rede>.

Captura de tela da configuração de rede selecionada Rede de Entrega de Conteúdo do Azure de um Serviço de Aplicativo.

Na página Azure Content Delivery Network(Rede de Entrega de Conteúdos do Azure), indique as definições Novo ponto final conforme especificado na tabela.

Captura de ecrã da criação do perfil e ponto de extremidade da Rede de Entrega de Conteúdo do Azure no portal.

Definição Valor sugerido Description
perfil da rede de distribuição de conteúdo myCDNProfile Um perfil de rede de distribuição de conteúdo é uma coleção de pontos de extremidade de rede de entrega de conteúdo com o mesmo nível de preço.
Escalão de preço Rede de distribuição de conteúdo da Microsoft (clássica) O escalão de preço especifica o fornecedor e as funcionalidades disponíveis.
Nome do ponto de extremidade da rede de entrega de conteúdo Qualquer nome que é exclusivo no domínio azureedge.net Aceda aos seus recursos em cache no domínio <endpointname>.azureedge.net.

Selecione Criar para criar um perfil de rede de distribuição de conteúdo.

O Azure cria o perfil e o ponto final. O novo ponto final é apresentado na lista Pontos finais e, quando está aprovisionado, o estado é A executar.

Captura de ecrã do novo ponto de extremidade da Rede de Entrega de Conteúdo do Azure na lista.

Testar o ponto de extremidade da rede de entrega de conteúdo

Dado que a propagação do registo demora algum tempo, o ponto final não está imediatamente disponível para utilização:

  • Para o Azure CDN Standard a partir de perfis Microsoft (clássicos), a propagação geralmente é concluída em 10 minutos.
  • Para os perfis CDN Standard do Azure do Edgio e CDN Premium do Azure do Edgio , a propagação geralmente é concluída em 90 minutos.

A aplicação de exemplo tem um ficheiro index.html e pastas css, img e js que contêm outros elementos estáticos. Os caminhos de conteúdo para todos esses arquivos são os mesmos no ponto de extremidade da rede de entrega de conteúdo. Por exemplo, ambos os seguintes URLs acedem ao ficheiro bootstrap.css na pasta css:

http://<appname>.azurewebsites.net/css/bootstrap.css

http://<endpointname>.azureedge.net/css/bootstrap.css

Navegue até um browser para o seguinte URL:

http://<endpointname>.azureedge.net/index.html

Captura de ecrã da home page da aplicação de exemplo servida a partir da rede de distribuição de conteúdo.

Será apresentada a mesma página que executou anteriormente numa aplicação Web do Azure. A Rede de Entrega de Conteúdo do Azure recuperou os ativos do aplicativo Web de origem e está servindo-os do ponto de extremidade da rede de entrega de conteúdo

Para garantir que essa página seja armazenada em cache na rede de distribuição de conteúdo, atualize a página. Às vezes, duas solicitações para o mesmo ativo são necessárias para que a rede de distribuição de conteúdo armazene em cache o conteúdo solicitado.

Para obter mais informações sobre como criar perfis e pontos de extremidade da Rede de Entrega de Conteúdo do Azure, consulte Introdução à Rede de Entrega de Conteúdo do Azure.

Limpar a rede de distribuição de conteúdo

A rede de entrega de conteúdo atualiza periodicamente seus recursos do aplicativo Web de origem com base na configuração de tempo de vida (TTL). O TTL predefinido é de sete dias.

Às vezes, talvez seja necessário atualizar a rede de entrega de conteúdo antes da expiração do TTL; Por exemplo, quando você implanta conteúdo atualizado no aplicativo Web. Para acionar uma atualização, limpe manualmente os recursos da rede de distribuição de conteúdo.

Nesta seção do tutorial, você implanta uma alteração no aplicativo Web e limpa a rede de entrega de conteúdo para acionar a rede de entrega de conteúdo para atualizar seu cache.

Implementar uma alteração na aplicação Web

Abra o ficheiro index.html e adicione -V2 ao cabeçalho H1, conforme mostrado no seguinte exemplo:

<h1>Azure App Service - Sample Static HTML Site - V2</h1>

Consolide as alterações e implemente-as na aplicação Web.

git commit -am "version 2"
git push azure main

Depois de concluída a implementação, navegue para o URL da aplicação Web para ver a alteração.

http://<appname>.azurewebsites.net/index.html

V2 no título na aplicação Web

Se você navegar até a URL do ponto de extremidade da rede de entrega de conteúdo da página inicial, não verá as alterações porque a versão armazenada em cache na rede de entrega de conteúdo ainda não expirou.

http://<endpointname>.azureedge.net/index.html

Captura de tela de No V2 no título na rede de distribuição de conteúdo.

Limpar a rede de distribuição de conteúdo no portal

Para acionar a rede de distribuição de conteúdo para atualizar sua versão em cache, limpe a rede de entrega de conteúdo.

Na navegação à esquerda do portal, selecione Grupos de recursos e, em seguida, selecione o grupo de recursos que criou a sua aplicação Web (myResourceGroup).

Captura de ecrã a mostrar a seleção do grupo de recursos a partir do painel de menu esquerdo no portal.

Na lista de recursos, selecione o ponto de extremidade da rede de distribuição de conteúdo.

Captura de ecrã do ponto de extremidade da Rede de Entrega de Conteúdo do Azure do grupo de recursos.

Na parte superior da página Ponto final, selecione Remover.

Captura de ecrã do botão de limpeza num perfil da Rede de Distribuição de Conteúdo do Azure.

Introduza os caminhos do conteúdo que quer remover. Pode transmitir um caminho de ficheiro completo para remover um ficheiro individual ou um segmento de caminho para remover e atualizar todo o conteúdo numa pasta. Como alterou o index.html, certifique-se de que está num dos caminhos.

Na parte inferior da página, selecione Remover.

Captura de ecrã da página de limpeza num perfil da Rede de Distribuição de Conteúdo do Azure.

Verifique se a rede de distribuição de conteúdo está atualizada

Aguarde até que o pedido de remoção conclua o processamento, que demora normalmente alguns minutos. Para ver o estado atual, selecione o ícone da campainha na parte superior da página.

Captura de ecrã da notificação de limpeza para um perfil da Rede de Distribuição de Conteúdo do Azure.

Quando você navega para a URL do ponto de extremidade da rede de entrega de conteúdo para index.html, você vê a V2 que você adicionou ao título na página inicial, o que indica que o cache da rede de entrega de conteúdo foi atualizado.

http://<endpointname>.azureedge.net/index.html

Captura de tela de V2 no título na rede de distribuição de conteúdo.

Para obter mais informações, consulte Limpar um ponto de extremidade da Rede de Entrega de Conteúdo do Azure.

Utilizar cadeias de consulta para o conteúdo da versão

A Rede de Entrega de Conteúdo do Azure oferece as seguintes opções de comportamento de cache:

  • Ignorar cadeias de consulta
  • Ignorar a colocação em cache de cadeias de consulta
  • Colocar em cache todos os URLs exclusivos

A primeira opção é o padrão, o que significa que há apenas uma versão em cache de um ativo, independentemente da cadeia de caracteres de consulta na URL.

Nesta secção do tutorial, pode alterar o comportamento de colocação em cache para colocar em cache todos os URL exclusivos.

Alterar o comportamento de cache

Na página Ponto Final CDN do portal do Azure, selecione Cache.

Selecione Armazenar em cache cada URL exclusivo na lista suspensa Comportamento de cache de cadeia de caracteres de consulta.

Selecione Guardar.

Captura de ecrã das definições de regras de cache para um perfil da Rede de Distribuição de Conteúdo do Azure.

Certifique-se de que os URL exclusivos são colocados em cache em separado

Em um navegador, navegue até a página inicial no ponto de extremidade da rede de entrega de conteúdo e inclua uma cadeia de caracteres de consulta:

http://<endpointname>.azureedge.net/index.html?q=1

A Rede de Entrega de Conteúdo do Azure retorna o conteúdo atual do aplicativo Web, que inclui V2 no cabeçalho.

Para garantir que essa página seja armazenada em cache na rede de distribuição de conteúdo, atualize a página.

Abra index.html, altere V2 para V3 e, em seguida, implemente a alteração.

git commit -am "version 3"
git push azure main

Em um navegador, vá para a URL do ponto de extremidade da rede de entrega de conteúdo com uma nova cadeia de caracteres de consulta, como q=2. A Rede de Entrega de Conteúdo do Azure obtém o arquivo index.html atual e exibe a V3. No entanto, se você navegar até o ponto de extremidade da rede de entrega de conteúdo com a cadeia de caracteres de q=1 consulta, verá V2.

http://<endpointname>.azureedge.net/index.html?q=2

Captura de tela de V3 no título na rede de distribuição de conteúdo, cadeia de caracteres de consulta 2.

http://<endpointname>.azureedge.net/index.html?q=1

Captura de tela de V2 no título na rede de distribuição de conteúdo, cadeia de caracteres de consulta 1.

Este resultado mostra que cada cadeia de consulta é tratada de forma diferente:

  • q=1 foi utilizado antes, pelo que os conteúdos armazenados em cache são devolvidos (V2).
  • q=2 é novo, pelo que os conteúdos mais recentes da aplicação Web são obtidos e devolvidos (V3).

Para obter mais informações, consulte Controlar o comportamento de cache da Rede de Entrega de Conteúdo do Azure com cadeias de caracteres de consulta.

Clean up resources (Limpar recursos)

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se achar que não vai precisar destes recursos no futuro, execute o seguinte comando no Cloud Shell para eliminar o grupo de recursos:

az group delete --name myResourceGroup

Este comando pode demorar alguns minutos a ser executado.

Próximos passos

O que aprendeu:

  • Crie um ponto de extremidade de rede de distribuição de conteúdo.
  • Atualizar ativos em cache.
  • Utilize cadeias de consulta para controlar versões em cache.

Saiba como otimizar o desempenho da rede de distribuição de conteúdo nos seguintes artigos: