
2018年12月にブログを移行した際にこの機能は削除しました。

## はじめに

解析の勉強のため、このブログの統計情報を集めようと思い立ちました。  

手始めに、記事のアクセス時刻や利用しているブラウザなどの情報を取得します。
本ブログは、Python + Flaskで構築しているため、**Flask request**を利用します。

この記事では、記事のページを見るユーザーの情報をFlask requestで集め、DynamoDBに保存するところまで設計します。

普段使っている、**Google Analytics**が高機能すぎますね。
調べると、[Core Reporting API](https://developers.google.com/analytics/devguides/reporting/core/v3/?hl=ja)で色々できるみたいです。
追々差別化できるようにしないと。。。

実装編はこちら

[リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-2.実装編](https://www.suzu6.net/posts/34)

## 概要

Flaskは、`request.environ`にアクセス元の情報がまとめられています。
そこから情報を取り出し、DynamoDBに保存します。

Flaskについては、以前の記事[[Python] Flask入門とサーバレスアーキテクチャ](https://www.suzu6.net/posts/6)をご覧下さい。

## 環境

```sh
$ python --version
Python 3.6.5
$ pip show Flask
Name: Flask
Version: 1.0.2
```

## request.environの中身

ちょうど良いドキュメントが見つからないので、直接見てしまいましょう！

```python
print(request.environ)
```

これで表示したものを、見やすくjsonに加工したものが以下になります。

```json
{
    "wsgi.version": (1,0),
    "wsgi.url_scheme": "http",
    "wsgi.input": <_io.BufferedReader name=5>,
    "wsgi.errors": <_io.TextIOWrapper name="<stderr>" mode="w" encoding="UTF-8">,
    "wsgi.multithread": True,
    "wsgi.multiprocess": False,
    "wsgi.run_once": False,
    "werkzeug.server.shutdown": <function WSGIRequestHandler.make_environ.<locals>.shutdown_server at 0x10f00c950>,
    "SERVER_SOFTWARE": "Werkzeug/0.14.1",
    "REQUEST_METHOD": "GET",
    "SCRIPT_NAME": "",
    "PATH_INFO": "/article/8",
    "QUERY_STRING": "",
    "REMOTE_ADDR": "127.0.0.1",
    "REMOTE_PORT": 62057,
    "SERVER_NAME": "127.0.0.1",
    "SERVER_PORT": "5000",
    "SERVER_PROTOCOL": "HTTP/1.1",
    "HTTP_HOST": "127.0.0.1: 5000",
    "HTTP_CONNECTION": "keep-alive",
    "HTTP_PRAGMA": "no-cache",
    "HTTP_CACHE_CONTROL": "no-cache",
    "HTTP_UPGRADE_INSECURE_REQUESTS": "1",
    "HTTP_USER_AGENT": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "HTTP_ACCEPT": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
    "HTTP_REFERER": "http://127.0.0.1:5000/contents/Google%20Adsence",
    "HTTP_ACCEPT_ENCODING": "gzip, deflate, br",
    "HTTP_ACCEPT_LANGUAGE": "ja-JP,ja;q=0.9,en-US;q=0.8,en;q=0.7",
    "HTTP_COOKIE": "gsScrollPos-1901=; gsScrollPos-2345=0; gsScrollPos-1735=0; _ga=GA1.1.1286324805.1530497168; session=eyJ1c2VybmFtZSI6ImFkbWluIn0.Dh3nXg.HvlJWyVbh3Zsa2-6fEi_lMVaDJo; _gid=GA1.1.316787490.1532584271; _gat_gtag_UA_106883433_1=1",
    "werkzeug.request": <Request "http://127.0.0.1:5000/article/8" [GET]>
}
```
※ local環境でChromeからテストした情報です。

httpのヘッダーの情報が入っていることがわかります。
Google Analyticsもきっと、ヘッダーの情報を収集しているんでしょうね。


貯めておくと面白そうな情報が色々ありました。

key|説明|value
---|-----|-----------
REMOTE_ADDR|IPアドレス|127.0.0.1
HTTP_USER_AGENT|ブラウザやOSの情報|Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36
HTTP_CONNECTION|継続したコネクションかどうか|keep-alive
PATH_INFO|URLのパス|/article/8


## 取得する項目とDynamoDBのテーブル設計

以下の項目を取得します。
DynamoDBのテーブル設計も兼ねます。


Table: page_view_logs

field name|primary key|説明
----------|-----------|----
article_id|hash key|記事のID
view_at|range key|閲覧時刻'%Y-%m-%d %H:%M:%s'日本時間
remote_addr|　|IPアドレス
browser|　|利用したブラウザ
user_os|　|osの種類
is_keep_alive|　|継続したコネクションか


記事毎に集計できるように、記事IDと閲覧時刻をプライマリーキーにしました。この２項目は、URLとdatetimeから得ます。

６項目を取得していきます。

---

実装編はこちら

[リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-2.実装編](https://www.suzu6.net/posts/34)

---
本ブログの構成について

- [AWSで始めるサーバレスなブログサービス](https://www.suzu6.net/posts/2)
- [CroudFrontとAPI Gatewayで自作ブログサイトを改善しました](https://www.suzu6.net/posts/7)
- [[Python] Flask入門とサーバレスアーキテクチャ](https://www.suzu6.net/posts/6)


リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-1.設計編


2018年12月にブログを移行した際にこの機能は削除しました。

## はじめに

解析の勉強のため、このブログの統計情報を集めようと思い立ちました。  

この記事は、設計編からの続きとなります。

[リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-1.設計編](https://www.suzu6.net/posts/33)

機能を実装していきましょう。

## ブログに実装する


記事にリクエストがきた場合は、記事IDとreuestsを`VieLogsManager`に渡します。
`insert()`が、記事の閲覧履歴を追加します。

```python
@article.route('/<article_id>', methods=['GET'])
def get_article(article_id='1'):
    """
    記事のテンプレートを返す
    """
    article = ArticleManager().get_article(article_id)
    sidebar = SidebarManager()
    # 閲覧記録を保存する。
    VieLogsManager().insert(article_id, request)
    return render_template('article.html', title=article.title, article=article, sidebar=sidebar)
```

**ViewLogModel.py**

```python
import os
import boto3
from boto3.dynamodb.conditions import Attr, Key

from datetime import datetime, timedelta, timezone


class VieLogsManager:
    """
    ページビュー記録の操作
    """
    def __init__(self):
        # Initialize connection with database
        session = boto3.session.Session(
            region_name=os.environ['MY_REGION'], 
            aws_access_key_id=os.environ['MY_ACCESS_KEY_ID'], 
            aws_secret_access_key=os.environ['MY_SECRET_ACCESS_KEY']
        )

        dynamodb = session.resource('dynamodb')

        # Connect to db table
        self.table_name = 'page_view_logs'
        self.table = dynamodb.Table(self.table_name)
        self.JST = timezone(timedelta(hours=+9), 'JST')
    
    def insert(self, article_id, request):
        """
        閲覧履歴を記録する。
        """
        # if request.environ['REMOTE_ADDR'] is '127.0.0.1':
        #     # localでのテストは集計しない
        #     return

        http_connection = 'close'
        try:
            http_connection = request.environ['HTTP_CONNECTION']
        except Exception, e:
            print(e)

        item = {
            'article_id': article_id,
            'view_at': datetime.now(self.JST).strftime('%Y-%m-%d %H:%M:%s'), 
            'remote_addr': request.environ['REMOTE_ADDR'],
            'is_keep_alive': self.is_keep_alive(http_connection),
            'browser': self.accessed_browser(request.environ['HTTP_USER_AGENT']),
            'user_os': self.user_os(request.environ['HTTP_USER_AGENT'])
        }
        
        # 追加する
        responce = self.table.put_item(
            TableName=self.table_name,
            Item=item
        )
        return responce
```

クラス内のメソッドは順次解説します。

**解説**

`__init__(self)`では、クラスの呼び出し時にDynamoDBとの接続をします。
キー情報は、環境変数に入れてあります。

`put_item()`では、保存する項目をdictで渡せます。DynamoDbではプライマリーキーを必ず渡しましょう。


### コネクションの有無

```python
    @staticmethod
    def is_keep_alive(http_connection):
        return http_connection == 'keep-alive'
```

```
20180728追記：
request.environ['HTTP_CONNECTION']がローカルでは取得できましたが、Lamabda上ではKeyErrorとなっていしまいます。
現在、コネクションの有無は判定できません。
```

### ユーザーのブラウザを判定

`HTTP_USER_AGENT`から、ユーザーのブラウザを判定する関数です。
下記を参考にしました。

[UserAgentからOS/ブラウザなどの調べかたのまとめ](https://qiita.com/nightyknite/items/b2590a69f2e0135756dc)

keywordsに判定するkeyとブラウザをおきます。
異なるブラウザも同じキーワードが入っているため、判定する順序に気をつけてください。

※[python3.6からdictの順序が保たれます](http://www.freia.jp/taka/blog/python3-hash-randomie/index.html)。


```python
    @staticmethod
    def accessed_browser(http_user_agent):
        """
        return accessed browser
        """
        http_user_agent = http_user_agent.lower()
        keywords = {
            'trident': 'IE11',
            'edge': 'Edge',
            'chrome': 'Chrome', 
            'opr': 'Opera', 
            'firefox': 'Firefox',
            'safari': 'safari'
        }
        for key, val in keywords.items():
            if http_user_agent.find(key) > -1:
                return val
        return 'othres'
```

対象は、IE11, Edge, Chrome, Opera, Firefox, safariとその他otherとします。

### ユーザーのOSを判定

OSも同じく、`HTTP_USER_AGENT`から判定します。
[参考](https://qiita.com/nightyknite/items/b2590a69f2e0135756dc)も同じ。

```python
    @staticmethod
    def user_os(http_user_agent):
        """
        return user os
        """
        http_user_agent = http_user_agent.lower()

        keywords = {
            'nt 10.0': 'Windows 10',
            'mac': 'Mac', 
            'android': 'Android',
            'iphone': 'iPhone',
            'nt 6.1': 'Windows 7',
            'nt 5': 'Windows XP', 
            'linux': 'Linux'
        }
        for key, val in keywords.items():
            if http_user_agent.find(key) > -1:
                return val
        return 'othres'
```

OSでは、パソコンの他にスマホやタブレットも判定できるようです。
この関数では、Windows XP, 7, 10, Mac, Linux, iPhone, Androidを判定します。

## 結果

local環境で動かした結果です。

![table_page_view_logs](https://www.suzu6.net/images/posts/33/table_page_view_logs.png)

ChromeとFireFox、それからMacを認識できていますね。
その他の、ブラウザとOSは手元にないため、運用しつつテストしていこうと思います。


## IPアドレスの取り扱いについて

IPアドレスによって個人情報までばれてしまうと、心配になる方がいらっしゃるかと思います。
当サイトでは、IPアドレスを使って個人を特定することはありません。
あくまでも、統計解析の材料として扱います。

個人のIPアドレスで分かるのは、最寄りのルーター位置のみで、最大でも市区町村単位までです。
また、IPアドレスはリクエスト先や途中でも、常に公開されるものです。

> **IPアドレスから得られる情報**  
> IPアドレスの経路を確認した場合に、ルータのホスト名から位置を推定できる場合もあります。しかし、その場合であっても、追跡できるのは最寄りのルータまでとなり、そこから先の詳細な住所などはわかりません。
> 弊社では専任の調査員による位置情報調査を行っていますが、ルータ単位での位置判定は、最大で市区町村単位となっています。  
> 引用元：[IPアドレスから個人情報はどこまでわかる？](http://www.geolocation.co.jp/learn/dns/26.html)

ご自身のIPアドレスの情報は[IPアドレスから住所を検索](http://keiromichi.com/index.php)から確認できます。
私が試した結果は、位置情報は隣の市が表示されました。

それでも心配な方は、セキュリティソフトやファイヤーウォールの設定をしっかりと見直してください。

## おわりに

機能の構築と本記事の作成の中で、ウェブの解析ソフトが見ている情報や情報の扱いまで学ぶことが出来ました。
ネットワークの技術も、これを機に調べていこうと思います。

収集したデータを使った解析は、また次回行います。

最後までご覧いただき、ありがとうございます。

---

設計編はこちら
[リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-1.設計編](https://www.suzu6.net/posts/33)

---
本ブログの構成について

- [AWSで始めるサーバレスなブログサービス](https://www.suzu6.net/posts/2)
- [CroudFrontとAPI Gatewayで自作ブログサイトを改善しました](https://www.suzu6.net/posts/7)
- [[Python] Flask入門とサーバレスアーキテクチャ](https://www.suzu6.net/posts/6)

リクエスト情報から訪問者の情報を集めてみる[Python Flask + DynamoDB]-2.実装編


## この記事について

こんにちは、suzu6です。

Python + AWS Lambdaを使ってサーバレスなウェブアプリケーション作る場合、マイクロフレームワークの`Flask` の利用をおすすめします。

このブログサイトもAWS LambdaにFlaskを載せて製作しています。

この記事では、Flaskの使い方をご紹介します。

## Flaskとは

マイクロWEBフレームワークと呼ばれており、コアな機能のシンプルなフレームワークであるため軽量です。小規模から中規模のWEBアプリの構築に向いています。URLのマッピングや`Jinja2`を使ったテンプレートエンジンなど必要なものは、十分揃っていると思います。

[Flask 公式](http://flask.pocoo.org/)

翻訳はこちら
[Flaskへ ようこそ](https://a2c.bitbucket.io/flask/)

同じPythonで利用できる[Django](https://docs.djangoproject.com/ja/2.0/)と比べられることが多く、こちらはフルスタックフレームワークであり多くの機能が備わっています。例えば、データの構造を抽象化した「モデル(Model)」の提供してDBのテーブルの操作・定義を簡単にしたり、管理画面を自動で作成してくれます。

FlaskはDBの管理や管理画面の作成は自分で実装する必要があります。その分自由度も高く、ブラックボックスも少ないです。そのため、WEBアプリケーションの入門としてFlaskを使い、開発効率を求めてDjangoに移るのも良いんじゃないでしょうか？

また、軽量さがサーバレスアーキテクチャと相性が良く、アプリのAPIをFlaskで作ると良い感じです。

## FlaskでHello World

Flaskの簡潔さを示すため、`Hello World`を返すWEBアプリのコードを載せます。

```python
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"
```
とっても短いですね。

```python
@app.route("/")
```
Flaskクラスのインスタンス（app）のrouteデコレータを使い、 / というURLに対しての処理を追加しています。

Flaskのインストールして実行します。**hello.py**のファイルに上記のコードを書いておきます。
```sh
$ pip install Flask
$ FLASK_APP=hello.py flask run
 * Serving Flask app "hello.py"
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
 ```
 ![hello_world](https://s3-ap-northeast-1.amazonaws.com/webyasan-bucket/images/articles/6/hello_world.png)


簡単に実行できました。

`FLASK_APP=hello.py flask run`ではなく、短く`python hello.py`で実行したい場合はメイン関数に`app.run()`を書き足しておいてください。

 ```python
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"

# 実行関数を追加
if __name__ == "__main__":
    app.run()
```
```
$ python hello.py
```

## AWS Lambdaで公開してみる

AWS lambdaでFlaskを実行してみましょう。

[Zappaを使ってPythonのコードをAWS Lambdaにデプロイする](https://www.suzu6.net/posts/4)

こちらでは、[Zappa](https://github.com/Miserlou/Zappa)というPythonのWSGIアプリケーションをコマンドラインでデプロイできる便利なツールを利用して、AWS Lambdaに展開しています。長めの記事ですが利用方法を詳しく書いたので、良ければご参照下さい。

(仮想環境を作ってAWSの設定を行なった後)
```sh
$ pip install zappa
$ zappa init 
$ zappa deploy
```
ざっくりとですが、以上のコマンドでAWS上で公開されます。

Lambdaだと`Apache`や`Nginx`などのwebサーバを使わずに公開できてしまうところがポイントです。Lambda＋Flaskの組み合わせにする以前は、Linuxも相まって設定がものすごく大変でした。その分をAWSのコンソール上で設定できるので、vimやコマンドが苦手な私には大変助かります。（AWSの設定を覚える大変さはありますが。。。）

また、Lambda特有のスケーラブルなところも活用できて、Flaskとの組み合わせは協力だと思います。

## Flask サンプル集

Flaskを使ったサンプルを集めました。

- [Flaskチュートリアル](http://study-flask.readthedocs.io/ja/latest/02.html)

こちらでは、Flask公式チュートリアルのFlaskrというブログアプリを作っています。

- [flaskで簡単なwebアプリ作成](https://qiita.com/yshi12/items/9502c6232e96d7dfa29d)

- [Python のマイクロフレームワーク『Flask』を試してみた](https://tnakamura.hatenablog.com/entry/20101214/flask)

- [flask入門](http://www.python.ambitious-engineer.com/archives/1630)
 
こちらでは、簡単な分析ツールを製作されています。データベースとの接続、pandasとmatplotlibを使った解析と結果の表示を行なっています。

## まとめ

- マイクロWEBフレームワークのFlask
- とても簡潔な記述と自由度の高さが売り
- AWS Lambdaで動くのでサーバレスアーキテクチャとして活躍する

また、Flaskの詳しい使い方については記事にしてまとめたいと思います。
最後までご覧いただき、ありがとうございました。

---

サーバレスアーキテクチャを勉強される方は、こちらの本がおすすめです。

<div class="cstmreba"><div class="booklink-box"><div class="booklink-image"><a href="//af.moshimo.com/af/c/click?a_id=1286797&p_id=56&pc_id=56&pl_id=637&s_v=b5Rz2P0601xu&url=http%3A%2F%2Fbooks.rakuten.co.jp%2Frb%2F15330093%2F" target="_blank" rel="nofollow" ><img src="https://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/5166/9784798155166.jpg?_ex=200x200" style="border: none;" /></a><img src="//i.moshimo.com/af/i/impression?a_id=1286797&p_id=56&pc_id=56&pl_id=637" width="1" height="1" style="border:none;"></div><div class="booklink-info"><div class="booklink-name"><a href="//af.moshimo.com/af/c/click?a_id=1286797&p_id=56&pc_id=56&pl_id=637&s_v=b5Rz2P0601xu&url=http%3A%2F%2Fbooks.rakuten.co.jp%2Frb%2F15330093%2F" target="_blank" rel="nofollow" >AWSによるサーバーレスアーキテクチャ</a><img src="//i.moshimo.com/af/i/impression?a_id=1286797&p_id=56&pc_id=56&pl_id=637" width="1" height="1" style="border:none;"><div class="booklink-powered-date">posted with <a href="https://yomereba.com" rel="nofollow" target="_blank">ヨメレバ</a></div></div><div class="booklink-detail">Peter Sbarski/長尾 高弘 翔泳社 2018年03月14日    </div><div class="booklink-link2"><div class="shoplinkrakuten"><a href="//af.moshimo.com/af/c/click?a_id=1286797&p_id=56&pc_id=56&pl_id=637&s_v=b5Rz2P0601xu&url=http%3A%2F%2Fbooks.rakuten.co.jp%2Frb%2F15330093%2F" target="_blank" rel="nofollow" >楽天ブックス</a><img src="//i.moshimo.com/af/i/impression?a_id=1286797&p_id=56&pc_id=56&pl_id=637" width="1" height="1" style="border:none;"></div><div class="shoplinkamazon"><a href="https://www.amazon.co.jp/exec/obidos/asin/4798155160/suzu60c-22/" target="_blank" rel="nofollow" >Amazon</a></div><div class="shoplinkkindle"><a href="https://www.amazon.co.jp/gp/search?keywords=&__mk_ja_JP=%83J%83%5E%83J%83i&url=node%3D2275256051&tag=suzu60c-22" target="_blank" rel="nofollow" >Kindle</a></div>                              	  	  	  	  	</div></div><div class="booklink-footer"></div></div></div>

動画シェアサイトをAWS Lambda, S3を使って実際に構築する手順が載っています。
その中で、どのようにLambdaを構成したら良いか大変参考になりました。また、DynamoDBとAuth0も詳しく書かれています。

Python + Flask入門とサーバレスアーキテクチャ


## この記事の目的

Python + FlaskのアプリをZappaを使ってAWS Lambdaにデプロイして、動作確認まで行います。
macでの環境の構築をメインに、丁寧に書いていきます。

## Zappaとは

GitHub:[Zappa](https://github.com/Miserlou/Zappa)

**Zappa**はコマンドラインでPythonのWSGIアプリケーションをデプロイできます。
AWSではLambdaに、また、他ののクラウドにも対応しています。

Lambdaでは直接コードを書く場合と、コードとライブラリをまとめたZIPファイルをアップロードしてデプロイします。
Zappaでは`virtualenv`の仮想環境をZIPファイルにまとめて、デプロイします。ZIPの作成も自動的に行なってくれるのでとても簡単です。

自分でZIPファイルにまとめてデプロイも可能です。
zipコマンドについては[こちら](https://www.suzu6.net/posts/63-zip-command)。

![デプロイの様子.gif](https://camo.githubusercontent.com/be05103c626a5afe18dc4b1208a4b465dbd9e731/687474703a2f2f692e696d6775722e636f6d2f6631504a7843512e676966)
デプロイの様子 : [Zappa](https://github.com/Miserlou/Zappa)より

必要な環境さえ整えれば、GIFの通り簡単にAWSにコードをデプロイすることができます。

日本語の記事では、[zappa で hello world するまで](https://qiita.com/satoshi_iwashita/items/505492193317819772c7)が参考になります。CentOS７で確認されていますので、Redhat系の方はこちらの手順で進めて見てください。公式からもリンクされており、公認みたいです。

公式を翻訳しているサイト[Zappa – サーバーレスPython](https://githubja.com/miserlou/zappa)もあります。応援しています‼️

## 環境

- macOS High Sierra
- Python3.6.5
- pyenv 1.2.3

## 流れ

1. pyenvとpyvirtualenvのインストール
2. Python3.6の準備
3. AWSのIAMの設定
4. デプロイする仮想環境の構築
5. アプリケーションの用意
6. Zappaのインストールとデプロイ

## 手順

### 1. pyenvとpyvirtualenvのインストール

まずは、仮想環境を用意しましょう。

macではパッケージマネージャーの`Home Brew`を使ってツールをインストールします。`Home Brew`がまだない方は、[こちら](https://brew.sh/index_ja)のスクリプトをコピーして、実行してください。


`Home Brew`をインストールできたら下記の手順でpyenvとpyvirtualenvのインストールを進めます。

```sh
$ brew install pyenv
$ brew update && brew upgrade pyenv
pyenv 1.2.1 -> 1.2.3

$ brew install pyenv-virtualenv
$ echo 'eval "$(pyenv init -)"' >> ~/.bash_profile
$ exec $SHELL -l
```

`echo ...`でpyenvをログイン時に起動するよう書き込み、`exec ...`で即時起動しています。（たぶん。。。）

### 2. Python3.6の準備

続いて、macの環境をPython3.6にしておきましょう。
macにはデフォルトで2.7が入っています。変えたくない方や、他のバージョンを使っている方は飛ばしてください。

```sh
$ pyenv install 3.6.5
# 全体に反映
$ pyenv global 3.6.5
$ python --version
Python 3.6.5
```

python3.6が確認できたら、pipもアップグレードしておきます。`aws cli`をインストールするのに使います。

```sh
$ pip -V
pip 9.0.3 from /Users/{user}/.pyenv/versions/3.6.5/lib/python3.6/site-packages (python 3.6)
$ pip install -U pip
Successfully installed pip-10.0.1
```
### 3. AWSのIAMの設定

AWSにデプロイするためには、アクセスできるユーザとサービスの操作を許可するIAMの設定が必要です。

コンソールからデプロイ用のユーザを作成し、アクセスキーとシークレットキーを保管してください。
IAMの設定でユーザに操作の許可を与えてください。Lambda、S3、API GatewayのFullaccessは必要。その他、利用するサービスの権限を与えて下さい。

[Minimum AWS policies for example.](https://github.com/Miserlou/Zappa/issues/244)
こちらにpermission policieの例が載っています。


ターミナルに戻って、キーの設定を行います。
```sh
$ pip install awscli
$ aws configure
AWS Access Key ID [********************]:
AWS Secret Access Key [********************]:
Default region name [ap-northeast-1]:
Default output format [json]:
```
`aws configure`でアクセスキーなどを聞かれるので、打ち込んであげてください。　regionは東京にしました。

### 4. デプロイする仮想環境の構築

Lambdaには仮想環境ごとライブラリをまとめてデプロイします。
フォルダごとに仮想環境を用意しておくと何かと便利なので、ローカル環境を作成します。

```
$ pyenv virtualenv 3.6.5 bar
$ mkdir foo
$ cd foo
$ pyenv local bar
```
(bar) $ となっていれば成功。

`foo`というフォルダを用意して、そこにローカル環境`bar`を作成しています。
fooとローカル環境には適当な名前をつけて下さい。

> **※注意** 仮想環境の名前はZappaのプロジェクト名と同じものを使用しないで下さい。エラーが起こり得ます。

ここまでは、macで別のバージョンのpythonを使うとき便利です。

ローカル環境もpipを最新にしておきます。
```sh
$ pip install -U pip
Successfully installed pip-10.0.1
```

### 5. アプリケーションの用意

Flaskを使って`hello from Flask!`を返す簡単なアプリを作成します。

仮想環境を用意したディレクトリfooに、`app.py`を作成します。

foo/**app.py**
```python
from flask import Flask

app = Flask(__name__)

@app.route('/', methods=['GET', 'POST'])
def lambda_handler(event=None, context=None):

    return 'hello from Flask!'

if __name__ == '__main__':
    app.run()
```

fooに移動して、ライブラリをインストールして確かめて見ましょう。
```sh
$ cd foo
$ pip install flask
Successfully installed Flask-1.0.2 Jinja2-2.10 MarkupSafe-1.0 Werkzeug-0.14.1 click-6.7 itsdangerous-0.24
$ pip freeze
click==6.7
Flask==1.0.2
itsdangerous==0.24
Jinja2==2.10
MarkupSafe==1.0
Werkzeug==0.14.1

$ python app.py
 * Serving Flask app "app" (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
```

http://127.0.0.1:5000/をブラウザで開いて確認して見てください。
![hello_flask_local](https://s3-ap-northeast-1.amazonaws.com/webyasan-bucket/images/articles/4/hello_flask_local.png)

### 6. Zappaのインストールとデプロイ

とうとう、デプロイするところまできました。
まずは、Zappaをインストールして設定を行います。

```sh
$ pip install zappa
$ zappa init

███████╗ █████╗ ██████╗ ██████╗  █████╗
╚══███╔╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗
  ███╔╝ ███████║██████╔╝██████╔╝███████║
 ███╔╝  ██╔══██║██╔═══╝ ██╔═══╝ ██╔══██║
███████╗██║  ██║██║     ██║     ██║  ██║
╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝     ╚═╝  ╚═╝

Welcome to Zappa!
```
設定は全て`Enter`を押してデフォルトにすると以下の`zappa_settings.json`が作成されます。
フォルダ名がプロジェクト名になっています。
```
Okay, here's your zappa_settings.json:

{
    "dev": {
        "app_function": "app.app",
        "aws_region": "ap-northeast-1",
        "profile_name": "default",
        "project_name": "foo",
        "runtime": "python3.6",
        "s3_bucket": "zappa-9jex9436c"
    }
}
Does this look okay? (default 'y') [y/n]: y

$ ls
app.py                  zappa_settings.json
```

> **※注意(再掲)** 仮想環境の名前はZappaのプロジェクト名と同じものを使用しないで下さい。エラーが起こり得ます。

> 注意点として、実行ファイルの名前を合わせる必要があります。
**zappa_setting.json**の"app_function"を"{実行するファイル名}.app"として下さい。**hello.py**を実行する場合は次のようにします。`"app_function": "hello.app",`

デプロイします。
```sh
$ zappa deploy
Deployment complete!: https://81dc4kiste.execute-api.ap-northeast-1.amazonaws.com/dev
```
成功すると、API GatewayのURLが表示されます。
![hello_flask_lambda](https://s3-ap-northeast-1.amazonaws.com/webyasan-bucket/images/articles/4/hello_flask_lambda.png)

AWSのコンソールからLambdaを確認すると`foo-dev`という関数が作られていました。
![lambda](https://s3-ap-northeast-1.amazonaws.com/webyasan-bucket/images/articles/4/lambda.png)

> ※私の環境ではpermission policieにDynamoDBなども含めているので、Lambdaからアクセスできるようになっています。

アップデートもしてみましょう。
せっかくなので、URLで応答を変えるようにします。
`hello_name()`の関数を追加しました。

foo/**app.py**
```python
from flask import Flask

app = Flask(__name__)

@app.route('/', methods=['GET', 'POST'])
def lambda_handler(event=None, context=None):
    
    return 'hello from Flask!'

@app.route('/<name>', methods=['GET', 'POST'])
def hello_name(name):
    
    return 'hello ' + name

if __name__ == '__main__':
    app.run()
```

アップデートします。
```sh
$ zappa update
```
URLの末尾に文字を入れてください。

![update](https://s3-ap-northeast-1.amazonaws.com/webyasan-bucket/images/articles/4/update.png)

その他、ログを監視する`tail`や前のバージョンにロールバックする`rollback`など便利なコマンドがあります。
`zappa -h`で確認してください。


zappaの導入手順は以上となります。

## 同様のライブラリ

[Chalice](https://github.com/aws/chalice)

こちらはAWSのためのAmazon製のサーバレスマイクロフレームワーク。LambdaとAPI Gatewayのデプロイができるようです。

Zappaとの比較はこちらの記事が参考になりました。
[Python サーバーレスフレームワークの比較 - Zappa vs Chalice](https://qiita.com/massa142/items/c59275237979fd939791)

## 終わりに

Pythonでサーバレスな開発を行うなら、zappaがとても便利だと思います。
ただ、日本語の情報が少ないので、躓いたとき辛いです。。。
少しでも参考になれば、幸いです。

---

サーバレスアーキテクチャを勉強される方は、こちらの本がおすすめです。
<div class="amakuri-default-comment" style="text-align: left; line-height: 1.5em; margin-bottom: 10px; overflow:hidden; _zoom:1;"><div class="amakuri-default-comment-image" style="float: left; margin: 0 20px 0 0;"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4798155160/suzu60c-22" target="_blank"><img src="https://images-fe.ssl-images-amazon.com/images/I/51L3N%2B3pL1L._SL160_.jpg" width="128" height="160" alt="AWSによるサーバーレスアーキテクチャ" style="border: none"></a></div><div class="amakuri-default-comment-desc" style="overflow: hidden; _zoom:1;"><div class="amakuri-default-comment-title" style="margin-bottom: 0.5em;"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4798155160/suzu60c-22" target="_blank">AWSによるサーバーレスアーキテクチャ</a></div><div class="amakuri-default-comment-posted" style="margin-bottom: 0.5em; font-size: small;">Posted at 2018.12.21</div><div class="amakuri-default-comment-author">Peter Sbarski</div><div class="amakuri-default-comment-label" style="margin-bottom: 0.5em;">翔泳社</div><div class="amakuri-default-comment-link" style="margin-top: 1em;"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4798155160/suzu60c-22" target="_blank">Amazonで詳細を見る</a></div></div></div>

動画シェアサイトをAWS Lambda, S3を使って実際に構築する手順が載っています。
その中で、どのようにLambdaを構成したら良いか大変参考になりました。また、DynamoDBとAuth0も詳しく書かれています。