Edge Security Acceleration:Usar o EdgeRoutine no console do DCDN

Fluxo de trabalho

Para usar o EdgeRoutine, ative o DCDN. A figura a seguir ilustra o processo de criação e implementação de uma rotina no EdgeRoutine.

Ativar o EdgeRoutine

1. Faça login no console do DCDN.

2. No painel de navegação à esquerda, clique em EdgeRoutine.

3. Escolha Enable ER > Activate Now para ativar o EdgeRoutine.

Criar e configurar uma rotina

1. Faça login no console do DCDN.

2. No painel de navegação à esquerda, clique em EdgeRoutine.

3. Ao usar o EdgeRoutine pela primeira vez, crie um subdomínio.

   1. Na página EdgeRoutine, clique em Create Subdomain.

      

   2. Na caixa de diálogo Create Subdomain, especifique um nome de subdomínio.

      Nota

      • Um subdomínio funciona como repositório de todas as rotinas criadas. Não é possível alterar o nome do subdomínio após a criação.

      • O subdomínio serve como identificador exclusivo para cada usuário e compõe parte do ID da rotina.

      • Não é permitido alterar o nome do subdomínio depois de criado. O nome pode conter letras minúsculas, dígitos e hifens (-), com no mínimo 2 caracteres. Exemplo: subdomain-name.

   3. Clique em OK.

4. Na página EdgeRoutine, clique em Create Routine. A tabela a seguir descreve os parâmetros.

   

   Parâmetro	Descrição
   Routine Name	Insira um nome para a rotina. Nota O nome pode conter letras minúsculas, dígitos e hifens (-). Deve ter no mínimo 2 caracteres. Exemplo: routine-name. Não é possível modificar o nome da rotina após a criação.
   Description	Opcional. Insira uma descrição para a rotina.
   Specification	Selecione a fatia de tempo máxima de CPU para uma única execução da rotina. O tempo de I/O para aguardar respostas de rede não está incluído. As taxas variam conforme as especificações da rotina. Para mais informações, consulte Regras de faturamento. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (padrão) CPU Time Slice for Individual Requests: 100 ms

5. Após criar a rotina, clique em Details na coluna Actions para configurá-la em diferentes ambientes. As configurações da rotina são independentes entre os ambientes. É possível modificar as definições nos ambientes de produção, teste e lançamento canário. Para mais detalhes, consulte Ambiente de lançamento canário (opcional). A tabela abaixo detalha os parâmetros disponíveis.

   Parâmetro	Descrição
   Routine Specifications	Defina a fatia de tempo máxima de CPU para uma única execução da rotina, excluindo o tempo de I/O de espera por respostas de rede. Tempo real máximo: 120 s. Memória: 128 MB. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (padrão) CPU Time Slice for Individual Requests: 100 ms
   Domain Name Whitelist	Lista de nomes de domínio associáveis à rotina. Há suporte para nomes de domínio com curinga. Por padrão, a lista de permissões de nomes de domínio vem vazia. Isso indica que qualquer nome de domínio pode ser associado à rotina. Nota Por exemplo, se você definir o parâmetro Domain Name Whitelist como example.com, somente requisições originadas de example.com acionarão a rotina.

Associar nomes de domínio à rotina

Uma rotina precisa de um nome de domínio para fornecer serviços ao cliente. Esse domínio pode ser acelerado por Alibaba Cloud CDN ou por DCDN. Depois de criar e configurar uma rotina, associe os nomes de domínio acelerados pelo Alibaba Cloud CDNaclerados pelo DCDN a ela. Assim, a rotina será acionada por requisições vindas desses domínios associados. Faça login no console do serviço onde seu nome de domínio foi adicionado.

1. Faça login no console do DCDN.

2. No painel de navegação à esquerda, clique em Domain Names.

3. Na página Domain Names, localize o nome de domínio desejado e clique em Configure.

4. No painel de navegação à esquerda, clique em EdgeRoutine.

5. Na página EdgeRoutine, ative a chave e configure o parâmetro Routine ID. A tabela a seguir descreve os parâmetros.

   

   Parâmetro	Descrição
   Routine ID	O ID da rotina é um identificador exclusivo para cada rotina. Formato: routineName.subdomain. Nota No painel de navegação à esquerda do console do DCDN, clique em EdgeRoutine. Visualize o ID da rotina na página Function.
   Trigger Mode	Selecione o modo como as requisições que tentam acessar o nome de domínio acelerado pelo DCDN acionam a rotina. Há suporte para os seguintes modos: Redirect: A rotina processa as requisições destinadas ao nome de domínio acelerado pelo DCDN. Escreva código na rotina para tratar essas requisições. A rotina pode retornar o conteúdo solicitado aos clientes, ler o cache chamando a Cache API ou redirecionar as requisições ao servidor de origem enviando requisições fetch. Bypass: As requisições ao nome de domínio acelerado pelo DCDN acionam a rotina. Em seguida, o sistema executa as configurações definidas no console do DCDN e encaminha as requisições ao servidor de origem. Este modo de acionamento é ideal para cenários como autenticação ou rastreamento de logs.
   Redirect to Origin if Error Occurs	Yes: Quando a rotina lança uma exceção, o ponto de presença (POP) encaminha a requisição ao servidor de origem do nome de domínio acelerado pelo DCDN, usando a URL solicitada pelo cliente. O servidor de origem processa a requisição, garantindo a continuidade dos negócios e a recuperação de desastres. No: Caso a rotina lance uma exceção, um código de status HTTP 5xx é retornado ao cliente. Nota Ao usar uma rotina pela primeira vez, defina o parâmetro Redirect to Origin if Error Occurs como No. Isso permite usar o código de status HTTP 5xx retornado para solucionar problemas. Se ocorrer uma exceção, haverá cobrança pelo número de requisições de retorno à origem. A porcentagem de requisições anormais de retorno à origem é muito baixa e pode ser ignorada.

Desenvolver e depurar a rotina

1. Faça login no console do DCDN.

2. No painel de navegação à esquerda, clique em EdgeRoutine.

3. Localize a rotina criada e clique em Details na coluna Actions.

4. Na página da rotina exibida, clique na aba Code para desenvolver a rotina usando JavaScript. O código de exemplo usa o script HelloWorld.

5. Após concluir a codificação, clique em Release to Staging Environment. Associe um endereço IP do ambiente de teste, fornecido na página, à máquina que usará para depurar a rotina.

   Nota

   Adicione o endereço IP do ambiente de teste e o nome de domínio associado à rotina no arquivo hosts da sua máquina local. Por exemplo, adicione 10.10.10.10 e example.com ao arquivo hosts. Substitua o endereço IP pelo valor fornecido na figura anterior e o nome de domínio pelo domínio acelerado pelo Alibaba Cloud CDNDCDN associado à rotina.

Salvar uma versão

Publicar a versão

1. Na página da rotina exibida, clique na aba Versions, encontre a versão que deseja publicar e clique em Release na coluna Actions.

2. Selecione o Staging Environment, Production Environment ou Canary Environment onde deseja publicar a versão.

   Nota

   Recomendamos liberar a rotina nos ambientes canários antes de publicá-la nos ambientes de produção.

3. Clique em OK para implantar o código no ambiente de produção de todos os POPs.

Iteração

Nas seções anteriores, usamos o HelloWorld para demonstrar como configurar e publicar uma rotina.

• Para saber como iterar uma rotina, consulte as seções "Desenvolver e depurar a rotina", "Salvar uma versão" e "Publicar a versão".

• Caso precise ajustar configurações, como especificações da rotina ou lista de permissões de nomes de domínio, veja a seção "Criar e configurar uma rotina".

• Para desativar o EdgeRoutine em um nome de domínio acelerado pelo Alibaba Cloud CDND CDN, exclua as configurações da rotina seguindo os passos descritos na seção "Associar nomes de domínio à rotina".

Perguntas frequentes

• Escolher especificações da função

• Fallback para falhas no Edge Routine

• Reverter uma publicação em escala de cinza

• Excluir um ambiente de escala de cinza

• Escolher uma região para publicação em escala de cinza

• Solucionar erros comuns do EdgeRoutine (ER)