Edge Security Acceleration:Functions and Pages CLI tool

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

• Node.js instalado (utilice un gestor de versiones de Node como Volta o nvm para la instalación).

• npm instalado (se incluye con Node.js).

Instale la CLI

Instale la CLI de ESA de forma global mediante npm y compruebe la instalación:

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

Inicie sesión en su cuenta

Obtenga su AccessKey ID y su AccessKey secret en la consola de Resource Access Management (RAM) de Alibaba Cloud. Después, ejecute el siguiente comando:

esa-cli login

Para cerrar sesión:

esa-cli logout

Nota: Si solo necesita depurar código localmente, omita este paso. La autenticación no es obligatoria para la depuración local.

Inicialice un proyecto

Ejecute esa-cli init para crear un proyecto. La CLI le solicitará introducir un nombre de proyecto y seleccionar una plantilla.

esa-cli init

Depure localmente

Una vez que haya escrito su código, inicie el servicio de depuración local:

esa-cli dev

La CLI empaqueta automáticamente el archivo de entrada e inicia un servidor local que simula el entorno de producción.

Atajos de teclado disponibles durante la depuración:

Si desea usar un puerto específico:

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'
}

Confirme una versión

Cuando termine la depuración local, confirme su código como una versión:

esa-cli commit

Despliegue en producción

Despliegue una versión en todos los POP en línea:

esa-cli deploy

La CLI le pedirá seleccionar una versión y un entorno de destino.

Para comprobar el estado del despliegue o eliminar una versión:

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

Configure dominios personalizados

Vincule un nombre de dominio a sus proyectos de Functions and Pages. El dominio debe ser un subdominio de su sitio de ESA y contar con un registro ICP. Una vez vinculado, Functions and Pages actúa como servidor de origen para ese dominio, y el dominio resuelve directamente hacia su función perimetral.

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

Configure rutas

Vincule una ruta a su sitio de ESA. Cuando una solicitud coincide con la ruta, se activa la ejecución de Functions and Pages. Esto permite que Functions and Pages se comunique con el servidor de origen del sitio.

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

Gestione funciones

Consulte y elimine funciones mediante la CLI:

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

Referencia de comandos