Main Settings

Main Settings é o conjunto de valores que se aplicam a uma Application como um todo: o nome, os recursos da plataforma ativados nela, se ela registra as regras que cada requisição executa e se ela está ativa. Azion Console agrupa esses valores na aba Main Settings da Application, e a API os retorna como campos da Application. Para o caminho que uma requisição percorre em uma Application, consulte Como Applications funciona.

Seções e campos

No Azion Console, a aba Main Settings de uma Application tem quatro seções: General, Modules, Debug Rules e Status. A aba traz Cancel e Save, e uma alteração é salva com Save.

Cada seção corresponde a um ou mais campos da Application na API. A última coluna traz o valor que cada campo assume quando uma requisição de criação envia apenas name e active.

Por exemplo, uma Application que você cria pela API apenas com name e active tem Cache e Functions ativados desde o início. Application Accelerator fica desativado até você ativá-lo.

O status, o boolean active na API, desativa a Application e a ativa de novo sem excluí-la.

Recursos da plataforma

No Azion Console, os switches que ativam ou desativam recursos da plataforma em uma Application ficam na seção Modules, e cada Application mantém o próprio conjunto. O grupo Default Modules dessa seção tem um switch por recurso da plataforma: Application Accelerator, Cache, Functions e Image Processor. Um grupo Subscription modules traz uma ação Contact sales, e a seção informa Some modules require subscription.

No Azion Console, o formulário do Rules Engine marca um behavior cujo recurso da plataforma está desativado com - Required Application Accelerator, - Required Function ou - Required Image Processor. Um cache setting também precisa de Application Accelerator para as variações do seu objeto modules.application_accelerator, e para um Max Age, o seu campo modules.cache.max_age, menor que 60 segundos.

Os cache settings e as Function Instances pertencem à Application, fora de Main Settings. Um behavior Set Cache Policy aplica um cache setting, e um behavior Run Function invoca uma Function Instance. Primeiros passos com Cache e Instancie uma função em uma aplicação mostram onde criar cada um no Azion Console.

Cache fica sempre ativado em uma Application: a API recusa modules.cache.enabled definido como false com o erro 31001, Cache Cannot Be False. Azion Console mostra o switch Cache travado como ativado, com a nota Automatically enabled in all accounts. Você pode ativar outro recurso da plataforma quando a sua conta oferece suporte a ele, e desativá-lo quando nada na Application depende dele. Ativar um recurso da plataforma pode gerar custos relacionados ao uso. Para mais informações, consulte Preços.

Enquanto Application Accelerator está desativado, a API recusa uma regra de requisição cujo critério lê ${request_uri}. Ela também recusa um cache setting que varia o cache por método, query string, cookie ou device group, ou que define um Max Age menor que 60 segundos. Cada recusa traz um dos códigos da seção Erros, e a mesma regra com ${uri} é aceita. Para as variáveis e os behaviors que cada recurso da plataforma adiciona, consulte Rules Engine para Applications.

Tiered Cache não é um dos quatro switches de modules de uma Application: é uma feature de Cache, e cada cache setting o ativa no seu campo modules.cache.tiered_cache.enabled.

Debug Rules

Debug Rules registra as regras do Rules Engine executadas em cada requisição à Application. A configuração fica desativada quando você cria uma Application, e a API a guarda no boolean debug. No Azion Console, o switch Active da seção Debug Rules define essa configuração. Na Azion CLI, --debug-enabled define essa configuração em azion create application e em azion update application.

Com Debug Rules ativado, as regras executadas em uma requisição aparecem no campo $traceback do Data Stream e do Real-Time Events. A API GraphQL do Real-Time Events retorna as mesmas regras no campo stacktrace. Uma regra que não está nessa lista não foi executada na requisição.

Por exemplo, uma regra Set Cache Policy pode parecer sem efeito em um path. O $traceback de uma requisição a esse path mostra, então, se a regra chegou a ser executada. Para as consultas que leem o campo em cada ferramenta, consulte Depure regras criadas com Rules Engine.

Configurações de entrega e protocolo

Domínios, protocolos e certificados pertencem a um Workload, então você configura a entrega no Workload, não em Main Settings. Um Workload recebe cada requisição, e o deployment desse Workload define a Application que processa a requisição. No Azion Console, você define essa Application no campo Application das Deployment Settings do Workload.

Em uma conta que não migrou para a API v4, a própria Application guarda os protocolos de entrega, as portas e as configurações de TLS. Para essas configurações, consulte Main Settings | v3.

API

A API serve as suas Applications em https://api.azion.com/v4/workspace/applications. Cada chamada se autentica com um personal token no header Authorization: Token [TOKEN VALUE], e uma chamada com corpo também envia Content-Type: application/json.

Uma criação e um PATCH respondem 202, com state definido como pending. Uma listagem e uma leitura respondem 200.

name é o único campo que uma requisição de criação exige. Esta chamada cria uma Application apenas com um nome e um status:

A API responde 202. Neste trecho do corpo, modules e debug trazem os valores que a plataforma definiu na criação:

O id em data identifica a Application em todas as chamadas seguintes, incluindo os paths das regras dela, como /workspace/applications/<application-id>/request_rules.

Esta chamada ativa Application Accelerator em uma Application existente:

A API responde 202 com state definido como pending. Um corpo com functions no lugar de application_accelerator ativa Functions da mesma forma, e a resposta repete o objeto modules com as quatro chaves.

CLI

Azion CLI lê e altera uma Application com seis comandos sob o substantivo application. Cada flag de um recurso da plataforma recebe uma string, como true.

A flag de Functions é --function em azion create application e --functions em azion update application. Em azion delete application, --cascade também exclui os recursos que azion deploy criou, e o padrão dela é true.

Este comando ativa Application Accelerator:

A saída de azion describe application inclui o objeto modules da Application:

Em uma Application com os quatro recursos da plataforma ativados, o objeto fica assim:

Erros

Um recurso da plataforma desativado na Application aparece como a recusa do objeto que precisa dele, com 400. Cada uma dessas recusas nomeia Application Accelerator, exceto 31001, que recusa desativar Cache. Este corpo responde a uma regra de requisição com ${request_uri}:

meta.missing_required_modules lista as chaves que devem ser ativadas no objeto modules da Application.

Recursos relacionados