.. meta::
   :keywords: web2py, framework, deploy, AMAZON Web Services, Elastic Beanstalk


web2py アプリケーションと AWS RDS の接続
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

:ref:`aws_beanstalk_app_setup`  にて、Beanstalk に web2py アプリケーションのデプロイを行いました。
しかし、このアプリケーションは EC2 インスタンスの **SQLite** データベースを利用しているに過ぎません。

ここでは、 **AWS RDS** への接続を試してみます。


RDS 接続に必要な情報の確認
""""""""""""""""""""""""""

	:ref:`aws_beanstalk_init_setup_eb_init` にて、RDS DB インスタンスの生成を行う設定にしました。
	このため、Beanstalk サービスがスタートした時点で、DBインスタンスが立ち上がっているはずです。
	`AWS マネジメントコンソール <https://console.aws.amazon.com/console/home>`_ で、
	DBインスタンスの情報を見てみましょう。

	RDS サービス画面

		RDS サービス画面を開き、「DB Instances」をクリックし、アプリケーションに接続するDBインスタンス
		を選択します。「Description」タブの  **DB Endpoint**  と  **Master Username**
		**DB Name**  を確認します。

			.. figure:: ../../images/web2py_deploy/web2py_deploy_008r.PNG
				:width: 70%
				:scale: 100%
				:class: img-border



RDS への接続記述を web2py アプリケーションに追加
""""""""""""""""""""""""""""""""""""""""""""""""

	web2py アプリケーションのモデル記述（db.py）を次のように修正してください。

	修正前 ::

		if not request.env.web2py_runtime_gae:
		    ## if NOT running on Google App Engine use SQLite or other DB
		    db = DAL('sqlite://storage.sqlite')
		else:
		    ## connect to Google BigTable (optional 'google:datastore://namespace')
		    db = DAL('google:datastore')
		    ## store sessions and tickets there
		    session.connect(request, response, db=db)
		    ## or store session in Memcache, Redis, etc.
		    ## from gluon.contrib.memdb import MEMDB
		    ## from google.appengine.api.memcache import Client
		    ## session.connect(request, response, db = MEMDB(Client()))

	SQLite の記述をコメントにし、DBインスタンスが MySQL の場合は次のように記述します。 ::

		if not request.env.web2py_runtime_gae:
		    ## if NOT running on Google App Engine use SQLite or other DB
		    #db = DAL('sqlite://storage.sqlite')
		    db = DAL('mysql://ebroot:********@xxxxxxxxxxxxxxx.xxxxxxxxx.us-east-1.rds.amazonaws.com/ebdb')

		else:
		    ## connect to Google BigTable (optional 'google:datastore://namespace')
		    db = DAL('google:datastore')
		    ## store sessions and tickets there
		    session.connect(request, response, db=db)
		    ## or store session in Memcache, Redis, etc.
		    ## from gluon.contrib.memdb import MEMDB
		    ## from google.appengine.api.memcache import Client
		    ## session.connect(request, response, db = MEMDB(Client()))

	つまり DALコンストラクタの接続文字列は、MySQL の場合、次の形式で指定します。 ::

		mysql://[Master Username]:[パスワード]@[DB Endpoint]/[DB Name]


web2py アプリケーションをデプロイ
"""""""""""""""""""""""""""""""""

	後は、Gitコマンドでリポジトリに反映し、

		.. include:: git_commit_command.html

	AWSサーバにプッシュします。

		.. include:: git_aws_push_command.html

	デプロイ完了後、動作を確認してください。


注意点など
""""""""""

	* Beanstalk サービスで生成された DBインスタンスは、必要な DB Security Groups の設定が完了しています。
	  もし既存のDBインスタンスに接続する場合は、別途 DB Security Groups の設定を行なってください。

	* マイグレーションの失敗で、アプリケーションが動作しない場合があります。
	  このような時には、 ``migrate=False`` を指定して実行するようにしてください。
	  また問題発生時は ``fake_migrate=True`` を指定し、問題解消後 ``fake_migrate=False`` にしてください。