配備
Vonage Cloud Runtimeでは、デプロイすることでプラットフォーム上に実行中のインスタンスを素早く作成することができます。デプロイはソースコードをコンフィギュレーション・ファイルでバンドルし、パッケージを作成します。パッケージはプラットフォームにアップロードされ、実行インスタンスとなります。
設定ファイル
コンフィギュレーション・ファイルは、アプリケーションのデバッグとデプロイ方法に関する情報をプラットフォームに与えます。以下に設定ファイルの例を示す：
- プロジェクト名は、プロジェクトのユニークな名前空間であり、多くのインスタンスを含むことができます。
- インスタンス名はインスタンスの一意な識別子です。
regionはインスタンスが実行される場所である。entrypointは、Vonage Cloud Runtimeプラットフォームにアプリケーションの起動方法に関する情報を提供します。build-scriptでは、プラットフォームがアプリケーションを構築する間に実行するスクリプトを指定できます。
オプションの詳細については、以下をご覧ください。 設定ファイルガイド.
注入された環境変数
プロジェクトをCloud Runtimeにデプロイする（または vcr debug)、プラットフォームはあなたのために環境変数を注入します。 environment オブジェクトを設定ファイルから取得します。
VCR_PORT
VCR_REGION
VCR_DEBUG
VCR_CODE_DIR
VCR_REGION_ID
VCR_PRIVATE_KEY
VCR_API_REGION_ID
VCR_API_ACCOUNT_ID
VCR_API_ACCOUNT_SECRET
VCR_API_APPLICATION_ID
VCR_INSTANCE_PUBLIC_URL
VCR_INSTANCE_SERVICE_NAME
アプリケーションのアドレスとポート
によって提供されるポートをリッスンする必要があります。 VCR_PORT 環境変数にバインドする。 0.0.0.0.VCRは、内部プロキシを経由して受信トラフィックをルーティングします。 localhost または 127.0.0.1 を使用すると、アプリケーションに到達できなくなります。
Node.js（Express）：
Python (FastAPI)：
行くんだ：
Java (Spring Boot)：
ルビー（シナトラ）：
PHPだ：
ヘルスチェック・ルート
Vonage Cloud Runtimeプラットフォームはルートを期待します、 /_/healthこれは、デプロイされたアプリケーションの健全性をチェックするために使用されます。このルートは、認証の背後にあるものであってはなりません。このルートが200ステータスを返さない場合、アプリケーションは再起動されます。ルートが見つからない場合、デプロイは失敗します。
30秒以内に200以外のステータスを返すことで、プラットフォームがアプリケーションを自動的に再起動させることができる。
Node.js（Express）：
Node.js (Fastify)：
Python (Flask)：
Python (FastAPI)：
行くんだ：
Java (Spring Boot)：
ルビー（シナトラ）：
PHPだ：
デプロイ方法
Vonage Cloud Runtime CLIを使用してデプロイできます。デプロイするには、以下を実行します：
資格情報が見つからないエラー」が発生した場合は、以下を実行してください。 vcr app generate-keys を使用して、Vonage Cloud Runtime用のVonageアプリケーションの認証情報を再生成します。
このコマンドは以下のことを行う：
- Vonageアプリケーションのコールバックを設定ファイルの
capabilitiesオブジェクトがある。 - カレントディレクトリをパッケージアップする。
- クラウド・ランタイム・プラットフォームにアップロードする。
- 設定ファイルで指定されている場合は、ビルドスクリプトを実行します。
- すべて成功したら
entrypoint.
デプロイの一部として大きなファイルや不要なファイルをアップロードしないようにするには .vcrignore ファイルで除外する。
デフォルトでは、deployコマンドは次のような設定ファイルを探します。 vcr.yml を実行する。別のコンフィギュレーション・ファイルを使用するには、以下を実行する：
例えば、現在のコードを次のようなコンフィギュレーション・ファイルでデプロイする。 production.yml あなたは走るだろう：
GitHub アクションでデプロイする
GitHub のワークフローにデプロイを組み込みたい場合は、デプロイを代行する GitHub Action を追加しましょう。アクションの主な手順は、コードをチェックアウトして クラウドランタイムCLIそしてdeployコマンドを実行する。ワークフローの例です。 ビルドスクリプト あなたのプロジェクトのカスタム面を処理する：
を交換する必要がある。 VONAGE_API_KEY, VCR_REGIONそして VCR_SHORT_REGION を、APIキーと対象地域の値で指定します：
| 地域 | VCR_REGION | VCR_SHORT_REGION | GraphQLエンドポイント |
|---|---|---|---|
| EU西地区（アイルランド） | euw1 | eu | https://api-eu.vonage.com/v1/vcr/euw1/api/graphql/v1/graphql |
| アメリカ東部（バージニア州） | use1 | us | https://api-us.vonage.com/v1/vcr/use1/api/graphql/v1/graphql |
| APサウスイースト（シンガポール） | apse1 | ap | https://api-ap.vonage.com/v1/vcr/apse1/api/graphql/v1/graphql |
| APサウスイースト（シドニー） | apse2 | ap | https://api-ap.vonage.com/v1/vcr/apse2/api/graphql/v1/graphql |
このワークフローは手動で実行されますが、PR がクローズされたときなどに実行するように編集することもできます。GitHub アクションについての詳細は 行動記録.
配備のトラブルシューティング
Vonage Cloud RuntimeプラットフォームがVonageアプリケーションの認証情報にアクセスできない場合、"credentials not found "エラーが表示されることがあります。CLIを使用して新しい秘密鍵ペアを生成できます：
vcr app generate-keys --app-id <app-id>
配置を見る
プロジェクトとデプロイメントを詳しく見るには Vonage Cloud Runtimeダッシュボード.
デプロイされたインスタンスをクリックすると、ログ、イベント、デプロイ履歴にアクセスできます。たとえば、[history] タブをクリックすると、このインスタンスのデプロイ履歴が表示されます：
プロジェクトに複数のインスタンスをデプロイした場合、それらはすべてダッシュボードに表示されます：
というプロジェクトである。 vapiつのコンフィギュレーション・ファイルがある。一方の設定ファイルには dev というインスタンスを持ち、もう一方は prod.これにより、同じコードを異なる環境で実行する複数のインスタンスを持つことができる。
インスタンスの削除
デプロイされたインスタンスを削除したい場合は、Vonage Cloud Runtime CLI の instance remove コマンドを使用できます：
vcr instance remove --project-name <project-name> --instance-name <instance-name>
そこで dev 上のスクリーンショットの例では、次のように実行する：
vcr instance remove --project-name vapi --instance-name dev
インスタンスIDを使用してインスタンスを削除することもできます：
vcr instance remove --id <instance-id>
警告：これは不可逆的な操作です！付属のステートとスケジューラも永久に削除されます。
インスタンス一覧
アカウントにデプロイされたすべてのインスタンスを見るには、以下を実行する：
インスタンスログの表示
CLIを使用して、デプロイされたインスタンスからログを取得できます：
ストリーミング・ログ
を使用する。 --follow (-f) フラグを指定すると、新しいログエントリが到着したときに継続的にストリーミングされます。 tail -f:
Ctrl+Cでストリーミングを停止する。
ログのフィルタリング
以下のオプションのフラグを使って、ログ出力を絞り込むことができる：
| フラッグ | ショート | 説明 |
|---|---|---|
--history <n> | 最初に取得する履歴エントリ数 (デフォルト: 300) | |
--log-level <level> | -l | 最小ログレベル： trace, debug, info, warn, error, fatal |
--source-type <type> | -s | ソースでフィルタリングする： application または provider |
例を挙げよう：
IPアドレス許可リスト
システムへのアクセスを制限したい場合、各地域のVonage Cloud Runtime IPアドレスは以下の通りです：
EU西 aws.euw1
- 52.215.68.46
- 46.137.9.43
- 54.72.25.154
米国西部 aws.use1
- 54.87.47.119
- 3.224.186.73
- 35.153.45.51
APAC 東南アジア aws.apse1
- 13.251.207.33
- 52.76.50.31
- 54.169.132.8
APAC南東部 (シドニー) aws.apse2
- 52.62.122.28
- 13.236.199.68
- 52.63.14.36