Primeiros passos com Image Processor
Ative Image Processor, mantenha em cache cada transformação separadamente e requisite sua primeira imagem derivada pelo Console, pela CLI ou pela API.
Este guia conduz você pela requisição da sua primeira imagem derivada a partir de uma Application. Ao final, você terá:
- Image Processor ativado em uma Application.
- Um cache setting que armazena cada transformação como um objeto próprio.
- Uma regra do Rules Engine que envia requisições de imagem ao Image Processor.
- Uma imagem redimensionada retornada a partir de uma URL que você escreveu.
Três entidades e uma URL produzem esse resultado, nesta ordem. A Application tem Image Processor ativado. O cache setting pertence à Application e faz o cache armazenar duas transformações diferentes como dois objetos diferentes. A regra pertence à Application, corresponde a requisições de imagem e aplica tanto o cache setting quanto o behavior Optimize Images. A URL da imagem carrega então a transformação na própria query string ims. Uma requisição à qual nenhuma regra corresponde é entregue sem processamento, então é a regra que dá sentido à query string.
Pré-requisitos
Console
- Uma conta Azion.
- Uma Application que já entrega imagens a partir de uma origem. Para criar uma, consulte Primeiros passos com Applications.
- O path de uma imagem que a Application serve, para que você possa requisitá-la ao final.
- Acesso ao Azion Console. Para entrar, consulte Acesse Azion Console.
Ative Image Processor e Application Accelerator
Image Processor é um recurso da plataforma que vem desativado em uma Application nova. Esta etapa ativa dois recursos da plataforma.
Application Accelerator é o segundo por dois motivos. O campo que varia o cache por uma query string pertence a ele, e o cache setting usa esse campo. A regra deste guia também lê ${request_uri}, e a Azion recusa uma regra que o lê enquanto Application Accelerator está desativado. Processar uma imagem não exige Application Accelerator, mas armazenar cada transformação separadamente em cache exige.
Console
Para ativar os dois recursos da plataforma pelo Azion Console:
Acesse Azion Console > Applications > sua Application.
Na seção Modules, ative Image Processor, descrito como Enable dynamic image editing options.
O switch fica na mesma seção.
A Application agora tem os dois recursos da plataforma ativados, e o behavior Optimize Images fica disponível para as suas regras.
Crie um cache setting que varia pela query string ims
Sem esta etapa, o cache não consegue diferenciar uma transformação de outra. Ele pode responder a uma requisição de imagem de 400 pixels com uma de 200 pixels.
Console
Para criar o cache setting pelo Azion Console:
Acesse Azion Console > Applications > sua Application.
Em Name, digite images.
Na seção Cache, defina Cache Behavior como Override cache behavior.
Na seção Cache, em Max Age, digite 31536000.
O painel fica na seção Application Accelerator.
Em Fields, digite ims.
A Application agora tem um cache setting que armazena um objeto por valor distinto de ims.
Para o restante dos campos que um cache setting carrega, incluindo por quanto tempo um objeto permanece em cache, consulte Cache settings.
Crie uma regra que envia as requisições de imagem ao Image Processor
A regra é o que converte a query string em uma transformação. Ela corresponde a requisições de paths de imagem, aplica o cache setting que você criou e carrega o behavior Optimize Images.
Console
Para criar a regra pelo Azion Console:
Acesse Azion Console > Applications > sua Application.
Em Name, digite Optimize images.
Nos critérios, selecione ${request_uri}.
Digite \.(jpg|jpeg|gif|bmp|png|ico|webp|avif).
Nos behaviors, selecione Set Cache Policy e escolha o cache setting images.
Toda requisição para um path com uma dessas extensões agora recebe o cache setting images e o behavior Optimize Images. Image Processor transforma a imagem quando a URL dela carrega ims.
Requisite uma imagem derivada
Peça uma largura e veja a resposta mudar.
Requisite uma das suas imagens com uma query string ims, substituindo o host e o path pelos seus próprios:
A resposta informa o status, o tipo e o tamanho dela:
Requisite a mesma imagem sem query string e compare o tamanho. A resposta redimensionada é menor quando a imagem de origem tem mais de 400 pixels de largura. As duas respostas podem carregar um formato diferente do arquivo na sua origem, porque Image Processor converte as imagens para os navegadores que aceitam outro formato, como WEBP.
Para confirmar que Image Processor, e não a origem, processou a resposta, leia os headers:
Uma resposta processada carrega x-ims: Enabled e o tamanho da imagem de origem antes da transformação:
Agora você tem uma Application que transforma imagens sob demanda, e uma URL que descreve a transformação.