Todos os produtos
Search
Central de documentação

Edge Security Acceleration:O que é o EdgeRoutine?

Última atualização: Sep 16, 2026

O EdgeRoutine (ER) é um service de computação serverless que executa código JavaScript nos pontos de presença (POPs) globais do Alibaba Cloud. Ele oferece suporte à sintaxe ES6 e às APIs padrão de Web Service Worker. As requisições são processadas no POP mais próximo de cada usuário, garantindo respostas com latência ultrabaixa.

image
Importante

O ER no Alibaba Cloud DCDN não estará mais disponível para novos usuários a partir das 00:00 (UTC+8) de 1º de maio de 2025. Os usuários existentes não serão afetados.

Para obter essa funcionalidade, faça upgrade para ESA e utilize o recurso Functions and Pages do ESA.

Benefícios

  • Implantação global e latência ultrabaixa: Diferentemente do Function Compute ou do Elastic Compute Service (ECS), o ER não exige implantação específica por região. Ele opera em uma rede global de POPs. As requisições dos clientes são roteadas para o POP mais próximo, que executa seu código e responde diretamente, minimizando a latência.

  • Dimensionamento automático e faturamento conforme o uso: Com mais de 3.200 POPs, o Alibaba Cloud oferece elasticidade integrada — picos de requisições são automaticamente direcionados a POPs próximos com capacidade disponível. O ER utiliza o modelo de pagamento conforme o uso, baseado no número de invocações. Você paga apenas enquanto seu código está em execução.

  • Serverless e fácil de usar: Concentre-se na lógica de negócios sem precisar gerenciar infraestrutura (CPUs, memória, rede ou sistema operacional). Implante o código enviando-o pelo console ou chamando uma API. O modelo serverless reduz os custos de desenvolvimento e operações.

Como funciona

image
  • Fluxo de requisição para CDN/DCDN sem o ER: 1. O cliente envia uma requisição ao gateway do POP. → 2. O POP verifica seu cache. Em caso de acerto no cache, o conteúdo retorna ao cliente. → 3. Se houver falha no cache, a requisição é encaminhada ao servidor de origem.

  • Fluxo de requisição para CDN/DCDN com o ER: 1. O cliente envia uma requisição ao gateway do POP. → 4. O ER intercepta a requisição e executa seu código JavaScript. → Seu código pode usar fetch para acessar o cache, recuperar conteúdo do servidor de origem (Seta 5 ou 3) ou chamar outros serviços web públicos (Seta 6).

    Nota

    Como o ER é executado após o gateway, as configurações do console do seu nome de domínio CDN/DCDN — HTTPS, controle de acesso, otimização de desempenho e regras de cache — permanecem ativas.

Conceitos principais

  • Function: Uma Routine é um runtime JavaScript em um POP que executa o código enviado por você. Para utilizar o ER, crie primeiro uma Routine. Cada Routine possui duas partes: configurações (nome, descrição, especificações de CPU/memória e lista de permissões de nomes de domínio) e o seu código JavaScript.

    image
  • Version: As Routines oferecem suporte ao gerenciamento de versões. Crie um snapshot do seu código como uma versão a qualquer momento durante o desenvolvimento. A publicação de uma Routine exige a seleção de uma versão específica para implantação. É possível reverter para versões anteriores e gerencie o histórico do código. Cada versão recebe um número gerado pelo sistema.

    image
  • Environment: O ER disponibiliza ambientes de staging, produção e canary para desenvolvimento, testes e implantação.

    image
    • Ambiente de staging: Um nó de borda independente para testar seu código. Ele simula a produção, mas é totalmente isolado — alterações aqui não afetam o ambiente de produção. Acesse-o adicionando o IP de staging fornecido ao seu arquivo hosts.

    • Ambiente de produção: O ambiente ativo, composto por POPs distribuídos globalmente. Após os testes em staging, publique seu código em produção. O ER dimensiona automaticamente os nós com base no volume de requisições; a distribuição regional real pode variar.

    • Ambiente canary: Implantar diretamente em produção traz o risco de afetar todos os usuários caso existam erros. Utilize releases canary para expandir gradualmente o escopo da implantação. Canary environment (optional).

  • Domain Name: Após criar e publicar uma Routine, é necessário um nome de domínio como ponto de entrada do cliente. O ER aceita apenas nomes de domínio acelerados do Alibaba Cloud CDN ou DCDN como pontos de entrada. Associe sua Routine a um nome de domínio acelerado no console da CDN ou DCDN.

    image
  • Ponto de presença (POP): O termo "borda" refere-se à implantação distribuída, em oposição à centralizada. Um POP é um nó de CDN/DCDN mais próximo do cliente, responsável por processar as requisições recebidas.

Limitações

Item

Limite

Descrição

Tempo de CPU

5 ms, 50 ms ou 100 ms

Tempo de CPU por execução do ER (exclui espera de I/O). Escolha entre as especificações de 5 ms, 50 ms ou 100 ms. Billing.

Memória

128 MB

Memória total por nome de domínio em uma única máquina física. Todas as requisições para esse nome de domínio na máquina compartilham este pool.

Tempo de execução (RT)

120s

Tempo máximo total de resposta por execução do ER, incluindo espera de I/O.

Tempo de espera

10 segundos

Tempo máximo que o gateway aguarda por uma resposta do ER. Se nenhum dado for retornado dentro de 10 segundos, o gateway encerra a conexão e devolve um código de status 504.

Tamanho do pacote de código

4 MB

Tamanho máximo do arquivo de código JavaScript por Routine.

Número de sub-requisições

4

Quantidade máxima de requisições fetch por execução do ER.

Linguagem de programação

JavaScript (sintaxe ES6)

Apenas JavaScript é suportado. É necessário ter conhecimento em programação JavaScript.

Quantidade de Routines

50

Máximo de Routines por conta Alibaba Cloud.

Quantidade de versões

10

Máximo de versões por Routine.

Protocolos suportados

Somente HTTPS

WebSocket, TCP e UDP não são suportados.

Sub-requisições aninhadas

Não suportado

Uma instância do ER não pode fazer fetch de um nome de domínio que acione outra instância do ER.