Edge Security Acceleration:Ferramenta CLI do Functions and Pages

Pré-requisitos

Antes de começar, verifique se você tem:

• Node.js instalado (utilize um gerenciador de versões do Node, como Volta ou nvm, para a instalação)

• npm instalado (incluído no pacote do Node.js)

Instalar a CLI

Instale a ESA CLI globalmente via npm e, em seguida, verifique a instalação:

npm install esa-cli -g       # Install the CLI globally
esa-cli -v                   # Verify the installed version
esa-cli --help               # View available commands

Fazer login na conta

Obtenha seu AccessKey ID e AccessKey secret no console do Resource Access Management (RAM) do Alibaba Cloud e execute:

esa-cli login

Para fazer logout:

esa-cli logout

Nota: Caso precise apenas depurar o código localmente, ignore esta etapa. A autenticação não é necessária para depuração local.

Inicializar um projeto

Execute esa-cli init para criar um projeto. A CLI solicitará que você insira um nome de projeto e selecione um modelo.

esa-cli init

Depurar localmente

Após escrever seu código, inicie o serviço de depuração local:

esa-cli dev

A CLI empacota automaticamente o arquivo de entrada e inicia um servidor local que simula o ambiente de produção.

Atalhos de teclado disponíveis durante a depuração:

Para utilizar uma porta específica:

esa-cli dev --port <port>

{
  "namespace": {
    "k1": "v1",
    "k2": "v2"
  }
}

const edgeKv = new EdgeKV({ namespace: 'namespace' });

async function run() {
  const data = await edgeKv.get('k1', { type: 'text' });
  console.log(data); // 'v1'
}

Confirmar uma versão

Após concluir a depuração local, confirme seu código como uma versão:

esa-cli commit

Implantar em produção

Implante uma versão em todos os POPs online:

esa-cli deploy

A CLI solicitará que você selecione uma versão e um ambiente de destino.

Para verificar o status da implantação ou excluir uma versão:

esa-cli deployments list                 # View deployment status
esa-cli deployments delete <versionId>   # Delete a version

Configurar domínios personalizados

Vincule um nome de domínio aos seus projetos de Functions and Pages. O domínio deve ser um subdomínio do seu site ESA e possuir registro ICP. Após o vínculo, o Functions and Pages atua como servidor de origem para esse domínio, e o domínio resolve diretamente para sua função de borda.

esa-cli domain list
esa-cli domain add <domainName>
esa-cli domain delete <domainName>

Configurar rotas

Vincule uma rota ao seu site ESA. Quando uma solicitação corresponde à rota, ela aciona a execução do Functions and Pages, permitindo que o serviço se comunique com o servidor de origem do site.

esa-cli route list
esa-cli route add [route] [site]
esa-cli route delete <route>

Gerenciar funções

Visualize e exclua funções utilizando a CLI:

esa-cli project list                     # List all functions
esa-cli project delete <PROJECT_NAME>    # Delete a function

Referência de comandos