Applications
Encaminhe requisições, armazene respostas em cache e execute código com as regras de uma Application, e ative Application Accelerator ou Image Processor.
Applications é um recurso da plataforma que processa as requisições recebidas pelos seus Workloads. Uma Application pode executar funções serverless, atuar como proxy reverso para as suas origens ou combinar os dois, na infraestrutura distribuída da Azion, a partir do data center mais próximo ao seu usuário. Uma função serverless é uma Function, um código executado sob demanda a cada requisição, sem um servidor para você provisionar. Um proxy reverso é um servidor na frente da sua origem, o servidor que guarda o seu conteúdo. O proxy pode responder a cada requisição com uma cópia em cache de uma resposta anterior da origem, adicionar ou remover headers ou encaminhar a requisição à sua origem. Toda requisição passa pelo proxy, então os seus clientes acessam um único domínio, e o proxy aplica a lógica que cada origem teria de repetir.
Uma Application recebe as requisições de um Workload depois que o deployment desse Workload define essa Application. Em cada requisição, a Application executa as suas regras. Uma regra pode definir o Connector que encaminha a requisição à sua origem, decidir se a resposta é armazenada em cache ou executar uma Function. Use Applications para encaminhar cada path à sua origem, armazenar respostas em cache, adicionar ou remover headers, reescrever requisições, executar o seu próprio código nas requisições a que uma regra corresponde ou redimensionar e converter imagens sob demanda.
Primeiros passos Referência de ApplicationsCaminho da requisição
Criar uma Application não encaminha nenhuma requisição a ela: antes, o deployment de um Workload precisa definir essa Application. Uma Application também só chega a uma origem por meio de uma regra que define um Connector. O diagrama acompanha uma requisição que segue esse caminho. No lugar de uma origem, uma Function pode responder a uma requisição: uma regra executa a Function com Run Function, e a Function constrói a resposta sem nenhum Connector.
As setas sólidas levam a requisição, e as setas pontilhadas levam a resposta. Cada rótulo começa com o número do seu passo abaixo.
- A requisição chega a um Workload por um dos domínios dele, e o deployment do Workload define a Application. No Azion Console, você define essa Application no campo Application de Deployment Settings. Um Firewall que o deployment também define executa as suas regras primeiro e pode interromper a requisição ali.
- As regras da Request Phase da Application são executadas em ordem. Quando um behavior, a ação que uma regra executa, encerra o processamento, como faz Deny (403 Forbidden), a Application responde ao cliente e nenhuma regra posterior é executada.
- Se uma regra com o behavior Set Cache Policy aplicou um cache setting, Cache procura uma cópia válida da resposta da origem. Quando Cache tem uma, essa cópia se torna a resposta, e a origem não recebe nenhuma requisição.
- Caso contrário, o Connector definido por uma regra com Set Connector encaminha a requisição à origem. Se várias regras que correspondem à requisição carregam Set Connector, somente a última delas é executada.
- Depois, as regras da Response Phase da Application são executadas sobre a resposta, e a resposta chega ao cliente.
Uma Application nova começa com Cache e Functions ativos, Application Accelerator e Image Processor desativados e nenhuma regra.
Uma alteração não vale de imediato: ela se propaga, e a Azion não garante nenhum tempo de propagação. Até que o deployment de um Workload novo se propague, o que pode levar vários minutos, o Workload responde com o 404 de placeholder da Azion. Nesse intervalo, as respostas se alternam entre o placeholder e a resposta da Application, então repita a requisição até que elas concordem. Para o funcionamento das duas fases, a ordem das regras e dos behaviors e a propagação, consulte Como Applications funciona.
Estrutura da regra
Uma regra é a unidade de lógica de uma Application. Os critérios dela testam cada requisição, e os behaviors dela são executados sobre uma requisição que corresponde a eles. Para encaminhar toda requisição ao Connector que alcança a sua origem, envie esta regra como corpo de POST /v4/workspace/applications/<application-id>/request_rules:
criteriaguarda grupos de condições, e cada grupo começa com uma condição cujoconditionaléif. Aqui,${uri}é a URI sem a query string. Todo path começa com/, entãostarts_withe/correspondem a toda requisição. Se a regra testar${request_uri}, que mantém a query string, no lugar de${uri}, a API a recusa com400e o erro25047enquanto Application Accelerator está desativado.behaviorslista as ações que a regra executa sobre uma requisição que corresponde a ela.set_connectorencaminha a requisição ao Connector cujo ID está emattributes.value. Esse Connector guarda o endereço da sua origem.nameeactivepertencem à própria regra.- Você também pode montar a mesma regra no Azion Console, como mostra Primeiros passos com Applications.
Quando você envia a regra, a API responde 202 e a retorna com order igual a 0. Esse valor é a posição da regra entre as regras da Request Phase da Application.
O modelo corresponde ao roteamento por path em um proxy reverso: cada critério é uma condição de correspondência, cada behavior é uma ação e um Connector guarda o endereço do servidor de backend.
Recursos
Cache, Application Accelerator e Image Processor agem sobre as requisições de uma Application. Cada Application ativa Application Accelerator e Image Processor separadamente, e Main Settings mostra onde, no Azion Console e na API.
Cache
Cache é um recurso da plataforma que armazena cópias das respostas às requisições recebidas por uma Application. Cada cópia fica no data center que a armazenou, e as requisições seguintes pelo mesmo objeto recebem essa cópia até que o tempo de vida (TTL) dela termine. Cache está sempre ativo em uma Application. Ele começa a armazenar cópias quando uma regra com Set Cache Policy aplica um cache setting, que guarda os TTLs. Use Cache para:
- Manter arquivos estáticos no data center mais próximo ao seu usuário
- Entregar arquivos de vídeo grandes em fragmentos, com a Large File Optimization ativada no cache setting
- Responder às requisições com uma cópia expirada quando a origem não responde, com o stale cache ativado no cache setting
- Remover uma cópia quando a origem muda, com Real-Time Purge
A visão geral do Cache explica o que um cache setting guarda, como uma requisição chega a uma cópia armazenada e por onde começar.
Application Accelerator
Application Accelerator é um recurso da plataforma que libera quatro capacidades para o cache e para as regras de uma Application: a variação de cache, o cache de respostas POST e OPTIONS, um Max Age menor que 60 segundos e mais behaviors e variáveis do Rules Engine. Com a variação de cache, um cache setting diferencia duas requisições para a mesma URL por um argumento de query string, um cookie, o device group ou o método da requisição, e Cache mantém uma cópia separada para cada valor. Application Accelerator começa desativado em uma Application nova. Ative-o quando uma URL tem mais de uma resposta correta, por exemplo:
- Uma página personalizada
- Uma resposta de API que muda com a sua query string
- Um catálogo que difere por dispositivo
- Uma resposta a um
POST
A visão geral do Application Accelerator explica o que uma variação acrescenta à cache key, o que ativá-lo libera e por onde começar.
Image Processor
Image Processor é um recurso da plataforma que constrói uma imagem nova, a imagem derivada, a partir de uma imagem na sua origem. A query string ims da requisição descreve a imagem derivada, como ?ims=fit-in/400x400, e, mesmo sem a query string ims, Image Processor pode converter uma imagem para um formato que o navegador aceita. Ele retorna a imagem derivada sem salvá-la como um ativo da conta. Ele começa desativado em uma Application nova e, mesmo ativo, Image Processor processa somente as requisições às quais uma regra da Request Phase com Optimize Images corresponde. Ative-o quando as suas páginas precisam de uma imagem em vários tamanhos, recortes, qualidades ou formatos, como WEBP para os browsers que o aceitam. Todas as variantes saem, então, de um único arquivo na sua origem, e você armazena e faz upload só desse arquivo.
A visão geral do Image Processor explica como uma requisição se torna uma imagem derivada, o que ims aceita e por onde começar.
Escopo e limites
- Fases: toda regra pertence a uma de duas fases. A Request Phase age sobre a requisição antes que exista uma resposta, e a Response Phase age sobre a resposta que o usuário recebe. Você escolhe a fase quando cria a regra e não pode mudá-la depois. Somente as regras da Request Phase podem escolher a origem e o cache setting. Rules Engine para Applications lista as variáveis e os behaviors de cada fase e o recurso da plataforma de que cada um precisa.
- Origens: uma Application chega a cada origem por meio de um Connector, então duas regras com dois Connectors podem encaminhar
/api/para um servidor e todos os outros paths para outro. A origem por trás de um Connector pode ser um servidor web na sua infraestrutura, um serviço em cloud ou um bucket do Object Storage. Use um bucket como origem de uma aplicação mostra o caso do bucket. Com Load Balancer ativado, um Connector do tipohttppode distribuir o tráfego entre várias origens. Os Connectors substituem as origens que as versões anteriores de Applications configuravam na Application. - Functions: uma Function Instance vincula uma das suas Functions à Application, com os seus próprios argumentos. Uma Function Instance pertence a uma Application, e ela só é executada quando uma regra com Run Function invoca essa Function Instance. Functions começa ativo em uma Application nova, no campo
modules.functions.enableddela na API. Somente Functions escritas em Lua são executadas na Response Phase, como informa o formulário da Function Instance no Azion Console:Only Lua functions can be used in the Response phase.Para os passos de adicionar a sua primeira Function, consulte Instancie uma função em uma aplicação. - Cache e imagens em código: o código que lê ou grava entradas em cache é executado em uma Function e usa a Cache API, porque o próprio Cache não pode executar código. Uma Function que processa imagens por conta própria usa a biblioteca WASM Image Processor, que é separada do recurso da plataforma Image Processor. Onde Image Processor para explica a diferença.
- Dispositivos: um device group é um nome e uma expressão regular que a Application compara com o header
User-Agentde cada requisição. Os dois usos de um grupo precisam de Application Accelerator ativo: uma regra testa o grupo por meio de${device_group}, e um cache setting pode manter uma cópia por grupo. Boas práticas de Applications mostra como escrever uma expressão que corresponda somente aos dispositivos que você pretende alcançar. - WebSocket: WebSocket Proxy é uma feature de Applications que transporta uma conexão WebSocket entre os seus usuários e a origem. A conexão abre com os headers
Upgrade: websocketeConnection: upgrade. A Azion ativa a feature em uma conta somente mediante solicitação, e Diretrizes de suporte explica como pedir. Como a Azion recicla as conexões keepalive aproximadamente a cada 15 minutos, o cliente precisa reabrir uma conexão WebSocket quando ela se fecha. - Workloads: um Workload guarda os domínios, os protocolos e os certificados que servem a Application, então você configura a entrega no Workload, não na Application. Teste uma aplicação pelo arquivo hosts mostra como requisitar uma Application no seu próprio domínio a partir de um dispositivo antes de alterar os registros DNS dele. Redirect HTTP to HTTPS só funciona quando o Workload tem HTTPS. Quando o Connector recebe uma resposta 4xx ou 5xx da sua origem, Custom Pages no Workload define a página de erro que o cliente vê.
- Interfaces: no Azion Console, você cria e gerencia as suas Applications na página Applications, onde cada Application tem cinco abas: Main Settings, Device Groups, Cache Settings, Functions Instances e Rules Engine. No Console, a ação de linha Clone da lista Applications cria uma Application separada com as configurações da original, como mostra Clone uma aplicação. Azion API serve as suas Applications em
/v4/workspace/applications, e Azion CLI as gerencia com comandos comoazion create application,azion update applicationeazion create rules-engine. Você também pode criar e configurar as suas Applications comazion.config.js, Azion Lib ou Azion Terraform Provider. Se a sua conta não migrou para a API v4, use Applications | v3. - Observabilidade: com Debug Rules ativo, Real-Time Events e Data Stream mostram as regras que cada requisição executou, no campo
$traceback. Debug Rules começa desativado em uma Application nova. Ele é o campodebugda Application na API, e Main Settings mostra onde ativá-lo no Azion Console. Para verificar uma resposta, envie a requisição comPragma: azion-debug-cache: a resposta informa o seu status de cache, comoHITouMISS, no headerx-cache. Em todas as requisições, Real-Time Metrics mostra o tráfego de Cache e de Tiered Cache. Solucione problemas de Applications lista as ferramentas e as consultas. Para um tráfego que difere do que você vê, consulte Um problema aparece no tráfego, mas não nas respostas que você solicita. - Limites: uma Application aceita no máximo 200 regras, somando as duas fases. Cada regra tem de 1 a 5 grupos de 1 a 10 critérios, além de 1 a 10 behaviors. Sem Application Accelerator, um cache setting precisa de um Max Age, o seu campo
modules.cache.max_age, de no mínimo 60 segundos. Um único objeto em cache pode chegar a 10 GB. Limites de Applications lista cada limite, o que acontece quando ele é ultrapassado e os limites de cada recurso da plataforma aninhado em Applications. - Cobrança: um recurso da plataforma que você ativa pode gerar custos que dependem do uso. A página Preços da Azion lista os planos e o uso que cada plano inclui, e Preços lista as tarifas e a métrica pela qual cada recurso da plataforma é cobrado.
- Termos: o glossário de Applications define as palavras que as páginas de Applications usam com um significado específico, como regra, fase, behavior, cache setting, cache key e imagem derivada.