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

設定ファイル(.ebextensions)による高度な環境のカスタマイズ

ウェブアプリケーションのソースコードに AWS Elastic Beanstalk 設定ファイル(.ebextensions)を追加することで、環境を設定し、環境に含まれる AWS リソースをカスタマイズできます。設定ファイルは、ファイル拡張子 .config を持つ YAML 形式のドキュメントで、[.ebextensions] という名前のフォルダーに配置してアプリケーションソースバンドルにデプロイします。

設定ファイルの option_settings セクションは、設定オプションの値を定義します。設定オプションにより、Elastic Beanstalk 環境、同環境内の AWS リソース、アプリケーションを実行するソフトウェアを設定することができます。設定ファイルは、設定オプションを設定するいくつかの方法の 1 つに過ぎません。

resources セクションでは、アプリケーションの環境内のリソースをさらにカスタマイズし、設定オプションが提供する機能では不可能な追加の AWS リソースの定義を実行できます。resources を使用して、Elastic Beanstalk が環境の作成に使用する AWS CloudFormation がサポートするあらゆるリソースを追加および設定できます。

設定ファイルのその他のセクション(packagessourcesfilesusersgroupscommandscontainer_commandsservices)では、環境内で起動される EC2 インスタンスを設定できます。サーバーが環境内で起動される場合、Elastic Beanstalk は常にこれらのセクションで定義されたオペレーションを実行し、アプリケーションのためのオペレーティングシステムとストレージシステムを準備します。

1 つの設定ファイルに、複数のセクションを含めることができます。設定を複数のファイルに分割することもできます。設定ファイルはアルファベット順に処理されるため、設定アクティビティは複数のステージに分割できます。

設定ファイルを使用するには、ソースのルートで .ebextensions というフォルダーに設定ファイルを追加し、それを環境でデプロイします。

~/workspace/my-app/
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- .elasticbeanstalk
|   `-- config.yml
|-- index.php
`-- styles.css

プロセスは、環境を管理するために使用しているクライアントによって少し異なります。詳細については、次のセクションを参照してください。

新しい設定ファイルを開発またはテストする場合、デフォルトアプリケーションを実行するクリーンな環境を起動し、そこでデプロイします。設定ファイルが正しくフォーマットされていない場合、新しい環境の起動は失敗し、回復不可能になります。