Docker への Voice Gateway Text to Speech Adapter のデプロイ

This documentation applies to a beta feature of IBM® Voice Gateway. For terms of use, see the beta license agreement.

オンプレミス・インストールでは、IBM® Voice Gateway 環境の一部として Text to Speech Adapter を Docker にデプロイします。 Voice Gateway の Text to Speech Adapter は、個別の Docker イメージとしてパッケージ化されており、コア SIP Orchestrator イメージおよび Media Relay イメージとともに構成およびデプロイします。

始めに

Voice Gateway のデプロイメント・オプションを十分に理解し、『Voice Gateway の開始』の説明に従い基本環境をデプロイします。
以下の Watson サービスのインスタンスの資格情報を見つけ、メモします。
- Watson Assistant
- Speech to Text
Text to Speech サービス・インスタンスは不要です。
Google Cloud に登録し、Cloud Text-to-Speech API のクイックスタートの資料に従い、以下のステップを実行します。
1. Cloud Speech API を有効にする Google Cloud プロジェクトを作成します。
2. プロジェクトのサービス・アカウントを作成します。
3. サービス・アカウントの資格情報が含まれる、秘密鍵の JSON ファイルをダウンロードします。

Docker への Text to Speech Adapter のデプロイ

以下の指示は、Docker に基本 Voice Gateway 環境を既に正しくデプロイしていることを前提とします。 Docker デプロイメントで最初に行うすべてのセットアップについては、Docker への Voice Gateway のデプロイを参照してください。

Voice Gateway のデプロイ元のディレクトリーに移動し、最新イメージをプルします。コア Voice Gateway イメージ、つまり、SIP Orchestrator イメージ (voice-gateway-so) と Media Relay イメージ (voice-gateway-mr)、および Text to Speech Adapter イメージ (voice-gateway-tts-adapter) が必要です。

ヒント: Voice Gateway を以前にデプロイした場合、既存のイメージを使用できます。
```
 docker pull ibmcom/voice-gateway-so:latest
 docker pull ibmcom/voice-gateway-mr:latest
 docker pull ibmcom/voice-gateway-tts-adapter:latest
```
sample.voice.gateway GitHub リポジトリーを複製し、以下のサンプル・ファイルが含まれる tts-adapter ディレクトリーに移動します。
- docker-compose.yml: Voice Gateway と Text to Speech Adapter をデプロイするための最小構成が事前構成されている Docker デプロイメント・ファイル
docker-compose.yml ファイルをデプロイメント・ディレクトリーにコピーします。
docker-compose.yml ファイルで、Watson Assistant、Speech to Text サービス、および Google Cloud Text-to-Speech API を構成するための環境変数のいずれかがブランクであれば、それらの環境変数に入力します。

ヒント: 前のデプロイメントでは、tts.adapter コンテナーの構成を既存の docker-compose.yml ファイルに追加するだけです。
- sip.orchestrator コンテナーで、次の例に示すように、Watson Assistant の資格情報およびワークスペース ID を指定します。
```
sip.orchestrator:
 ...
 environment:
   - WATSON_CONVERSATION_URL=https://gateway.watsonplatform.net/conversation/api/
   - WATSON_CONVERSATION_USERNAME=9h7f54cb-d9ed-46b3-8492-e9a9bf555021
   - WATSON_CONVERSATION_PASSWORD=InWtiUpYhF1Z
   - WATSON_CONVERSATION_WORKSPACE_ID=a23de67h-e527-40d5-a867-5c0ce9e72d0d
```
  - media.relay コンテナーで、Speech to Text サービスの資格情報を構成します。
```
 media.relay:
 ...
 environment:
   - WATSON_STT_USERNAME=9h7f54cb-5epb-80d6-45c3-da41d2bf7a71
   - WATSON_STT_PASSWORD=asxNzDLpIJ6F
   - WATSON_STT_URL=https://stream.watsonplatform.net/speech-to-text/api
```
  - tts.adapter コンテナーで、Google Cloud プロジェクトからダウンロードした資格情報の JSON ファイルをマウントします。また、GOOGLE_APPLICATION_CREDENTIALS 環境変数でコンテナー内のロケーションを指定します。
  英語以外の言語を指定する場合、GOOGLE_TTS_VOICE_LANGUAGE_CODE 環境変数で BCP-47 言語タグを指定します。例えば、スペイン語 (スペイン) の場合、es-ES を指定します。言語をサポートするには、Voice Gateway と統合するすべてのサービス (サード・パーティーの音声サービス、および Watson Assistant サービスを含む) がその言語をサポートしている必要があります。詳しくは、サポートされる言語を参照してください。
  
  例:
```
 tts.adapter:
   ...
   environment:
     - GOOGLE_APPLICATION_CREDENTIALS=/tts-adapter/credentials/google-service-account.json
     - GOOGLE_TTS_VOICE_LANGUAGE_CODE=es-ES
   volumes:
     - "/path/to/credentials/google-service-account.json:/tts-adapter/credentials/google-service-account.json"
```
以下のコマンドを実行して、コンテナーを始動します。
```
 docker-compose up
```

次の作業

docker-compose.yml ファイルを編集してから、コンテナーを再デプロイすることにより、Voice Gateway デプロイメントをさらに構成できます。