Vor Ort arbeiten

Der Code Hub kann vollständig über die Befehlszeile mit Hilfe der CLI verwendet werden, wenn Sie lieber Ihre eigenen Tools für die lokale Arbeit verwenden möchten.

Code Hub kann auch in der Cloud mit einem Visual Studio Code-Arbeitsbereich verwendet werden - siehe unsere Anleitung zu Arbeiten in der Cloud für weitere Informationen.

CLI-Installation

Code Hub kann vollständig über die Befehlszeile verwendet werden; vcr ist die Befehlszeilenschnittstelle, die für die Verwaltung und Bereitstellung Ihrer Applications über das Terminal erforderlich ist.

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

Konfigurieren Sie die CLI

Konfigurieren Sie Ihren Account mit diesem Befehl:

vcr configure

Der Befehl fragt nach Ihrer Standardregion sowie nach Ihrem Vonage API-Schlüssel und -Geheimnis, die Sie über das API-Dashboard erhalten.

Aktualisieren der CLI

Um die CLI zu aktualisieren, führen Sie aus:

vcr upgrade

Dadurch wird die aktuelle Version des installierten CLI ausgedruckt. Wenn eine neuere Version verfügbar ist, werden Sie aufgefordert, diese zu installieren.

HINWEIS: Möglicherweise müssen Sie den Befehl mit sudo um der Cloud Runtime CLI die Berechtigung zu erteilen, die neue CLI-Version in den Installationsordner zu verschieben. Sie können die Verschiebung auch selbst durchführen.

Verwendung der CLI

Um ein Projekt zu initialisieren, führen Sie den folgenden Befehl aus, um mit der Eingabe Ihrer Daten zu beginnen:

vcr init

Wenn Sie den Befehl ausführen, werden Sie zur Eingabe der folgenden Informationen aufgefordert:

  • Name des Projekts: einen Namen für Ihr Projekt.
  • Name der Instanz: Geben Sie einen Namen für die Instanz ein, die erstellt werden soll. Sie können mehrere Instanzen für ein einzelnes Projekt haben, daher sollte dieser Name einprägsam sein.
  • Laufzeit: Wählen Sie die Laufzeit, die Sie bei der Ausführung des Codes verwenden möchten.
  • Region: Wählen Sie die Region, in der Ihre Instanz laufen soll.
  • Application ID für Instanz: Um die Vonage APIs nutzen zu können, ist eine Applikation erforderlich. Wählen Sie die Anwendungs-ID für die Anwendung, die Sie verwenden möchten. Wenn Sie noch keine Anwendung erstellt haben, können Sie diesen Schritt überspringen und die ID später eingeben. Um eine Applikation zu erstellen, gehen Sie auf die Seite Seite Applications auf dem Vonage Dashboard oder führen Sie vcr app create. Wenn Sie Ihre Instanz bereitstellen, konfiguriert Cloud Runtime die Webhooks für Ihre Anwendung automatisch für Sie.
  • Application ID für Debugging: Sie können eine separate Anwendungs-ID angeben, die nur für das Debugging verwendet wird. Das bedeutet, dass Ihre bereitgestellte Instanz und die entsprechende Anwendung und Webhooks nicht vom lokalen Debugging betroffen sind.
  • Vorlage: Wählen Sie eine Vorlage aus der Liste, um ein bestehendes Projekt anzuzeigen. Eine vollständige Liste der Vorlagen finden Sie auf der Seite Code-Hub

Sobald Sie alle erforderlichen Informationen eingegeben haben, wird ein vcr.yaml config-Datei erstellt, in der Sie alles hinzufügen können, was Sie übersprungen haben, oder die Angaben, die Sie gerade gemacht haben, bearbeiten können. Wenn Sie eine Vorlage ausgewählt haben, werden auch die für die Ausführung dieser Anwendung erforderlichen Dateien heruntergeladen. Sie können diese Dateien nun in Ihrem lokalen Setup öffnen, um mit der Anzeige und Bearbeitung des Projekts zu beginnen.

Nächste Schritte

Bei der Arbeit an Ihrem Projekt können Ihnen die folgenden Ressourcen nützlich sein:

  • Fehlersuche: Debuggen Sie Ihren Code lokal, als ob er auf der Plattform bereitgestellt würde.
  • Bereitstellung von: Wenn Ihr Projekt fertig ist, erstellen Sie schnell eine laufende Instanz auf der Plattform, indem Sie es bereitstellen.