O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Vamos começar

Esta página ajuda você a começar a usar a otimização de imagens do Cloud CDN, explicando como configurar a otimização de imagens e a lista de operações compatíveis com exemplos.

Pré-requisitos

Para que a otimização de imagens do Cloud CDN funcione, verifique se os seguintes pré-requisitos foram atendidos:

A política de cache do Cloud CDN precisa estar ativada na rota do URL ou no serviço de back-end ou bucket associado, e o recurso de otimização de imagens precisa estar ativo nessa rota do mapa de URL.
A otimização de imagens é compatível apenas com balanceadores de carga de aplicativo externos globais. O balanceador de carga de aplicativo clássico não é compatível.
A solicitação do cliente precisa incluir um cabeçalho "Accept" indicando que ele pode receber conteúdo de imagem, como image/webp, image/avif, image/* ou */*.
O servidor de origem precisa responder com um código de status HTTP 200 e um cabeçalho Content-Type de imagem compatível.
O parâmetro de consulta imop precisa ser incluído no URL e conter uma ou mais operações de transformação válidas.

Configurar a otimização de imagens

A otimização de imagens requer um armazenamento em cache ativo. Verifique se você configurou pelo menos um dos seguintes:

Armazenamento em cache baseado em back-end: verifique se a opção Ativar o Cloud CDN está marcada no back-end.
Armazenamento em cache no nível do mapa de URL: verifique se uma política de cache está configurada no nível do mapa de URL para o caminho específico em que você planeja ativar a otimização de imagens.

gcloud

É necessário adicionar configurações ao arquivo YAML e importá-lo para o mapa de URL, já que as políticas de otimização de imagens são definidas dentro do objeto routeAction.

Exporte a configuração do mapa de URL atual para um arquivo YAML local:

gcloud beta compute url-maps export YOUR_URL_MAP_NAME \
    --global \
    --destination my-url-map.yaml

Edite o arquivo my-url-map.yaml em um editor de texto e adicione o campo imageOptimizationPolicy às seções routeAction ou defaultRouteAction selecionadas.

name: image-matcher
routeRules:
  - description: ImageOptimizationService
    matchRules:
      - prefixMatch: /images/
    priority: 1
    routeAction:
      imageOptimizationPolicy:
        queryParameterInterpretation: ENABLED

Importar o mapa de URL atualizado

gcloud beta compute url-maps import YOUR_URL_MAP_NAME \
    --global \
    --source my-url-map.yaml

Console

No console do Google Cloud , acesse a página Balanceamento de carga.
Acessar a página "Balanceamento de carga"
Clique no nome do balanceador de carga de aplicativo externo global.
Clique em Editar .
Acesse a guia Configuração de back-end.
Configurar o armazenamento em cache:a otimização de imagens requer o armazenamento em cache ativo para ser salvo. Escolha e configure uma das opções a seguir para que a otimização de imagens funcione.
- Baseado em back-end:verifique se a opção Ativar o Cloud CDN está selecionada nas configurações do serviço de back-end.
- Nível do mapa de URL:
  1. Acesse Regras de roteamento e selecione Regra avançada de host e caminho.
  2. Defina uma política de cache no nível do mapa de URL na rota em que você está ativando a otimização de imagens.

Dependendo da arquitetura de roteamento, selecione uma das regras de roteamento:

Para usar a regra de roteamento padrão, faça o seguinte:

Na seção Regras de host e caminho , em Ação , selecione Encaminhar o tráfego para um único modo de back-end e, em seguida, selecione um back-end na lista.
Expanda a seção de otimização de imagens (recolhida por padrão).
Marque a caixa de seleção Ativar a otimização de imagens.

Para usar a regra de roteamento personalizada, faça o seguinte:

Na seção Regras de host e caminho, selecione Adicionar regra de host e caminho.
No campo Hosts, insira * para corresponder a todos os nomes de host.
Na seção Correspondedor de caminho, use o editor YAML para definir sua configuração.
Clique em Orientação de código abaixo do editor YAML para receber orientações sobre o código.
Copie o snippet e cole-o no editor YAML.
Atualize os valores do marcador.

Revisar configurações

Revise suas configurações.
Clique em Concluído para fechar o subeditor.
Clique em Atualizar para salvar suas configurações.

Formatos de imagem compatíveis

A otimização de imagens do Cloud CDN oferece suporte a uma ampla variedade de formatos de entrada do servidor de origem. Embora a maioria dos formatos possa ser usada para processamento e saída, alguns formatos são apenas de entrada e não podem ser usados como formatos de saída de destino.

Os seguintes formatos de imagem são compatíveis com o servidor de origem:

Formato	Cabeçalho Content-Type	Entrada/Saída	Cenário de caso de uso
gif	`image/gif`	Entrada e saída	Formato animado/estático padrão. Os frames animados podem ser extraídos usando a operação `Freeze`.
png	`image/png`	Entrada e saída	Formato sem perdas, ideal para transparência, logotipos e arte digital.
webp	`image/webp`	Entrada e saída	Formato moderno e otimizado para a Web com compactação com e sem perda.
jpeg	`image/jpeg`	Entrada e saída	Formato fotográfico padrão.
brunsli	`image/x-j`	Entrada e saída	Formato de recompactação JPEG sem perdas de alta eficiência.
tiff	`image/tiff`	Entrada e saída	Formato raster baseado em tags de alta qualidade.
avif	`image/avif`	Entrada e saída	Formato de imagem de próxima geração de alta eficiência.
bmp	`image/bmp`	Apenas entrada	Não pode ser especificado como um formato de saída. Converta para WebP ou JPEG usando `?imop=Convert,format=webp`.
ico	`text/ico`, `image/ico`, `image/icon`, `application/ico`, `image/x-icon`, `image/vnd.microsoft.icon`	Apenas entrada	Formato de contêiner de ícone. Não pode ser exportado. Converta para um formato de saída compatível para entrega.
jp2k	`image/jp2`	Apenas entrada	Formato JPEG 2000. Precisa ser convertido explicitamente usando uma `Convert` operação.
heif	`image/heif`	Apenas entrada	Formato de imagem de alta eficiência. Precisa ser convertido antes da entrega de borda.

URL de transformação de imagem

Para realizar transformações de imagem dinâmica, adicione o parâmetro de consulta imop ao URL da imagem. Esse parâmetro contém uma string de transformação, que consiste em uma ou mais operações aplicadas em sequência.

A string de transformação usa as seguintes regras de formato:

Use um ponto e vírgula (;) para separar cada operação individual.
Use uma vírgula (,) para separar os parâmetros internos em cada operação individual.
Apenas uma operação de um determinado tipo pode ser incluída em uma única string de consulta.

A sintaxe de linha de base usa a seguinte estrutura:

?imop=[OPERATION_1];[OPERATION_2];...[OPERATION_N]

Para realizar várias ações em uma imagem simultaneamente, anexe uma string de parâmetro encadeada ao URL da imagem. Por exemplo, para redimensionar uma imagem para 800 pixels de largura, defina a qualidade de compactação como 85 e converta o formato para WebP, anexe a string de parâmetro.

Por exemplo,

https://www.example.com/image.jpg?imop=Resize,width=800;Compress,quality=85;Convert,format=webp;

Estrutura da política

A política de otimização de imagens atua como o wrapper de configuração principal que contém todas as propriedades relevantes para a funcionalidade do recurso de otimização de imagens.

Nome	Descrição	Configuração
`queryParameterInterpretation`	Valor de enumeração que determina se o parâmetro de consulta para otimização de imagens será interpretado no plano de dados.	Obrigatório. Se definido como DISABLED, os parâmetros de consulta para transformação serão ignorados pela política, desativando esse recurso. Se definido como ENABLED, esse recurso será ativado.

Dependências e validação de políticas

A política de otimização de imagens tem uma dependência do armazenamento em cache do Cloud CDN. Para que esse recurso funcione, uma política de cache precisa ser definida explicitamente em um dos dois locais:

A mesma rota do mapa de URL em que a política de otimização de imagens está sendo configurada.
Um serviço de back-end ou bucket de back-end relacionado a essa rota exata.

A política de otimização de imagens é aplicada estritamente em conjunto com a política de cache ativa e subjacente.

Regras de ordenação de otimização de imagens

As operações listadas no parâmetro de consulta imop são processadas da esquerda para a direita, com exceção das seguintes substituições absolutas do sistema:

As operações metadata e scale são sempre executadas primeiro.
As operações canvas são sempre executadas por último.

Todos os recursos de entrada passam por uma normalização automática antes da execução dessas transformações. Os marcadores de orientação EXIF e os perfis de cores ICC são aplicados diretamente aos pixels da imagem antes que os metadados sejam removidos, garantindo que a integridade das coordenadas permaneça precisa para ações estruturais subsequentes.