Travailler au niveau local

Le Code Hub peut être utilisé entièrement à partir de la ligne de commande en utilisant le CLI si vous préférez utiliser vos propres outils pour travailler localement.

Code Hub peut également être utilisé dans le nuage à l'aide d'un espace de travail Visual Studio Code. travailler dans le nuage pour plus d'informations.

Installation du CLI

Code Hub peut être utilisé entièrement à partir de la ligne de commande ; vcr est l'interface de ligne de commande nécessaire pour gérer et déployer vos Applications à partir du terminal.

pwsh -Command "iwr https://raw.githubusercontent.com/Vonage/cloud-runtime-cli/main/script/install.ps1 -useb | iex"

Configurer le CLI

Configurez votre Account à l'aide de cette commande :

vcr configure

La commande vous demandera une région par défaut ainsi que la clé et le secret de l'API de Vonage que vous pouvez obtenir à partir du tableau de bord de l'API.

Mise à jour du CLI

Pour mettre à jour l'exécution de la CLI :

vcr upgrade

La version actuelle de l'interface de programmation que vous avez installée sera imprimée. Si une version plus récente est disponible, vous serez invité à l'installer.

REMARQUE : Il se peut que vous deviez exécuter la commande à l'aide de sudo pour donner à la CLI du moteur d'exécution Cloud les permissions de déplacer la nouvelle version de la CLI dans le dossier d'installation. Vous pouvez également effectuer le déplacement vous-même.

Utilisation de l'interface de programmation

Pour initialiser un projet, exécutez la commande suivante pour commencer à saisir vos données :

vcr init

L'exécution de la commande vous invitera à fournir les informations suivantes :

  • Nom du projet: un nom pour votre projet.
  • Nom de l'instance: Saisissez un nom pour l'instance qui sera créée. Vous pouvez avoir plusieurs instances pour un même projet, ce nom doit donc être mémorable.
  • Temps d'exécution: Sélectionnez la durée d'exécution que vous souhaitez utiliser lorsque le code est exécuté.
  • Région: Sélectionnez la région dans laquelle vous souhaitez que votre instance fonctionne.
  • ID de l'application pour l'instance: Pour pouvoir utiliser les API de Vonage, une Application est nécessaire. Sélectionnez l'ID de l'application que vous souhaitez utiliser ; si vous n'en avez pas encore créé une, vous pouvez sauter cette étape et saisir l'ID plus tard. Pour créer une application, allez dans la section Page Applications sur le tableau de bord de Vonage ou exécutez vcr app create. Lorsque vous déployez votre instance, Cloud Runtime configure automatiquement pour vous les webhooks sur votre application.
  • ID de l'application pour le débogage: Vous pouvez fournir un ID d'application distinct à utiliser uniquement pour le débogage, ce qui signifie que votre instance déployée et l'Application et les webhooks correspondants ne seront pas affectés par le débogage local.
  • Modèle: Choisissez un modèle dans la liste pour visualiser un projet existant. La liste complète des modèles se trouve dans la rubrique Hub de code

Une fois que vous avez saisi toutes les informations nécessaires, un vcr.yaml Un fichier de configuration sera créé, dans lequel vous pourrez ajouter tout ce que vous avez omis ou modifier les détails que vous venez de fournir. Si vous avez sélectionné un modèle, les fichiers nécessaires à l'exécution de cette application seront également téléchargés. Vous pouvez maintenant ouvrir ces fichiers dans votre configuration locale pour commencer à visualiser et à modifier le projet.

Prochaines étapes

Lorsque vous travaillez sur votre projet, les ressources suivantes peuvent vous être utiles :

  • Débogage: Déboguez votre code localement comme s'il était déployé sur la plateforme.
  • Déploiement: Lorsque votre projet est prêt, créez rapidement une instance opérationnelle sur la plateforme en la déployant.