地元で働く

コード・ハブは、CLIを使ってコマンドラインから使用することもできる。

ローカル・ツールを使わずにブラウザから直接アプリケーションをデプロイするには、以下のガイドを参照してください。 クラウドで働く.

CLIのインストール

Code Hubは完全にコマンドラインから使用できる； vcr は、ターミナルからアプリケーションを管理およびデプロイするために必要なコマンドラインインターフェイスです。

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

CLIの設定

このコマンドを使ってアカウントを設定する：

vcr configure

コマンドはデフォルトの地域と、APIダッシュボードから取得できるVonage APIキーとシークレットを要求します。

CLI設定ファイル

vcr configure には、あなたの証明書とプリファレンスを書き込みます。 ~/.vcr-cli.このファイルを直接編集することもできます。このファイルはINI形式です：

[default]
graphql_endpoint = https://api-eu.vonage.com/v1/vcr/euw1/api/graphql/v1/graphql
default_region = aws.euw1

[credentials]
apikey = YOUR_API_KEY
apisecret = YOUR_API_SECRET

について graphql_endpoint 各地域の

地域 エンドポイント
EU西aws.euw1) https://api-eu.vonage.com/v1/vcr/euw1/api/graphql/v1/graphql
アメリカ東部aws.use1) https://api-us.vonage.com/v1/vcr/use1/api/graphql/v1/graphql
AP南東部(aws.apse1) https://api-ap.vonage.com/v1/vcr/apse1/api/graphql/v1/graphql
AP南東シドニー(aws.apse2) https://api-ap.vonage.com/v1/vcr/apse2/api/graphql/v1/graphql

CLIのアップデート

CLIを更新するには

vcr upgrade

インストールされているCLIの現在のバージョンが表示されます。利用可能な新しいバージョンがある場合は、それをインストールするよう促されます。

注意：以下のコマンドを実行する必要があるかもしれません。 sudo をクリックして、Cloud Runtime CLI に新しい CLI バージョンをインストール・フォルダーに移動する権限を与えます。自分で移動することもできます。

CLIの使用

プロジェクトを初期化するには、以下のコマンドを実行して詳細を入力し始める：

vcr init

コマンドを実行すると、以下の情報を入力するプロンプトが表示される：

  • プロジェクト名プロジェクトの名前
  • インスタンス名:作成されるインスタンスの名前を入力します。1つのプロジェクトに複数のインスタンスを作成できるので、覚えやすい名前にしてください。
  • ランタイム:コード実行時に使用するランタイムを選択する。
  • 地域:インスタンスを実行する地域を選択します。
  • インスタンスのアプリケーションID:Vonage APIを使用するには、アプリケーションが必要です。使用するアプリケーションのアプリケーションIDを選択します。まだ作成していない場合は、このステップをスキップして後でIDを入力することができます。アプリケーションを作成するには アプリケーションページ を実行するか、Vonageダッシュボードで vcr app create.インスタンスをデプロイすると、Cloud Runtimeが自動的にアプリケーションのWebhookを設定します。
  • デバッグ用アプリケーションID:つまり、デプロイされたインスタンスと対応するアプリケーションとウェブフックは、ローカルデバッグの影響を受けません。
  • テンプレート:既存のプロジェクトを表示するには、リストからテンプレートを選択します。テンプレートの全リストは コード・ハブ

必要な情報をすべて入力したら vcr.yml configファイルが作成され、ここでスキップしたものを追加したり、先ほど提供した詳細を編集したりすることができます。テンプレートを選択した場合、そのアプリケーションの実行に必要なファイルもダウンロードされます。ローカルセットアップでこれらのファイルを開き、プロジェクトの表示と編集を始めることができます。

次のステップ

プロジェクトに取り組む際には、以下のリソースが役に立つでしょう：

  • デバッグ:プラットフォーム上にデプロイされたかのように、ローカルでコードをデバッグできます。
  • 配備:プロジェクトの準備ができたら、デプロイしてプラットフォーム上に実行インスタンスを素早く作成しよう。

アプリケーションの管理

を使用して、CLI から Vonage Applications を管理できます。 vcr app コマンドを使用する。

新しいアプリケーションを作成する：

vcr app create --voice --messages

既存のアプリケーションの秘密鍵と公開鍵を再生成する：

vcr app generate-keys --app-id YOUR_APPLICATION_ID

これはアプリケーションの既存のキー・ペアを置き換えます。新しい秘密鍵がダウンロードされるので、プロジェクトやシークレット内の参照を更新する必要があります。