Edge Security Acceleration:Functions and Pages CLI tool

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Node.js installé (utilisez un gestionnaire de versions Node tel que Volta ou nvm pour l'installation).

• npm installé (inclus avec Node.js).

Installation de l'outil CLI

Installez l'ESA CLI globalement via npm, puis vérifiez l'installation :

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

Connexion à votre compte

Récupérez votre AccessKey ID et votre AccessKey secret depuis la console Resource Access Management (RAM) d'Alibaba Cloud, puis exécutez la commande suivante :

esa-cli login

Pour vous déconnecter :

esa-cli logout

Remarque : Si vous avez uniquement besoin de déboguer votre code localement, ignorez cette étape. L'authentification n'est pas requise pour le débogage local.

Initialisation d'un projet

Exécutez esa-cli init pour créer un projet. L'outil CLI vous invite alors à saisir un nom de projet et à sélectionner un modèle.

esa-cli init

Débogage local

Une fois votre code rédigé, lancez le service de débogage local :

esa-cli dev

L'outil CLI empaquette automatiquement le fichier d'entrée et démarre un serveur local qui simule l'environnement de production.

Raccourcis clavier disponibles pendant le débogage :

Pour utiliser un port spécifique :

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

Validation d'une version

Une fois le débogage local terminé, validez votre code en tant que version :

esa-cli commit

Déploiement en production

Déployez une version sur tous les POPs en ligne :

esa-cli deploy

L'outil CLI vous invite alors à sélectionner une version et un environnement cible.

Pour vérifier l'état du déploiement ou supprimer une version :

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

Configuration des domaines personnalisés

Associez un nom de domaine à vos ressources Functions and Pages. Ce domaine doit être un sous-domaine de votre site ESA et disposer d'un dépôt ICP. Une fois associé, Functions and Pages agit comme serveur d'origine pour ce domaine, qui pointe alors directement vers votre fonction edge.

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

Configuration des routes

Associez une route à votre site ESA. Lorsqu'une requête correspond à la route définie, elle déclenche l'exécution de Functions and Pages, permettant ainsi à ce dernier de communiquer avec le serveur d'origine du site.

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

Gestion des fonctions

Consultez et supprimez des fonctions à l'aide de l'outil CLI :

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

Référence des commandes