翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Elastic Beanstalk への CakePHP アプリケーションのデプロイ
CakePHP は PHP 用のオープンソースの MVC フレームワークです。このチュートリアルでは、CakePHP のプロジェクトを生成し、Elastic Beanstalk 環境にデプロイし、Amazon RDS データベースインスタンスに接続するように設定するプロセスについて説明します。
**Topics**
+ [前提条件](#php-cakephp-tutorial-prereqs)
+ [Elastic Beanstalk 環境の起動](#php-cakephp-tutorial-launch)
+ [CakePHP をインストールしてウェブサイトを生成する](#php-cakephp-tutorial-generate)
+ [アプリケーションをデプロイします](#php-cakephp-tutorial-deploy)
+ [お客様の環境にデータベースを追加する](#php-cakephp-tutorial-database)
+ [クリーンアップ](#php-cakephp-tutorial-cleanup)
+ [次の手順](#php-cakephp-tutorial-nextsteps)
## 前提条件
このチュートリアルでは、基本的な Elastic Beanstalk オペレーションと Elastic Beanstalk コンソールに関する知識があることを前提としています。まだ起動していない場合は、[Elastic Beanstalk の使用を開始する方法について説明します](GettingStarted.md) の指示に従って、最初の Elastic Beanstalk 環境を起動します。
このガイドの手順に従うには、run command のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 (\$1) と現在のディレクトリの名前が前に付けられて、リストに示されます。
```
~/eb-project$ this is a command
this is output
```
Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、[Linux 用の Windows サブシステムをインストール](https://docs.microsoft.com/en-us/windows/wsl/install-win10)して、Ubuntu および Bash の Windows に統合されたバージョンを入手できます。
CakePHP 4 には PHP 7.4 以降が必要です。また、[CakePHP インストール](https://book.cakephp.org/4/en/installation.html)に関する公式ドキュメントに記載されている PHP 拡張も必要です。PHP と Composer の両方をインストールする必要があります。
## Elastic Beanstalk 環境の起動
Elastic Beanstalk コンソールを使用して、Elastic Beanstalk 環境を作成します。[**PHP**] プラットフォームを選択し、デフォルト設定およびサンプルコードを受け入れます。
**環境を起動するには (コンソール)**
1. 事前に設定されたリンク ([console.aws.amazon.com/elasticBeanstalk/home\$1/newApplication?applicationName=tutorials&environmentType=LoadBalanced](https://console.aws.amazon.com/elasticbeanstalk/home#/newApplication?applicationName=tutorials&environmentType=LoadBalanced)) を使用して、Elastic Beanstalk コンソールを開きます。
1. [**プラットフォーム**] で、アプリケーションで使用される言語に一致するプラットフォームとプラットフォームブランチを選択します。
1. **アプリケーションコード** として、**サンプルアプリケーション** を選択します。
1. **確認と起動** を選択します。
1. 使用できるオプションを確認します。使用する有効なオプションを選択し、準備ができたら [**アプリケーションの作成**] を選択します。
環境の作成の所要時間は約 5 分です。以下のリソースが作成されます。
+ **EC2 インスタンス** – 選択したプラットフォームでウェブ・アプリケーションを実行するよう設定された Amazon Elastic Compute Cloud (Amazon EC2) 仮想マシン。
各プラットフォームは、それぞれ特定の言語バージョン、フレームワーク、ウェブコンテナ、またはそれらの組み合わせをサポートするための、特定のソフトウェア、設定ファイル、スクリプトを実行します。ほとんどのプラットフォームでは、Apache または NGINX のいずれかをウェブアプリケーションの前にリバースプロキシとして配置します。そのプロキシがリクエストをアプリケーションに転送し、静的アセットを提供し、アクセスログとエラーログを生成します。
+ **インスタンスセキュリティグループ** – ポート 80 上のインバウンドトラフィックを許可するよう設定された Amazon EC2 セキュリティグループ。このリソースでは、ロードバランサーからの HTTP トラフィックが、ウェブ・アプリケーションを実行している EC2 インスタンスに達することができます。デフォルトでは、トラフィックは他のポート上で許可されません。
+ **ロードバランサー** – アプリケーションを実行するインスタンスにリクエストを分散するよう設定された Elastic Load Balancing ロードバランサー。ロードバランサーにより、インスタンスを直接インターネットに公開する必要もなくなります。
+ **ロードバランサーセキュリティグループ** – ポート 80 上のインバウンドトラフィックを許可するよう設定された Amazon EC2 セキュリティグループ。このリソースでは、インターネットからの HTTP トラフィックが、ロードバランサーに達することができます。デフォルトでは、トラフィックは他のポート上で許可されません。
+ **Auto Scaling グループ** – インスタンスが終了されたか利用不可になった場合にそのインスタンスを置き換えるよう設定された Auto Scaling グループ。
+ **Amazon S3 バケット** – Elastic Beanstalk の使用時に作成されるソースコード、ログ、その他のアーティファクトの保存場所。
+ **Amazon CloudWatch アラーム** – 環境内のインスタンスの負荷をモニタリングする 2 つの CloudWatch アラーム。負荷が高すぎる、または低すぎる場合にトリガーされます。アラームがトリガーされると、Auto Scaling グループはレスポンスとしてスケールアップまたはダウンを行います。
+ **CloudFormation スタック** – Elastic Beanstalk は CloudFormation を使用して環境内のリソースを起動し、設定変更を伝達します。リソースは、[CloudFormation コンソール](https://console.aws.amazon.com/cloudformation)に表示できるテンプレートで定義されます。
+ **ドメイン名** – ウェブ・アプリケーションまでのルートとなるドメイン名であり、**subdomain*.*region*.elasticbeanstalk.com* の形式です。
**ドメインセキュリティ**
Elastic Beanstalk アプリケーションのセキュリティを強化するため、*elasticbeanstalk.com* ドメインは[パブリックサフィックスリスト (PSL)](https://publicsuffix.org/) に登録されています。
Elastic Beanstalk アプリケーションのデフォルトドメイン名に機密性のある Cookie を設定する必要がある場合は、セキュリティ強化のため `__Host-` プレフィックスの付いた Cookie の使用をお勧めします。このプラクティスは、クロスサイトリクエストフォージェリ (CSRF) 攻撃からドメインを防御します。詳細については、Mozilla 開発者ネットワークの「[Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes)」ページを参照してください。
これらのリソースはすべて Elastic Beanstalk によって管理されます。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。
**注記**
Elastic Beanstalk が作成する Amazon S3 バケットは、環境間で共有され、環境の終了時に削除されません。詳細については、「[Amazon S3 で Elastic Beanstalk を使用する](AWSHowTo.S3.md)」を参照してください。
## CakePHP をインストールしてウェブサイトを生成する
以下の 1 つのコマンドで、Composer は CakePHP をインストールして作業プロジェクトを作成できます。
```
~$ composer create-project --prefer-dist cakephp/app eb-cake
```
Composer は、CakePHP と約 20 個の依存関係をインストールし、デフォルトのプロジェクトを生成します。
CakePHP のインストール中に問題が発生した場合は、公式ドキュメントのインストールに関するトピック ([http://book.cakephp.org/4.0/en/installation.html](http://book.cakephp.org/4.0/en/installation.html)) をご参照ください。
## アプリケーションをデプロイします
Composer で作成されたファイルを含む[出典バンドル](applications-sourcebundle.md)を作成します。次のコマンドでは、`cake-default.zip` という出典バンドルが作成されます。`vendor` フォルダ内のファイルは除外されます。これらのファイルは、多くのスペースを使用するだけでなく、アプリケーションを Elastic Beanstalk にデプロイするのに不要です。
```
eb-cake zip ../cake-default.zip -r * .[^.]* -x "vendor/*"
```
ソースバンドルを Elastic Beanstalk にアップロードし、CakePHP を環境にデプロイします。
**出典バンドルをデプロイするには**
1. [Elastic Beanstalk コンソール](https://console.aws.amazon.com/elasticbeanstalk)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、[**環境**] を選択し、リストから環境の名前を選択します。
1. 環境の概要ページで、[**Upload and deploy (アップロードとデプロイ)**] を選択します。
1. 画面上のダイアログボックスを使用して、ソースバンドルをアップロードします。
1. [**デプロイ**] を選択します。
1. デプロイが完了したら、新しいタブのウェブサイトを開く、サイトの URL を選択できます。
**注記**
さらに出典バンドルを最適化するには、Git リポジトリを初期化し、[`git archive` コマンド](applications-sourcebundle.md#using-features.deployment.source.git)を使用して出典バンドルを作成します。デフォルトの Symfony プロジェクトには、`.gitignore` ファイルが含まれています。このファイルは、デプロイに不要な `vendor` フォルダと他のファイルを除外するよう Git に指示します。
プロセスが完了したら、ブラウザで CakePHP アプリケーションを開くための URL をクリックします。
ここまで完了したら、次は、お客様の環境にデータベースを追加し、そのデータベースに接続するように CakePHP を設定します。
## お客様の環境にデータベースを追加する
Elastic Beanstalk 環境で Amazon RDS データベースインスタンスを起動します。Elastic Beanstalk 上の CakePHP では、MySQL、SQLServer、または PostgreSQL データベースを使用できます。この例では、PostgreSQL を使用します。
**Amazon RDS DB インスタンスを Elastic Beanstalk 環境に追加するには**
1. [Elastic Beanstalk コンソール](https://console.aws.amazon.com/elasticbeanstalk)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、[**環境**] を選択し、リストから環境の名前を選択します。
1. ナビゲーションペインで、[**設定**] を選択します。
1. [**Database (データベース)**] で、[**Edit (編集)**] を選択します。
1. [**DB engine**] で、[**postgres**] を選択します。
1. マスターの [**username**] と [**password**] に入力します。Elastic Beanstalk は環境プロパティを使用して、アプリケーションにこれらの値を渡します。
1. ページの最下部で **[適用]** を選択し変更を保存します。
データベースインスタンスの作成には約 10 分かかります。その間に、環境から接続情報を読み取るようにソースコードを更新できます。Elastic Beanstalk は、`RDS_HOSTNAME` などの環境変数を使用して、接続の詳細をアプリケーションに渡します。
CakePHP のデータベース設定は、プロジェクトコードで `app.php` フォルダ内の `config` という名前のファイルにあります。このファイルを開き、`$_SERVER` から環境変数を読み取ってローカル変数に割り当てるコードをいくつか追加します。最初の行（` [
'default' => [
'className' => 'Cake\Database\Connection',
'driver' => 'Cake\Database\Driver\Postgres',
'persistent' => false,
'host' => RDS_HOSTNAME,
/*
* CakePHP will use the default DB port based on the driver selected
* MySQL on MAMP uses port 8889, MAMP users will want to uncomment
* the following line and set the port accordingly
*/
//'port' => 'non_standard_port_number',
'username' => RDS_USERNAME,
'password' => RDS_PASSWORD,
'database' => RDS_DB_NAME,
/*
* You do not need to set this flag to use full utf-8 encoding (internal default since CakePHP 3.6).
*/
//'encoding' => 'utf8mb4',
'timezone' => 'UTC',
'flags' => [],
'cacheMetadata' => true,
'log' => false,
...
```
DB インスタンスの起動が完了したら、更新したアプリケーションのバンドルを作成し、お客様の環境にデプロイします。
**Elastic Beanstalk 環境を更新するには**
1. 新しい出典バンドルを作成します。
```
~/eb-cake$ zip ../cake-v2-rds.zip -r * .[^.]* -x "vendor/*"
```
1. [Elastic Beanstalk コンソール](https://console.aws.amazon.com/elasticbeanstalk)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、[**環境**] を選択し、リストから環境の名前を選択します。
1. [**アップロードとデプロイ**] を選択します。
1. [**Browse**] を選択して `cake-v2-rds.zip` をアップロードします。
1. [**Deploy**] (デプロイ) を選択します。
アプリケーションの新しいバージョンのデプロイには 1 分以上かかりません。デプロイが完了したら、ウェブ・ページを更新して、データベースに接続されたことを確認します。
![\[Green checkmark icon indicating successful database connection for CakePHP.\]](http://docs.aws.amazon.com/ja_jp/elasticbeanstalk/latest/dg/images/php-cakephp-defaultwdb.png)
## クリーンアップ
デモコードの操作が完了したら、環境を終了できます。Elastic Beanstalk は、[Amazon EC2 インスタンス](using-features.managing.ec2.md)、[データベースインスタンス](using-features.managing.db.md)、[ロードバランサー](using-features.managing.elb.md)、セキュリティグループ、[アラーム](using-features.alarms.md#using-features.alarms.title)など、関連するすべての AWS リソースを削除します。
リソースを削除しても Elastic Beanstalk アプリケーションは削除されないため、いつでもアプリケーションの新しい環境を作成できます。
**コンソールから Elastic Beanstalk 環境を終了するには**
1. [Elastic Beanstalk コンソール](https://console.aws.amazon.com/elasticbeanstalk)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、[**環境**] を選択し、リストから環境の名前を選択します。
1. **[Actions]** (アクション)、**[Terminate environment]** (環境の終了) の順に選択します。
1. 画面上のダイアログボックスを使用して、環境の終了を確認します。
さらに、Elastic Beanstalk 環境の外に作成したデータベースリソースを終了できます。Amazon RDS DB インスタンスを終了する場合、スナップショットを作成し、後で別のインスタンスにデータを復元できます。
**RDS DB インスタンスを終了するには**
1. [Amazon RDS コンソール](https://console.aws.amazon.com/rds)を開きます。
1. [**データベース**] を選択します。
1. DB インスタンスを選択します。
1. **[アクション]**、**[削除]** の順に選択します。
1. スナップショットを作成するかどうかを選択してから、**削除** を選択します。
## 次の手順
CakePHP の詳細については、ドキュメント ([book.cakephp.org](http://book.cakephp.org/4.0/en/index.html)) をお読みください。
アプリケーションの開発が進むにつれ、.zip ファイルを手動で作成して Elastic Beanstalk コンソールにアップロードすることなく、環境を管理してアプリケーションをデプロイする方法が必要になります。[Elastic Beanstalk コマンドラインインターフェイス](eb-cli3.md) (EB CLI) には、コマンドラインインターフェイスからアプリケーションを作成、設定して、Elastic Beanstalk 環境にデプロイするための使いやすいコマンドが用意されています。
Elastic Beanstalk 環境で Amazon RDS DB インスタンスを実行するのは、開発とテストには最適ですが、データベースのライフサイクルがお客様の環境に結び付けられます。自身の環境の外で実行されているデータベースに接続する手順については、「[PHP Elastic Beanstalk 環境に Amazon RDS DB インスタンスを追加する](create_deploy_PHP.rds.md)」を参照してください。
最後に、本稼働環境でアプリケーションを使用する予定の場合は、お客様の環境に[カスタムドメイン名を設定](customdomains.md)し、安全な接続のために [HTTPS を有効にする](configuring-https.md)ことが必要になります。