チュートリアル: Amazon Alexa Skill をデプロイするパイプラインを作成する

このチュートリアルでは、デプロイステージでデプロイプロバイダとして Alexa Skills Kit を使用して Alexa スキルを継続的にデリバリーするパイプラインを設定します。ソースリポジトリのソースファイルに変更を加えると、完成したパイプラインはスキルの変更を検出します。次に、パイプラインは Alexa Skills Kit を使用して、その変更を Alexa スキル開発ステージにデプロイします。

注記

この機能は、アジアパシフィック (香港) リージョンまたはヨーロッパ (ミラノ) リージョンではご利用いただけません。そのリージョンで利用可能な他のデプロイアクションを使用するには、デプロイアクションの統合。

カスタムスキルを Lambda 関数として作成するには、カスタムスキルをAWSLambda 関数。Lambda ソースファイルと CodeBuild プロジェクトを使用するパイプラインを作成して、スキルの Lambda への変更をデプロイすることもできます。たとえば、新しいスキルおよび関連する Lambda 関数を作成するには、AWS CodeStar プロジェクトを作成します。「」を参照してください。AWS CodeStar で Alexa スキルプロジェクトを作成する。このオプションの場合、パイプラインには CodeBuild アクションを含む 3 番目のビルドステージと、AWS CloudFormation。

Prerequisites

以下のものを用意しておく必要があります。

• CodeCommit リポジトリです。「チュートリアル: シンプルなパイプラインを作成する (CodeCommit リポジトリ)」で作成した AWS CodeCommit リポジトリを使用できます。

• Amazon 開発者アカウント。これは Alexa スキルを所有するアカウントです。Alexa Skills Kit でアカウントを無料で作成できます。

• Alexa スキル。「カスタムスキルサンプルコードを取得する」チュートリアルを使用してサンプルスキルを作成できます。

• ASK CLI をインストールし、ask initとAWS認証情報。「ASK CLI のインストールと初期化」を参照してください。

ステップ 1: Alexa デベロッパーサービス LWA セキュリティプロファイルの作成

このセクションでは、Login with Amazon (LWA) で使用するセキュリティプロファイルを作成します。プロファイルがすでにある場合、このステップは省略できます。

• 「generate-lwa-tokens」の手順を使用して、セキュリティプロファイルを作成します。

• プロファイルを作成したら、[クライアント ID] と [クライアントシークレット] の値をメモしておきます。

• それらの手順に従って [Allowed Return URLs (許可されたリターン URL)] に入力します。これらの URL を ASK CLI コマンドで使用して、更新トークンリクエストをリダイレクトできます。

ステップ 2: Alexa スキルのソースファイルを作成して CodeCommit リポジトリにプッシュする

このセクションでは、Alexa スキルのソースファイルを作成し、パイプラインによってソースステージに使用されるリポジトリにプッシュします。Amazon 開発者コンソールで作成したスキル用に、以下のものを作成してプッシュします。

• skill.json ファイル。

• interactionModel/custom フォルダ。

  注記

  このディレクトリ構造は、「スキルパッケージ形式」で説明されているように、Alexa Skills Kit スキルパッケージ形式の要件に準拠しています。ディレクトリ構造で正しいスキルパッケージ形式が使用されていない場合、変更は Alexa Skills Kit コンソールに正常にデプロイされません。

スキルのソースファイルを作成するには

1. Alexa Skills Kit 開発者コンソールからスキル ID を取得します。以下のコマンドを使用します。

   ask api list-skills

   名前に基づいてスキルを見つけ、skillId フィールドで、関連付けられた ID をコピーします。

2. スキルの詳細を含む skill.json ファイルを生成します。以下のコマンドを使用します。

   ask api get-skill -s skill-ID > skill.json

3. (オプション) interactionModel/custom フォルダを作成します。

   以下のコマンドを使用して、フォルダ内にインタラクションモデルファイルを生成します。locale について、このチュートリアルではファイル名のロケールとして en-US を使用します。

   ask api get-model --skill-id skill-ID --locale locale >
       ./interactionModel/custom/locale.json

ファイルを CodeCommit リポジトリにプッシュするには

1. ファイルを CodeCommit リポジトリにプッシュまたはアップロードします。これらのファイルは、によって作成されたソースアーティファクトです。パイプラインを作成するウィザードで、デプロイメントアクションのAWS CodePipeline。ファイルは、ローカルディレクトリに次のように表示されます。

   skill.json
   /interactionModel
     /custom
       |en-US.json

2. ファイルをアップロードする方法を選択します。

   1. ローカルコンピュータで複製されたリポジトリから Git コマンドラインを使用するには:

      1. 以下のコマンドを実行して、すべてのファイルを一度にステージングします。

         git add -A

      2. 以下のコマンドを実行して、コミットメッセージによりファイルをコミットします。

         git commit -m "Added Alexa skill files"

      3. 以下のコマンドを実行して、ローカルリポジトリから CodeCommit リポジトリにファイルをプッシュします。

         git push

   2. CodeCommit コンソールを使用してファイルをアップロードするには:

      1. CodeCommit コンソールを開き、リポジトリリスト

      2. [Add file]、[Upload file] の順に選択します。

      3. [Choose file] を選択し、ファイルを参照します。ユーザー名とメールアドレスを入力して、変更をコミットします。[変更のコミット] を選択します。

      4. アップロードするファイルごとにこのステップを繰り返します。

ステップ 3: ASK CLI コマンドを使用して更新トークンを作成する

CodePipeline は、Amazon 開発者アカウントのクライアント ID とシークレットに基づく更新トークンを使用して、お客様の代わりに実行するアクションを承認します。このセクションでは、ASK CLI を使用してトークンを作成します。[パイプラインを作成する] ウィザードでこれらの認証情報を使用します。

Amazon 開発者アカウントの認証情報を使用して更新トークンを作成するには

1. 次の コマンドを使用します。

   ask util generate-lwa-tokens

2. プロンプトが表示されたら、以下の例に示すようにクライアント ID とシークレットを入力します。

   ? Please type in the client ID: 
   amzn1.application-client.example112233445566
   ? Please type in the client secret:
   example112233445566

3. サインインのブラウザページが表示されます。Amazon アカウント認証情報を使用してサインインします。

4. コマンドライン画面に戻ります。アクセストークンと更新トークンが出力に生成されます。出力に返された更新トークンをコピーします。

ステップ 4: パイプラインを作成する

このセクションでは、次のアクションを使用してパイプラインを作成します。

• CodeCommit アクションを含むソースステージ。ここでは、ソースアーティファクトは、スキルをサポートする Alexa スキルファイルです。

• Alexa Skills Kit のデプロイアクションを含むデプロイステージ。

ウィザードを使用してパイプラインを作成するには

1. にサインインします。AWS Management Consoleを開き、CodePipeline コンソールをhttp://console.aws.amazon.com/codesuite/codepipeline/home。

2. プロジェクトとそのリソースを作成する AWS リージョンを選択します。Alexa スキルランタイムは、以下のリージョンでのみ利用できます。

   • アジアパシフィック (東京)

   • 欧州 (アイルランド)

   • 米国東部（バージニア北部）

   • 米国西部 (オレゴン)

3. [ようこそ] ページ、[Getting started (開始方法)] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。

4. Eclipseステップ 1: パイプラインの設定の選択, でパイプライン名にMyAlexaPipeline。

5. Eclipseサービスロール] で、新しいサービスロールCodePipeline が IAM でのサービスロールの作成を許可します。

6. [詳細設定] をデフォルト設定のままにし、[次へ] を選択します。

7. Eclipseステップ 2: ソースステージの追加, でソースプロバイダー] で、AWS CodeCommit。Eclipseリポジトリ名で、「」で作成した CodeCommit リポジトリの名前を選択します。ステップ 1: CodeCommit リポジトリを作成する。[Branch name] で、最新のコード更新を含むブランチの名前を選択します。

   リポジトリ名とブランチを選択した後、このパイプラインのために作成される Amazon CloudWatch Events ルールを示すメッセージが表示されます。

   [Next] を選択します。

8. Eclipseステップ 3: ビルドステージの追加] で、ビルドステージのスキップを選択して、警告メッセージを受け入れます。スキップをクリックします。

   [Next] を選択します。

9. Eclipseステップ 4: デプロイステージの追加:

   1. [デプロイプロバイダ] で、[Alexa Skills Kit] を選択します。

   2. [Alexa skill ID (Alexa スキル ID)] に、Alexa Skills Kit 開発者コンソールでスキルに割り当てられているスキル ID を入力します。

   3. [クライアント ID] に、登録したアプリケーションの ID を入力します。

   4. [Client secret (クライアントシークレット)] に、登録時に選択したシークレットを入力します。

   5. [Refresh token (更新トークン)] に、ステップ 3 で生成したトークンを入力します。

      

   6. [Next] を選択します。

10. Eclipseステップ 5: 確認をクリックし、情報を確認してから、[パイプラインの作成。

    

ステップ 5: 任意のソースファイルに変更を加えてデプロイを確認する

スキルに変更を加え、その変更をリポジトリにプッシュします。これにより、パイプラインの実行がトリガーされます。スキルが Alexa Skills Kit 開発者コンソールで更新されていることを確認します。