前提条件 Elastic Beanstalk 環境の起動 CakePHP をインストールしてウェブサイトを生成するアプリケーションをデプロイしますお客様の環境にデータベースを追加するクリーンアップ次のステップ

CakePHP アプリケーションを Elastic Beanstalk にデプロイする

CakePHP はのオープンソースのMVCフレームワークですPHP。このチュートリアルでは、CakePHP プロジェクトを生成し、Elastic Beanstalk 環境にデプロイし、Amazon RDS データベースインスタンスに接続するように設定するプロセスについて説明します。

セクション

前提条件
Elastic Beanstalk 環境の起動
CakePHP をインストールしてウェブサイトを生成する
アプリケーションをデプロイします
お客様の環境にデータベースを追加する
クリーンアップ
次のステップ

前提条件

このチュートリアルでは、基本的な Elastic Beanstalk オペレーションと Elastic Beanstalk コンソールに関する知識があることを前提としています。まだ起動していない場合は、Elastic Beanstalk の開始方法の指示に従って、最初の Elastic Beanstalk 環境を起動します。

このガイドの手順に従うには、run command のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 ($) と現在のディレクトリの名前が前に付けられて、リストに示されます。


~/eb-project$ this is a command
this is output

Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、Linux 用の Windows サブシステムをインストールして、Windows 統合バージョンの Ubuntu と Bash を取得できます。

CakePHP 4 には PHP 7.2 以降が必要です。また、CakePHP の公式インストールドキュメントに記載されているPHP拡張機能も必要です。Elastic Beanstalk PHPの開発環境のセットアップトピックの手順に従って、 PHPと Composer をインストールします。

Elastic Beanstalk 環境の起動

Elastic Beanstalk コンソールを使用して、Elastic Beanstalk 環境を作成します。PHP プラットフォームを選択し、デフォルト設定とサンプルコードを受け入れます。

環境を起動するには (コンソール)

事前設定されたリンクを使用して Elastic Beanstalk コンソールを開きます: console.aws.amazon.com/elasticbeanstalk/home#/newApplication？applicationName=tutorials&environmentType=LoadBalanced
[プラットフォーム] で、アプリケーションで使用される言語に一致するプラットフォームとプラットフォームブランチを選択します。
アプリケーションコード として、サンプルアプリケーション を選択します。
確認と起動 を選択します。
使用できるオプションを確認します。使用する有効なオプションを選択し、準備ができたら [アプリケーションの作成] を選択します。

環境の作成の所要時間は約 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 グループはレスポンスとしてスケールアップまたはダウンを行います。
AWS CloudFormation スタック – Elastic Beanstalk は AWS CloudFormation を使用して環境内のリソースを起動し、設定変更を伝達します。リソースは、AWS CloudFormation コンソールに表示できるテンプレートで定義されます。
ドメイン名 - フォームでウェブアプリにルーティングするドメイン名 subdomain.region.elasticbeanstalk.com。

ドメインセキュリティ
Elastic Beanstalk アプリケーションのセキュリティを強化するために、elasticbeanstalk.com ドメインはパブリックサフィックスリスト (PSL）に登録されています。
Elastic Beanstalk アプリケーションのデフォルトのドメイン名に機密 Cookie を設定する必要がある場合は、セキュリティを強化するために__Host-プレフィックス付きの Cookie を使用することをお勧めします。このプラクティスは、クロスサイトリクエストの偽造の試み () からドメインを保護しますCSRF。詳細については、Mozilla 開発者ネットワークの「Set-Cookie」ページを参照してください。

これらのリソースはすべて Elastic Beanstalk によって管理されます。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。

注記

Elastic Beanstalk が作成する Amazon S3 バケットは、環境間で共有され、環境の終了時に削除されません。詳細については、「Amazon S3 で Elastic Beanstalk を使用する」を参照してください。

CakePHP をインストールしてウェブサイトを生成する

Composer は CakePHP をインストールし、次の 1 つのコマンドを使用して作業プロジェクトを作成できます。


~$ composer create-project --prefer-dist cakephp/app eb-cake

Composer は CakePHP と約 20 の依存関係をインストールし、デフォルトのプロジェクトを生成します。

Cake のインストールで問題が発生した場合はPHP、公式ドキュメントhttp://book.cakephp.org/4.0/en/installation.html」の「インストールトピック」を参照してください。

アプリケーションをデプロイします

Composer で作成されたファイルを含む出典バンドルを作成します。次のコマンドでは、cake-default.zip という出典バンドルが作成されます。vendor フォルダ内のファイルは除外されます。これらのファイルは、多くのスペースを使用するだけでなく、アプリケーションを Elastic Beanstalk にデプロイするのに不要です。


eb-cake zip ../cake-default.zip -r * .[^.]* -x "vendor/*"

ソースバンドルを Elastic Beanstalk にアップロードして、環境に CakePHP をデプロイします。

出典バンドルをデプロイするには

Elastic Beanstalk コンソールを開き、リージョンリストでを選択します AWS リージョン。
ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

注記
環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。
環境の概要ページで、[Upload and deploy (アップロードとデプロイ)] を選択します。
画面上のダイアログボックスを使用して、ソースバンドルをアップロードします。
[デプロイ] を選択します。
デプロイが完了したら、サイトを選択してURL新しいタブでウェブサイトを開くことができます。

注記

さらに出典バンドルを最適化するには、Git リポジトリを初期化し、git archive コマンドを使用して出典バンドルを作成します。デフォルトの Symfony プロジェクトには、.gitignore ファイルが含まれています。このファイルは、デプロイに不要な vendor フォルダと他のファイルを除外するよう Git に指示します。

プロセスが完了したら、 URL をクリックしてブラウザで CakePHP アプリケーションを開きます。

ここまで完了したら、次に、環境にデータベースを追加し、接続するように CakePHP を設定します。

お客様の環境にデータベースを追加する

Elastic Beanstalk 環境で Amazon RDS データベースインスタンスを起動します。CakePHP on Elastic Beanstalk では、My SQL、SQLServer、または PostgreSQL データベースを使用できます。この例では、Postgre を使用しますSQL。

Amazon RDS DB インスタンスを Elastic Beanstalk 環境に追加するには

Elastic Beanstalk コンソールを開き、リージョンリストでを選択します AWS リージョン。
ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

注記
環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。
ナビゲーションペインで、[設定] を選択します。
[Database (データベース)] で、[Edit (編集)] を選択します。
[DB engine] で、[postgres] を選択します。
マスターの [username] と [password] に入力します。Elastic Beanstalk は環境プロパティを使用して、アプリケーションにこれらの値を渡します。
ページの最下部で [適用] を選択し変更を保存します。

データベースインスタンスの作成には約 10 分かかります。その間に、環境から接続情報を読み取るようにソースコードを更新できます。Elastic Beanstalk は、RDS_HOSTNAME などの環境変数を使用して、接続の詳細をアプリケーションに渡します。

Cake PHPのデータベース設定は、プロジェクトコードの configフォルダapp.phpにあるという名前のファイルにあります。このファイルを開き、$_SERVER から環境変数を読み取ってローカル変数に割り当てるコードをいくつか追加します。最初の行（<?php）の後に、以下の例で強調表示された行を挿入します。

例 ~/Eb-cake/config/app.php


<?php
if (!defined('RDS_HOSTNAME')) {
  define('RDS_HOSTNAME', $_SERVER['RDS_HOSTNAME']);
  define('RDS_USERNAME', $_SERVER['RDS_USERNAME']);
  define('RDS_PASSWORD', $_SERVER['RDS_PASSWORD']);
  define('RDS_DB_NAME', $_SERVER['RDS_DB_NAME']);
}
return [
...

データベース接続は app.php 内をさらに下がったセクションで設定されています。以下のセクションを見つけ、データベースエンジン (Mysql、Sqlserver、または Postgres) と一致するドライバの名前で、デフォルトのデータソース設定を変更し、Elastic Beanstalk から対応する値を読み取るように host、username、password、database 変数を設定します。

例 ~/Eb-cake/config/app.php


...
     /**
     * Connection information used by the ORM to connect
     * to your application's datastores.
     * Drivers include Mysql Postgres Sqlite Sqlserver
     * See vendor\cakephp\cakephp\src\Database\Driver for complete list
     */
    'Datasources' => [
        '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 環境を更新するには

新しい出典バンドルを作成します。


~/eb-cake$ zip ../cake-v2-rds.zip -r * .[^.]* -x "vendor/*"

Elastic Beanstalk コンソールを開き、リージョンリストでを選択します AWS リージョン。
ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

注記
環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。
[アップロードとデプロイ] を選択します。
[Browse] を選択して cake-v2-rds.zip をアップロードします。
[Deploy‬] (デプロイ) を選択します。

アプリケーションの新しいバージョンのデプロイには 1 分以上かかりません。デプロイが完了したら、ウェブ・ページを更新して、データベースに接続されたことを確認します。

Green checkmark icon indicating successful database connection for CakePHP.

クリーンアップ

Elastic Beanstalk での作業が終了したら、環境を終了できます。Elastic Beanstalk は、Amazon EC2インスタンス、データベースインスタンス、ロードバランサー、セキュリティグループ、アラームなど、環境に関連付けられたすべての AWS リソースを終了します。 Elastic Beanstalk 環境のロードバランサー

コンソールから Elastic Beanstalk 環境を終了するには

Elastic Beanstalk コンソールを開き、リージョンリストでを選択します AWS リージョン。
ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

注記
環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。
[Actions] (アクション)、[Terminate environment] (環境の終了) の順に選択します。
画面上のダイアログボックスを使用して、環境の終了を確認します。

Elastic Beanstalk を使用すると、いつでもアプリケーション用の新しい環境を簡単に作成できます。

さらに、Elastic Beanstalk 環境の外に作成したデータベースリソースを終了できます。Amazon RDS DB インスタンスを終了すると、スナップショットを作成し、後で別のインスタンスにデータを復元できます。

RDS DB インスタンスを終了するには

Amazon RDSコンソールを開きます。
[データベース] を選択します。
DB インスタンスを選択します。
[アクション] を選択し、[削除] を選択します。
スナップショットを作成するかどうかを選択してから、削除を選択します。

次のステップ

Cake の詳細についてはPHP、book.cakephp.org で本をお読みください。

アプリケーションの開発が進むにつれ、.zip ファイルを手動で作成して Elastic Beanstalk コンソールにアップロードすることなく、環境を管理してアプリケーションをデプロイする方法が必要になります。Elastic Beanstalk コマンドラインインターフェイス (EB CLI) は easy-to-use、コマンドラインから Elastic Beanstalk 環境にアプリケーションを作成、設定、デプロイするためのコマンドを提供します。

Elastic Beanstalk 環境で Amazon RDS DB インスタンスを実行することは、開発とテストに最適ですが、データベースのライフサイクルを環境に結び付けます。自身の環境の外で実行されているデータベースに接続する手順については、「Elastic Beanstalk PHP 環境に Amazon RDS DB インスタンスを追加する」を参照してください。

最後に、本番環境でアプリケーションを使用する予定の場合は、環境にカスタムドメイン名を設定し、安全な接続のためにを有効にするHTTPS必要があります。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

チュートリアル - Laravel

チュートリアル - Symfony

CakePHP アプリケーションを Elastic Beanstalk にデプロイする

セクション

前提条件

Elastic Beanstalk 環境の起動

環境を起動するには (コンソール)

ドメインセキュリティ

注記

CakePHP をインストールしてウェブサイトを生成する

アプリケーションをデプロイします

出典バンドルをデプロイするには

注記

注記

お客様の環境にデータベースを追加する

Amazon RDS DB インスタンスを Elastic Beanstalk 環境に追加するには

注記

例 ~/Eb-cake/config/app.php

例 ~/Eb-cake/config/app.php

Elastic Beanstalk 環境を更新するには

注記

クリーンアップ

コンソールから Elastic Beanstalk 環境を終了するには

注記

RDS DB インスタンスを終了するには

次のステップ