Elastic Beanstalk で使用する開発マシンの設定

このページでは、AWS Elastic Beanstalk アプリケーションの開発用にローカルマシンを設定する方法を示します。これには、フォルダ構造、ソース管理、および CLI ツールが含まれます。

プロジェクトフォルダの作成

プロジェクトのフォルダを作成します。フォルダは、読み取り権限と書き込み権限を持っている限り、ローカルディスクの任意の場所に保存できます。ユーザーフォルダの作成は可能です。複数のアプリケーションを使用する場合は、[workspace] や [projects] などの名前の他のフォルダ内にプロジェクトフォルダを作成し、すべてが整理された状態を維持します。

workspace/
|-- my-first-app
`-- my-second-app

プロジェクトフォルダの内容は、アプリケーションが使用するウェブコンテナやフレームワークによって異なります。

注記

フォルダ名またはパス要素に一重引用符 (') または二重引用符 (") を含むフォルダとパスは避けてください。一部の Elastic Beanstalk コマンドは、名前にいずれかの文字が含まれているフォルダ内で実行されると、失敗します。

ソースコントロールをセットアップする

プロジェクトフォルダ内のファイルやコードが誤って削除しないように、さらにプロジェクトを破壊する変更を前の状態に戻す手段が確保されるようにソースコントロールを設定します。

ソースコントロールシステムがない場合は、無料で使いやすいオプション、Git の使用を検討します。Git は Elastic Beanstalk コマンドラインインターフェイス (CLI) と緊密に統合します。Git ホームページにアクセスし、Git をインストールします。

Git ウェブサイトの指示に従い、Git をインストールして設定した後、プロジェクトフォルダで git init を実行し、ローカルレポジトリを設定します。

~/workspace/my-first-app$ git init
Initialized empty Git repository in /home/local/username/workspace/my-first-app/.git/

プロジェクトフォルダにコンテンツを追加してコンテンツを更新する際は、変更内容を Git レポジトリにコミットします。

~/workspace/my-first-app$ git add default.jsp
~/workspace/my-first-app$ git commit -m "add default JSP"

コミットの度に、何らかの問題が生じた場合に後から復元できるよう、プロジェクトのスナップショットを作成します。Git のコマンドとワークフローの詳細については、Git のドキュメントを参照してください。

リモートリポジトリを設定する

ハードドライブがクラッシュした場合、または別のコンピュータでプロジェクトを使用する必要がある場合 ソースコードをオンラインでバックアップし、別のコンピュータからアクセスするには、コミットをプッシュできるリモートリポジトリを設定します。

AWS CodeCommit を使用して、AWS クラウドにプライベートリポジトリを作成できます。CodeCommit では、アカウント内の最大 5 人の AWS Identity and Access Management (IAM) ユーザーがAWS無料利用枠で無料になります。料金の詳細については、「AWS CodeCommit の料金表」を参照してください。

詳細なセットアップ方法については、AWS CodeCommit ユーザーガイドを参照してください。

プロジェクトコードをオンラインで保存するもう 1 つの一般的なオプションに、GitHub があります。GitHub では、パブリックオンラインリポジトリを無料で作成し、月額料金でプライベートリポジトリをサポートできます。github.com で、GitHub にサインアップします。

プロジェクトのリモートリポジトリの作成後、git remote add でリモートリポジトリをローカルリポジトリにアタッチします。

~/workspace/my-first-app$ git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/my-repo

EB CLI をインストールする

EB CLI を使用して Elastic Beanstalk 環境を管理し、コマンドラインからヘルスステータスをモニタリングします。インストール手順については、EB CLI をインストールするを参照してください。

デフォルトでは、EB CLI はプロジェクトフォルダ内のすべてをパッケージングし、ソースバンドルとして Elastic Beanstalk にアップロードします。Git と EB CLI を共に使用すると、ビルトクラスファイルが .gitignore でソースにコミットされないようにし、ソースファイルが .ebignore でデプロイされないようにできます。

プロジェクトフォルダの内容の代わりに、ビルドアーティファクトをデプロイするように EB CLI を設定することもできます (WAR または ZIP ファイル)。

AWS CLI のインストール

AWS Command Line Interface (AWS CLI) は、すべてのパブリック API オペレーションのコマンドを提供する AWS サービス向けの統合クライアントです。これらのコマンドは EB CLI によって提供されるレベルよりも低いレベルであり、多くの場合、AWS CLI を使用して操作を実行するのにより多くのコマンドが必要です。一方、AWS Command Line Interface を使用すると、ローカルマシンにリポジトリを設定しなくても、アカウントで実行中のアプリケーションまたは環境を使用できます。AWS CLI を使用して、操作タスクを簡素化または自動化するスクリプトを作成します。

サポートされるサービスの詳細および AWS Command Line Interface のダウンロード方法については、「AWS Command Line Interface」を参照してください。