メニュー
AWS Elastic Beanstalk
開発者ガイド (API Version 2010-12-01)

Ruby アプリケーション環境に Amazon RDS DB インスタンスを追加

Amazon Relational Database Service (Amazon RDS) DB インスタンスを使用して、アプリケーションによって収集されて変更されたデータを保存できます。データベースは、Elastic Beanstalk でお客様の環境にアタッチして管理したり、外部で作成して管理したりできます。

初めて Amazon RDS を使用する場合は、Elastic Beanstalk マネジメントコンソールを使用してテスト環境に DB インスタンスを追加し、そのインスタンスにアプリケーションが接続できることを確認します。

データベースに接続するには、アプリケーションにアダプタを追加し、Elastic Beanstalk によって提供される環境プロパティで接続を設定します。設定と接続コードは、使用するデータベースエンジンとフレームワークによって異なります。

本番稼働環境では、Elastic Beanstalk 環境外部に DB インスタンスを作成し、データベースリソースから環境リソースを分離します。外部 DB インスタンスを使用すると、複数の環境から同じデータベースに接続し、Blue/Green デプロイを実行することができます。手順については、「Amazon RDS で Elastic Beanstalk を使用する」を参照してください。

環境に DB インスタンスを追加

お客様の環境に DB インスタンスを追加するには

  1. Elastic Beanstalk コンソールを開きます。

  2. お客様の環境の管理ページに移動します。

  3. [Configuration] を選択します。

  4. [Data Tier] で、[Create a new RDS database] を選択します。

  5. DB エンジンを選択し、ユーザー名とパスワードを入力したら、[Apply] を選択します。

DB インスタンスの追加には約 10 分かかります。環境の更新が完了すると、DB インスタンスのホスト名とその他の接続情報は以下の環境プロパティを通じてアプリケーションに使用できるようになります。

  • RDS_HOSTNAME – DB インスタンスのホスト名。

    Amazon RDS コンソールラベル – [エンドポイント] は、ホスト名とポートを組み合わせたものです。

  • RDS_PORT – DB インスタンスが接続を許可するポート。デフォルト値は DB エンジンによって異なります。

    Amazon RDS コンソールラベル – [ポート]

  • RDS_DB_NAME – データベース名、ebdb

    Amazon RDS コンソールラベル – [DB 名前]

  • RDS_USERNAME – お客様のデータベース用に設定したユーザー名。

    Amazon RDS コンソールラベル – [ユーザー名]

  • RDS_PASSWORD – お客様のデータベース用に設定したパスワード。

内部 DB インスタンスの設定の詳細については、「Elastic Beanstalk でデータベースを設定する」を参照してください。

アダプタのダウンロード

プロジェクト gemファイルにデータベースのアダプタを追加します。

例 Gemfile – MySQL を使用の Rails

source 'https://rubygems.org'
gem 'puma'
gem 'rails', '4.1.8'
gem 'mysql2'

Ruby に共通のアダプタの Gem

  • MySQLmysql2

  • PostgreSQLpg

  • Oracleactiverecord-oracle_enhanced-adapter

  • SQL Server sql_server

データベースへの接続

Elastic Beanstalk は、環境プロパティでアタッチされた DB インスタンスの接続情報を提供します。ENV['VARIABLE'] を使用してプロパティを読み取り、データベース接続を設定します。

例 config/database.yml – Ruby on Rails データベース設定 (MySQL)

production:
  adapter: mysql2
  encoding: utf8
  database: <%= ENV['RDS_DB_NAME'] %>
  username: <%= ENV['RDS_USERNAME'] %>
  password: <%= ENV['RDS_PASSWORD'] %>
  host: <%= ENV['RDS_HOSTNAME'] %>
  port: <%= ENV['RDS_PORT'] %>