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

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

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

ヒント

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

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

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

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

要件

  • Location – すべての設定ファイル (.ebextensions) を 1 つのフォルダ (ソースバンドルのルート) に配置します。ドットで開始するフォルダは、ファイルブラウザで非表示になっている場合があるため、ソースバンドル作成時にフォルダが追加されていることを確認します。手順については、「アプリケーションソースバンドルを作成する」を参照してください。

  • Naming – 設定ファイルには、ファイル拡張子 (.config) を加える必要があります。

  • Formatting – 設定ファイルは、YAML フォーマット要件に準拠する必要があります。インデントには必ずスペースを使用し、同じファイル内で同じキーを 2 回使用しないでください。

    警告

    同じ設定ファイルでキー (例: option_settings) を 2 回使用すると、いずれかのセクションは削除されます。重複セクションを 1 つのセクションにまとめるか、別々の設定ファイルに配置します。

    YAML の詳細については、「YAML Ain't Markup Language (YAML™) Version 1.1」を参照してください。

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