Recommended
More Related Content
Viewers also liked
Viewers also liked (20)
Similar to 【JAWS-UG Shimane vol.5 】[ハンズオン]サーバーレスで作るチャットBot
Similar to 【JAWS-UG Shimane vol.5 】[ハンズオン]サーバーレスで作るチャットBot (20)
【JAWS-UG Shimane vol.5 】[ハンズオン]サーバーレスで作るチャットBot
- 2. イントロダクション ⾃自⼰己紹介 ▸ 伊藤博司(いとうひろし) ▸ 株式会社オプティマ ▸ 島根開発センター所属 ▸ ソフトウェアエンジニア ▸ 好きなAWSサービス→ Lambda, API Gateway 2
- 3. イントロダクション アジェンダ ▸ 使⽤用するAWSサービス ▸ サーバーレス・アーキテクチャーとは ▸ ハンズオンの注意 ▸ ハンズオン ▸ 1-‐‑‒1 天気予報 API の作成 ▸ 1-‐‑‒2 天気予報 API の修正 ▸ 2-‐‑‒1 Bot の作成 ▸ 2-‐‑‒2 Bot との連携 ▸ 2-‐‑‒3 Slack との連携 ▸ 3-‐‑‒1 Citiesテーブルの作成 ▸ 3-‐‑‒2 Botの修正1 ▸ 3-‐‑‒3 Botの修正2 3
- 4. イントロダクション 使⽤用するAWSサービス ▸ AWS Lambda ▸ サーバーのプロビジョニング(準備)をせずにコードを実⾏行行 ▸ 最⼤大５分まで実⾏行行可能 ▸ 利利⽤用可能な⾔言語 ▸ Node.js(v0.10 および v4.3) ・ Python ・ Java8 ▸ AWS API Gateway ▸ RESTfulAPIの作成と管理理 ▸ Lambda・外部 WEB サービス(Proxy)・AWS のサービスAPIを呼び出し可能 ▸ Amazon DynamoDB ▸ マネージドな NoSQL データベースサービス ▸ スキーマレス 4
- 10. サーバーレス・アーキテクチャーとは サーバーレス・アーキテクチャー 10 障害の考慮 →ＡＷＳ任せ 負荷分散 →ＡＷＳ任せ ロギング・モニタリング →ＡＷＳ任せ パッチの適⽤用 →ＡＷＳ任せ 常時稼働 イベント起動
- 11. サーバーレス・アーキテクチャーとは サーバーレス・アーキテクチャー 11 フルマネージド・サービスを使って、運⽤用管理理はAWSにおまかせ イベント発⽣生分の使⽤用料料を⽀支払えば良良いので、コスト効率率率が良良い 障害の考慮 →ＡＷＳ任せ 負荷分散 →ＡＷＳ任せ ロギング・モニタリング →ＡＷＳ任せ パッチの適⽤用 →ＡＷＳ任せ 常時稼働 イベント起動
- 12. サーバーレス・アーキテクチャーとは 特徴 ▸ イベントドリブン型のアーキテクチャー ▸ サーバーを稼働し続けず、必要な時にリソースを使う ▸ 使った分だけ課⾦金金されるため、コスト効率率率が良良い ▸ メンテナンスやキャパシティーの⼼心配事から開放される ▸ 運⽤用に関わるコストを削減できる 12
- 13. ハンズオン
- 14. ハンズオン ⽤用意するもの ▸ AWS アカウント ▸ https://portal.aws.amazon.com/gp/aws/developer/ registration/index.html ▸ Slack チーム ▸ https://slack.com/ 14
- 15. ハンズオン ハンズオンの⽬目的 ▸ Slack のメッセージに反応する簡単な ChatBot 作成を通して、 API Gateway / Lambda / DynamoDB の理理解を深める ▸ サーバーレスアーキテクチャーの具体例例を体験する 15
- 16. ハンズオン ハンズオンの注意点 ▸ ハンズオンで使⽤用するリソース名などは、誤って設定すると Bot が正しく動作しません。 直接⼊入⼒力力せずに、以下ページからコピペしてください。 ▸ https://github.com/s1hit/20160604_̲aws_̲handson ▸ 当ハンズオンの⼿手順は、以下５つのリージョンで実施可能ですが(2016/6/4現在) 資料料上は「バージニア北北部」にて説明しています。 ▸ バージニア北北部 ▸ オレゴン ▸ アイルランド ▸ フランクフルト ▸ 東京 16
- 17. ハンズオン#1-‐‑‒1 天気予報 API の作成
- 18. ハンズオン#1-‐‑‒1 天気予報 API の作成 概要 ▸ API Gateway で天気予報 API を作成する ▸ livedoor 社の「お天気Webサービス」にリクエストし、レ スポンスをそのまま返却（Proxy） ▸ 地域は「松江市」固定 18 API Gateway お天気Webサービス @livedoor クライアント (ブラウザ) １ ２ ３４
- 19. ハンズオン#1-‐‑‒1 天気予報 API の作成 「⽶米国東部(バージニア北北部)」リージョンを選択 19
- 20. ハンズオン#1-‐‑‒1 天気予報 API の作成 API Gateway を開く 20
- 21. ハンズオン#1-‐‑‒1 天気予報 API の作成 今すぐ始める もしくは API の作成をクリック 21
- 22. ハンズオン#1-‐‑‒1 天気予報 API の作成 「ChatBot」 API を新規作成 22 「ChatBot」
- 23. ハンズオン#1-‐‑‒1 天気予報 API の作成 API のメソッドを追加 23
- 24. ハンズオン#1-‐‑‒1 天気予報 API の作成 GET を選択 24 チェックボタンで確定
- 25. ハンズオン#1-‐‑‒1 天気予報 API の作成 バックエンド(HTTP Proxy)の設定 25 https://github.com/s1hit/20160604_̲aws_̲handson#p25 よりコピペ
- 26. ハンズオン#1-‐‑‒1 天気予報 API の作成 メソッドの実⾏行行画⾯面の説明 26 クライアント API Gateway からクライアントへの レスポンスの設定 バックエンドから API Gateway への レスポンスの設定 バックエンド API Gateway からバックエンドへの リクエストの設定 クライアントから API Gateway への リクエストの設定
- 27. ハンズオン#1-‐‑‒1 天気予報 API の作成 統合レスポンスの設定を開く 27
- 28. ハンズオン#1-‐‑‒1 天気予報 API の作成 本⽂文マッピングテンプレートを変更更 28
- 29. ハンズオン#1-‐‑‒1 天気予報 API の作成 レスポンスの JSON を編集 29 https://github.com/s1hit/20160604_̲aws_̲handson#p29よりコピペ ※マッピングテンプレートを編集せずともレスポンスは 表⽰示されますが、ブラウザ上にUTF-‐‑‒8のエスケープシーケンスが そのまま表⽰示されてしまうため、⼀一⼿手間かけます。
- 30. ハンズオン#1-‐‑‒1 天気予報 API の作成 マッピングテンプレートを保存 30
- 31. ハンズオン#1-‐‑‒1 天気予報 API の作成 マッピングテンプレートを保存 31 上の保存もクリックしないと、画⾯面遷移で 下のエディタ部分が元に戻ってしまうので 必ずクリックする
- 32. ハンズオン#1-‐‑‒1 天気予報 API の作成 メソッドの実⾏行行画⾯面へ戻る 32
- 33. ハンズオン#1-‐‑‒1 天気予報 API の作成 メソッドレスポンスの設定を開く 33
- 34. ハンズオン#1-‐‑‒1 天気予報 API の作成 レスポンスヘッダーの Content-‐‑‒Typeを変更更 34
- 35. ハンズオン#1-‐‑‒1 天気予報 API の作成 レスポンスの⽂文字コードを utf-‐‑‒8 に 35 https://github.com/s1hit/20160604_̲aws_̲handson#p35 よりコピペ
- 36. ハンズオン#1-‐‑‒1 天気予報 API の作成 戻る 36
- 37. ハンズオン#1-‐‑‒1 天気予報 API の作成 API のテスト 37
- 38. ハンズオン#1-‐‑‒1 天気予報 API の作成 レスポンスを確認 38
- 39. ハンズオン#1-‐‑‒1 天気予報 API の作成 API のデプロイ 39
- 40. ハンズオン#1-‐‑‒1 天気予報 API の作成 ステージの新規作成 40
- 41. ハンズオン#1-‐‑‒1 天気予報 API の作成 「prod」ステージとしてデプロイ 41
- 42. ハンズオン#1-‐‑‒1 天気予報 API の作成 デプロイされた API の URL 42
- 43. ハンズオン#1-‐‑‒1 天気予報 API の作成 ブラウザで開いて確認 43
- 44. ハンズオン#1-‐‑‒2 天気予報 API の修正
- 45. ハンズオン#1-‐‑‒2 天気予報 API の修正 概要 ▸ 天気予報の地域をクライアントから指定できるようにする ▸ API Gateway の GET メソッドにパラメータを追加 ▸ 結果レスポンスを、天気予報タイトルと天気概要のみにする ▸ 天気 API からのレスポンス内容を API Gateway で編集 45 API Gateway お天気Webサービス @livedoor クライアント (ブラウザ) リクエストパラメータで地域を指定 地域を引き渡し 結果をフォーマット
- 46. ハンズオン#1-‐‑‒2 天気予報 API の修正 Resources 画⾯面に戻る 46
- 47. ハンズオン#1-‐‑‒2 天気予報 API の修正 GET メソッドを選択 47
- 48. ハンズオン#1-‐‑‒2 天気予報 API の修正 メソッドリクエストの設定を開く 48
- 49. ハンズオン#1-‐‑‒2 天気予報 API の修正 URL クエリ⽂文字列列 パラメータの追加 49
- 50. ハンズオン#1-‐‑‒2 天気予報 API の修正 パラメータ「city」を定義 50
- 51. ハンズオン#1-‐‑‒2 天気予報 API の修正 統合リクエストの設定を開く 51
- 52. ハンズオン#1-‐‑‒2 天気予報 API の修正 Endpoint URL を変更更 52 “?city=320010” を削る
- 53. ハンズオン#1-‐‑‒2 天気予報 API の修正 「city」パラメーターが追加されていることを確認 53
- 54. ハンズオン#1-‐‑‒2 天気予報 API の修正 統合レスポンスの設定を開く 54
- 55. ハンズオン#1-‐‑‒2 天気予報 API の修正 本⽂文のマッピングテンプレートを変更更 55
- 56. ハンズオン#1-‐‑‒2 天気予報 API の修正 「title」と「text」のみを返却する JSON に変更更 56 https://github.com/s1hit/20160604_̲aws_̲handson#p56 よりコピペ
- 57. ハンズオン#1-‐‑‒2 天気予報 API の修正 統合レスポンス設定の保存 57
- 58. ハンズオン#1-‐‑‒2 天気予報 API の修正 テスト 58
- 59. ハンズオン#1-‐‑‒2 天気予報 API の修正 テスト 59 「320010」を⼊入⼒力力
- 60. ハンズオン#1-‐‑‒2 天気予報 API の修正 再度度デプロイ 60
- 61. ハンズオン#1-‐‑‒2 天気予報 API の修正 今回は「dev」ステージに対してデプロイ 61
- 62. ハンズオン#1-‐‑‒2 天気予報 API の修正 開発⽤用 URL にアクセス 62
- 63. ハンズオン#1-‐‑‒2 天気予報 API の修正 ブラウザで開いて確認 63 「city」パラメーター未指定のため返却値なし
- 64. ハンズオン#1-‐‑‒2 天気予報 API の修正 ブラウザで開いて確認 64 「?city=320010」を追加
- 65. ハンズオン#1-‐‑‒2 天気予報 API の修正 「prod」ステージに対しても同様の内容をリリース 65 「prod」ステージの API バージョン
- 66. ハンズオン#1-‐‑‒2 天気予報 API の修正 「prod」ステージに対しても同様の内容をリリース 66 最新のデプロイバージョンを選択
- 67. ハンズオン#1-‐‑‒2 天気予報 API の修正 本番⽤用 URL で確認 67
- 69. ハンズオン#2-‐‑‒1 Bot の作成 概要(ハンズオン#2-‐‑‒1〜～2-‐‑‒3) ▸ Botを作成する ▸ Slack から受け取ったメッセージをそのまま返却するLambdaファ ンクションを作成(エコーBot) ▸ API Gateway から Lambda ファンクションを呼び出し ▸ Slack の OutgoingWebhooks で API Gateway を叩く 69 API Gateway Lambda(Bot)Slack メッセージ：”TEST” メッセージ：”TEST” １ ２ ３４
- 71. ハンズオン#2-‐‑‒1 Bot の作成 Get Started Now もしくは Create a Lambda function をクリック 71
- 72. ハンズオン#2-‐‑‒1 Bot の作成 BluePrint はスキップ 72
- 74. ハンズオン#2-‐‑‒1 Bot の作成 SlackBot のソースコード 74 トークンが不不正 Botからのメッセージ エコーを⾏行行う
- 75. ハンズオン#2-‐‑‒1 Bot の作成 Lambda ファンクションの実⾏行行ロールを作成 75
- 76. ハンズオン#2-‐‑‒1 Bot の作成 Lambda ファンクションの実⾏行行ロールを作成 76 Lambda ファンクション実⾏行行に必要な権限
- 78. ハンズオン#2-‐‑‒1 Bot の作成 作成される Lambda ファンクションの内容を確認 78
- 79. ハンズオン#2-‐‑‒1 Bot の作成 Bot の作成が完了了 79 C
- 81. ハンズオン#1-‐‑‒1 天気予報 API の作成 API Gateway を開く 81
- 83. ハンズオン#2-‐‑‒2 Bot との連携 Slack ⽤用リソースを追加 83
- 84. ハンズオン#2-‐‑‒2 Bot との連携 Slack ⽤用リソースを追加 84 「slack」と⼊入⼒力力
- 85. ハンズオン#2-‐‑‒2 Bot との連携 POST メソッドを追加 85
- 86. ハンズオン#2-‐‑‒2 Bot との連携 POST メソッドを追加 86
- 87. ハンズオン#2-‐‑‒2 Bot との連携 先ほど作成した Lambda ファンクションを指定 87
- 88. ハンズオン#2-‐‑‒2 Bot との連携 API にBot の実⾏行行権限を与える 88
- 90. ハンズオン#2-‐‑‒2 Bot との連携 Slack からのリクエストをBot に渡す設定 90 テンプレートが定義されていない場合のみ バックエンドにリクエスト本⽂文を渡す(推奨)
- 91. ハンズオン#2-‐‑‒2 Bot との連携 Slack からのリクエストをBot に渡す設定 91 https://github.com/s1hit/20160604_̲aws_̲handson#p91 よりコピペ
- 92. ハンズオン#2-‐‑‒2 Bot との連携 Slack からのリクエストをBot に渡す設定 92 https://github.com/s1hit/20160604_̲aws_̲handson#p92 よりコピペ
- 100. ハンズオン#2-‐‑‒3 Slack との連携 API Gatewayへメッセージ連携するためのOutgoing WebHooks 100
- 101. ハンズオン#2-‐‑‒3 Slack との連携 Botと連携させるチャンネル情報の設定 101 先ほど作成したChannel名 すべてのメッセージに反応させるため 空にしておく
- 102. ハンズオン#2-‐‑‒3 Slack との連携 BotのURLを指定 102 API GatewayのエンドポイントURL 〜～/prodのあとに/slackを忘れずに
- 103. ハンズオン#2-‐‑‒3 Slack との連携 Bot がリクエスト元を特定するための Token を控えておく 103 クリップボードにコピーしておく
- 105. ハンズオン#2-‐‑‒3 Slack との連携 API Gatewayに戻り、prodステージのステージ変数を追加 105
- 106. ハンズオン#2-‐‑‒3 Slack との連携 slack token を設定 106 「slackToken」と⼊入⼒力力 ※Tのみ⼤大⽂文字 先ほどコピーしたtokenをペースト
- 107. ハンズオン#2-‐‑‒3 Slack との連携 Bot の設定が全て完了了 107
- 108. ハンズオン#2-‐‑‒3 Slack との連携 Bot連携の設定をしたチャンネルでテスト 108 正しく設定できていれば Botからのレスポンスが来る
- 110. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 概要 ▸ Citiesテーブルを作成する ▸ 全国地点定義表のデータを格納(142件) ▸ 地域名(e.g. 松江)と地域ID(e.g. 320010)の対応 ▸ Lambda から初期化⽤用データを投⼊入 110 Lambda (データ投⼊入⽤用ファンクション) DynamoDB (Citiesテーブル) データ投⼊入 テーブル作成
- 112. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 Create table もしくは テーブルの作成 をクリック 112
- 113. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 DynamoDB テーブルを作成 113 「Cities」と⼊入⼒力力 「cityName」と⼊入⼒力力 チェックを外す
- 119. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 blueprint は simple-‐‑‒mobile-‐‑‒backend を選択 119
- 120. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 ファンクション名を⼊入⼒力力 120 「PutCityData」と⼊入⼒力力 ※データ投⼊入ファンクションは⽇日本語を含むコードとなっており、 このタイミングでペーストすると⽂文字化けしてしまうため ひとまずサンプルコードのまま作成する
- 121. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 DynamoDBにアクセス可能なロールを作成 121 Basic with DynamoDB を選択
- 125. ハンズオン#3-‐‑‒1 Citiesテーブルの作成 リンク先のコードで上書き 125 https://github.com/s1hit/20160604_̲aws_̲handson#p125をコピペ
- 126. ハンズオン#2-‐‑‒1 Bot の作成 PutCityData のソースコード 126 地点定義データ 地点定義データ分ループし、DynamoDB へのputItem命令令を配列列に⼊入れる putItemを実⾏行行
- 132. ハンズオン#3-‐‑‒2 Botの修正1
- 133. ハンズオン#3-‐‑‒2 Botの修正1 概要 ▸ Botの修正 ▸ @bot というメンション付きのメッセージにのみ反応 ▸ @bot に続くコマンドを認識識して処理理を分ける ① 「/echo メッセージ」の場合、メッセージをそのまま返却 ② 「/city 地域名」の場合、地域IDを返却 133 API Gateway Lambda(Bot)Slack ①メッセージ：@bot /echo テスト ②メッセージ：@bot /city 松江 ①メッセージ：テスト ②メッセージ：松江のIDは320010です。 DynamoDB(Cities) ①ー１ ②ー１ ①ー４ ②ー６ ①ー２ ①ー３ ②ー５ ②ー２ ②ー３ ②ー４
- 136. ハンズオン#3-‐‑‒2 Botの修正1 blueprint は simple-‐‑‒mobile-‐‑‒backend を選択 136
- 137. ハンズオン#3-‐‑‒2 Botの修正1 ファンクション名を⼊入⼒力力 137 「SlackBot2」と⼊入⼒力力 ※データ投⼊入ファンクションは⽇日本語を含むコードとなっており、 このタイミングでペーストすると⽂文字化けしてしまうため ひとまずサンプルコードのまま作成する
- 140. ハンズオン#3-‐‑‒2 Botの修正1 リンク先のコードで上書き 140 https://github.com/s1hit/20160604_̲aws_̲handson#p140 よりコピペ
- 142. ハンズオン#3-‐‑‒2 Botの修正1 SlackBot2 のソースコード(2/4) 142 Botの処理理を呼び出し ※「@bot」以降降の⽂文字列列を渡す Botに対するメッセージで はないのでスキップ
- 143. ハンズオン#3-‐‑‒2 Botの修正1 SlackBot2 のソースコード(3/4) 143 コマンドによる振り分け ・/echo ・/city ※コマンドの後ろの⽂文字列列をメッセージとして渡す Botクラス
- 146. ハンズオン#3-‐‑‒2 Botの修正1 API Gateway を開く 146
- 154. ハンズオン#3-‐‑‒3 Botの修正2
- 155. ハンズオン#3-‐‑‒3 Botの修正2 概要 ▸ Botの修正 ▸ 「/weather 地域名」の場合、その地域の天気予報を返す 155 API Gateway Lambda(Bot)Slack メッセージ：@bot /weather 松江 メッセージ：[島根県 松江 の天気] 島根県は、 ⾼高気圧に覆われて晴れています。 DynamoDB(Cities) お天気Webサービス １ ８ ２ ７ ３ ６ ４ ５
- 156. ハンズオン#3-‐‑‒3 Botの修正2 LambdaファンクションのZipをダウンロード 156 ▸ https://raw.githubusercontent.com/s1hit/20160604_̲aws_̲handson/master/lambda.zip ※Lambdaで⽤用意されている標準module以外を使⽤用する場合は、 moduleごとZip化したものをデプロイする必要がある。 (今回はサードパーティー製のHTTPクライアントを使⽤用) ▸ Zip化の注意 ▸ フォルダごと圧縮しない ▸ 圧縮⽅方法→ $ zip -‐‑‒r lambda.zip index.js node_̲modules/
- 159. ハンズオン#3-‐‑‒3 Botの修正2 blueprint は スキップ 159
- 166. ハンズオン#3-‐‑‒3 Botの修正2 API Gateway を開く 166
- 174. お疲れ様でした お疲れ様でした ▸ 本ハンズオンで作成した以下のリソースについて、⽚片付けを お願いします。 ▸ AWS API Gateway ▸ AWS Lambda ▸ Amazon DynamoDB 174