このハウツーでは、Botの開発、テスト、パイロット、本番リリースの目的で、最終的にエンドユーザーがBotを利用できるようになるまでに複数の段階を設定しているシナリオについて説明します。
例題
開発者がBotの開発を完了し、QAチームがBotにアクセスしてテストするのに際し、Botをテスト環境に移行させる必要がある場合を考えてみます。Botの定義は、いくつかの環境固有の値を除いて大幅に変更されることはありません。
このドキュメントでは、Botのエクスポートおよびインポート機能を使用して同じことを実現する方法をご紹介します。Botのインポートとエクスポートの詳細については、こちらを参照してください。
Pre-requisites
- Botビルドナレッジ
- 完全に開発され、機能しているBotが必要となります。ここでは、バンキングBotを使用します。
導入
ステップ1-Botのエクスポート
- 開発環境からテスト環境に移行するBotを開きます。
- 設定 -> Bot管理からBotのエクスポートオプションを選択します。
- エクスポートしたいBotコンポーネントを選択します。最初はすべてのコンポーネントをエクスポートしますが、その後は選択したコンポーネントのみをエクスポートするよう選択できます。
- エクスポートをクリックします。
- Bot定義はZIPファイルとしてエクスポートされます。
- このファイルは、Bot定義をコードリポジトリにチェックインしたり、任意のチケットシステムに送ったりするために使用できます。
ステップ2-config.jsonの修正
- 環境固有の値を必要とするすべての変数は、エクスポートしたファイルに含まれるconfig.jsonファイルで利用できます。
- これらのグローバル変数を更新します(グローバル変数の詳細については、こちらをご覧くださいまた事例についてはこちらをご覧ください)。
- これで、インフラストラクチャ/DevOpsチームとファイルを共有して、他の環境でのデプロイを開始できます。
- 権限がある場合は、以下のステップに従ってBotをターゲット環境にインポートできます。
ステップ3-Botのインポート
- 前のステップでエクスポートしたzipファイルからファイルを抽出します。
- テスト環境で、新しいBotを作成します。
- 設定 -> Bot管理からBotのインポートオプションを選択します。
- 前のステップから、Bot定義ファイル、Bot設定ファイル、カスタムスクリプトファイル(ある場合)を選択します。
- フルインポートのインポートオプションを選択します。既存のBotにこのオプションを使用する場合、現在のBot設定は消去され、インポートされたBotに置き換えられることに注意してください。
- インポートをクリックします。
- Botがテスト環境に置かれ、QAチームによるテストが可能になります。
ステップ4-Botの更新
Botを変更すると、その変更をテスト環境のBotに適用する必要がある場合があります。
- 開発環境から、変更されたBotを開きます。
- 設定 -> Bot管理からBotのエクスポートオプションを選択します。
- エクスポートしたいBotコンポーネントを選択します。変更したコンポーネントのみをエクスポートするように設定することもできます。
- エクスポートをクリックします。
- Bot定義はZIPファイルとしてエクスポートされます。
- zipファイルからファイルを抽出します。
- エクスポートしたファイルに存在するconfig.jsonファイルで、環境固有の値を必要とする変数値を変更します。
- テスト環境で、更新が必要なBotを開きます。
- 設定 -> Bot管理からBotのインポートオプションを選択します。
- 前の抽出ステップから、Bot定義ファイル、Bot設定ファイル、カスタムスクリプトファイル(ある場合)を選択します。
- 増分インポートのインポートオプションを選択します。
- インポートをクリックします。
- 更新されたBotがテスト環境に置かれ、QAチームによるテストが可能になります。