Fastly CLI sur npm : maintenant à portée de main JavaScript

La CLI Fastly est l'outil recommandé fourni par Fastly pour interagir avec l'API Fastly à partir de la ligne de commande. Il s'agit d'un outil open source utilisé par les développeurs et dans les pipelines d'intégration continue pour effectuer diverses actions au nom d'un compte Fastly, notamment la création de services, la gestion des backends et des domaines et le déploiement de packages Compute. Si vous travaillez avec Fastly Compute en JavaScript, nous avons des nouvelles passionnantes qui rapprochent la Fastly CLI de vous : la Fastly CLI est désormais disponible sous forme de package sur npm.

---

Cela fait trois années passionnantes que nous avons annoncé la prise en charge de JavaScript dans la plateforme Edge Fastly Compute, et presque deux ans depuis la sortie de la version 1.0 du SDK JavaScript. C’est une langue très populaire sur la plateforme et c’est aussi ma préférée. Développer pour Fastly Compute à l'aide de JavaScript permet de créer des applications de pointe de manière rapide et amusante, et nous souhaitons en étendre l'accès au plus grand nombre d'utilisateurs possible.

En tant qu'entreprise axée sur les développeurs, il y a une chose que nous avons toujours à l'esprit : éliminer autant d'obstacles que possible pour empêcher le développement réel. Autrement dit, comment pouvons-nous permettre aux développeurs de faire leur travail avec un clic de moins, avec une dépendance de moins, avec un outil de moins à installer ? Existe-t-il un moyen de simplifier le développement JavaScript sur Compute ? C’est ce à quoi nous avons décidé de nous attaquer cette fois-ci.

La CLI Fastly est un outil open source utilisé pour effectuer des actions avec votre compte Fastly. Puisqu'il est utilisé pour exécuter et publier des applications Compute, il s'agit de l'une des conditions requises pour développer Fastly Compute en JavaScript, même s'il s'agit simplement de l'essayer localement. Cela signifiait traditionnellement un voyage vers le référentiel GitHub pour obtenir un package prédéfini ou son installation via Homebrew sur macOS. Bien qu'il s'agisse d'étapes généralement familières aux développeurs, nous souhaitions réduire autant que possible les obstacles pour vous familiariser avec le développement d'applications Compute.

C'est pourquoi, à partir de la version 10.14.0, nous avons décidé de publier la CLI Fastly sur npmjs.org comme moyen de distribution supplémentaire. Si vous êtes un développeur JavaScript en 2024, il est probable que vous connaissiez npmjs.org en tant que référentiel de packages de facto à partir duquel vous installez des packages dans votre application, que vous utilisiez fil, pnpm ou l'ancien fidèle npm comme interface. . Cela signifie que npmjs.org est disponible par défaut pour tout le monde, ce qui en fait un excellent moyen pour nous de mettre cet outil essentiel entre les mains de nos utilisateurs.

Exécutez la CLI Fastly sans avoir besoin de l'installer

Une fonctionnalité pratique de npm est npx, qui vous permet d'exécuter des commandes à partir de packages npm sans avoir besoin de les installer dans un projet. Tant que Node.js et npm sont disponibles dans votre environnement, vous pouvez désormais appeler directement la CLI Fastly en tant que telle :

npx @fastly/cli 

La première fois que vous faites cela, npm vous demandera de récupérer le package ; cela l'ajoutera au cache npm de votre environnement et il sera disponible immédiatement dans le futur.

Étant donné que la CLI Fastly est toujours appelée avec des paramètres supplémentaires, vous les spécifiez simplement comme d'habitude en tant que paramètres après la commande. Par exemple, pour lister les services de votre compte Fastly, vous pouvez taper :

npx @fastly/cli service list

Fastly CLI en tant que package de dépendances

Bien sûr, la disponibilité sur npmjs.org signifie que vous pouvez désormais ajouter la CLI Fastly à votre application Compute JavaScript en tant que dépendance standard :

npm install @fastly/cli
Alternativement, vous pouvez l'ajouter au fichier package.json de votre projet :

{
  "dependencies": {
    "@fastly/cli": "^10.14.0"
  }
}

Installez ensuite les dépendances du projet :

npm install

Cela installe @fastly/cli en tant que dépendance dans le répertoire node_modules de votre projet. Il devient disponible sous forme de programme appelé rapidement dans le sous-répertoire node_modules/.bin, vous pourrez donc l'invoquer comme ceci :

npx fastly

Par exemple, pour démarrer votre application dans l'environnement de développement local, tapez ce qui suit :

npx fastly compute serve

De plus, toutes les références à fastly dans la section scripts du fichier package.json trouveront désormais cette version installée localement de @fastly/cli au lieu de nécessiter une installation globale de Fastly CLI pour être disponible sur le système.

{
  "scripts": {
    "build": "js-compute-runtime src/index.js bin/main.wasm",
    "start": "fastly compute serve",
    "deploy": "fastly compute publish"
  }
}

Aucune installation globale nécessaire

Traditionnellement, il était nécessaire pour chaque développeur travaillant avec Fastly Compute d'installer une instance disponible mondialement de Fastly CLI pour développer des applications et les publier sur leur compte Fastly, même lorsqu'ils débutaient tout juste avec la plate-forme pour expérimenter. En rendant Fastly CLI disponible en tant que dépendance standard d'une application JavaScript, les nouveaux utilisateurs de Fastly Compute peuvent découvrir une application Compute en clonant simplement son référentiel d'applications, en installant ses dépendances normalement et en tapant npm start. En fait, nous avons mis à jour tous nos kits de démarrage JavaScript et TypeScript pour adopter cette approche, afin qu'ils puissent être utilisés par davantage d'utilisateurs, même s'ils n'ont aucune expérience préalable avec la plateforme Compute.

C’est aussi génial de travailler en équipe. Vous, ainsi que les autres développeurs qui travaillent avec votre application, pouvez obtenir le code de votre application, utiliser la procédure standard pour installer ses dépendances et vous mettre au travail, piles incluses.

Cette commodité s'étend également à votre pipeline d'intégration continue (CI), permettant à votre application d'avoir un accès fiable à Fastly CLI dans le cadre de son processus de construction ou de test.

Utilisez les nouvelles fonctionnalités de la CLI en toute confiance

La CLI Fastly est en développement actif et reçoit constamment de nouvelles fonctionnalités et améliorations.

Spécifier Fastly CLI comme dépendance standard de votre package vous permet de prescrire sa version à l'aide du versioning sémantique. Cela permet à votre package de dépendre en toute sécurité des fonctionnalités de la CLI qui ont été ajoutées récemment ou dont le comportement a pu changer, sans avoir à se soucier de savoir si les autres développeurs qui travaillent avec votre application disposent d'une version compatible de la CLI installée sur leurs environnements.

Appel de la CLI Fastly à partir du code Node.js

Si vous écrivez du code destiné à s'exécuter sous Node.js qui fait appel à la CLI Fastly, comme dans un outil ou un utilitaire, ce package fournit un moyen très simple et fiable de le faire.

L'exportation par défaut de @fastly/cli se résout en une valeur de chaîne représentant le chemin complet de l'exécutable de Fastly CLI, appropriée au système d'exploitation, à l'architecture et à la manière dont il a été installé. Il peut être utilisé directement avec des fonctions telles que spawnSync dans Node.js. Étant donné que cela est disponible de cette manière, vous n'avez pas besoin que l'utilisateur de votre package obtienne une installation globale de Fastly CLI avant d'exécuter votre programme.

L'exemple de programme Node.js suivant exécute la commande fastly version :

npx @fastly/cli 

Installez même la CLI Fastly à l’échelle mondiale

Si jamais vous avez besoin d'une installation globale de Fastly CLI, ce package constitue également un moyen de l'obtenir pour une utilisation globale :

npx @fastly/cli service list

Une fois installé, invoquez-le comme vous l'auriez fait traditionnellement :

{
  "dependencies": {
    "@fastly/cli": "^10.14.0"
  }
}

Sous le capot, ce n'est pas différent d'invoquer la copie de la CLI mise en cache dans l'environnement à l'aide de npx @fastly/cli. Cependant, cette procédure rend la commande disponible aussi rapidement sur le chemin du système, ce qui lui permet de s'adapter à d'autres outils qui s'attendent à la trouver à cet endroit. Le résultat final est effectivement identique à celui obtenu si vous aviez utilisé l'une des méthodes traditionnelles d'installation globale, mais ce processus d'installation est une alternative pratique, car npm est largement disponible sur de nombreuses machines.

Offrir l'informatique de pointe à davantage de développeurs

Chez Fastly, nous nous efforçons de fournir les outils qui vous donnent le pouvoir d'exécuter davantage de code à la périphérie et de développer celui-ci avec les outils que vous connaissez et aimez. Nous voulons que rien ne s’y oppose. Comme JavaScript est le langage le plus populaire de la planète, la sortie de Fastly CLI sur npm fait progresser cette mission.

Nous aimons entendre parler lorsque nos utilisateurs tirent le meilleur parti de ces outils. Obtenez votre compte développeur Fastly gratuit, rejoignez-nous sur le forum de la communauté Fastly et dites-nous ce que vous avez construit !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!