AWS OpstWorks PHP Cookbooks.

Summary

"OpsWorks is a DevOps solution for managing the coplete application lifecycle, including resource provisioning, configuration management, applcation deployment software updates, monitori9ng and access cotrol."

This repository contains a small collection of recipes to help setup PHP application in OpsWorks. Currently two PHP frameworks are supported: FuelPHP and Symfony 2.x.

Some of the cookbooks functionality include:

• Enable Memory Swap for micro instances.
• Composer install and update.
• ACL setup for Ubuntu instances.
• FuelPHP database configuration for both OpsWorks Database layer and RDS.
• FuelPHP custom .htaccess template and environment variables.
• Symfony custom parameters.yml (currently only suports OpsWorks Database layer).
• Symfony custom .htaccess template and environment variables.
• Symfony configuration of writable directories (requires acl_setup).
• Startup Beanstalk and Supervisor to manage worker queues (requires beanstalk and suprevisor OS packages).

#Requirements

• Ubuntu Instances.
• Apache2.
• mod_env must be enabled.

Version

0.1.1

Credits

Some parts of this code where taken from the ace-cookbooks opsworks_app_environment. Also see this.

Installation

• In your OpsWorks stack settings enable "Use custom Chef Cookbooks"
• Select "Repository type" = Git (or any repository you choose to use)
• "Repository URL" use [email protected]:onema/chef-cookbooks.git or your Fork Url.
• Set the SSH key if you have one, if not this can be left blank as long as the repo is public.
• Depending on what recipes you use you may need to set a Custom Chef JSON.

Cookbooks

##phpenv This cookbook contains utility recipes to help setup applications.

###phpenv::memoryswap AWS micro instances have little memory (615 MB), and can often times run out of memory. I have run into memory issues when doing composer installs or updates.

Use recipe on Setup ONLY.

See these references for more info:

• AWS Micro Instances
• Using composer in AWS + Micro Instance
• Adding Swap to any EC2 Instance
• Symfony2, Composer, Capifony and an EC2 Micro instance
• ErrorException: proc_open(): fork failed - Cannot allocate memory in phar

###phpenv::mongodb This recipe installs the mongodb php driver using PECL (Requires the php-pear OS package).

Use recipe on Setup ONLY.

###Other recipes Other recipes have been deprecated or moved to other cookbooks because they are framework dependent and will be removed in the next version.

##composer This coockbook contains recipes to run the install and update commands.

###composer::install This will download the latest version of composer from https://getcomposer.org/installer to the current deployment directory and will run $ php composer.phar install --optimize-autoloader.

###composer::update Similar to install this recipe will download the latest version of composer from https://getcomposer.org/installer to the current deployment directory and will run $ php composer.phar update.

##fuel This is a collection of recipes for the FuelPHP framework.

###fuel::env_vars Currently it is not possible to setup Environment Variables for PHP stacks in Amazon Web Services OpsWorks. This recipe creates a custom .htaccess in the public dicrectory and sets environment variables using the apache setEnv directive. The recipe can create unique .htaccess file for each application in your stack. The evironment variables can be set in the custom Chef JSON like this:

{
    "custom_env": {
        "staging_site": {
            "environment": "staging",
            "env_vars" : [ 
                "CACHE_TIME 3600", 
                "SOME_API_KEY BlahBlah", 
                "ANOTHER_API_KEY helloWorld!" 
            ] 
        },
        "production_site": {
            "environment": "production",
            "env_vars" : [ 
                "CACHE_TIME 1234", 
                "SOME_API_KEY nahnah", 
                "ANOTHER_API_KEY hello-monkey!" 
            ] 
        }
    }
}

The name custom_env is required. The values staging_site and production_site are the applications created in this stack and must match the application name.

The array of values "env_vars" will have any environment variable needed to run the application. The format is

"KEY value"

in the example above the production site $_SERVER array would look like this:

Array
(
//... 
    [FUEL_ENV] => production
    [ANOTHER_API_KEY] => hello-monkey!
    [GA_API_CACHE_TIME] => 1234
    [SOME_API_KEY] => nahnah
//... 
)

Note that in this case we do not add an environment value for FUEL_ENV, this is because the recipe will use the application value environment to set it.

NOTE: THE RECIPE WILL NOT WORK IF YOUR APPLICATION NAME HAS SPACES OR DASHES "-" BETWEEN WORDS. Use underscores "_" to separate words to avoid problems NOTE2: THESE ENVIRONMENT VALUES WILL NOT BE ABAILABLE IN THE TERMINAL. ANY TASKS YOU RUN FROM THE TERMINAL MUST SET THE EVIRONMENT NAME The .htaccess generated by this recipe will look like this:

<IfModule mod_rewrite.c>
  RewriteEngine on 
  RewriteCond %{REQUEST_FILENAME} !-f 
  RewriteCond %{REQUEST_FILENAME} !-d 
  RewriteRule ^(.*)$ index.php/$1 [L] 
  
  <IfModule mod_env.c> 
    # Environment Variables for application production_site 
    SetEnv ANOTHER_API_KEY hello-monkey! 
    SetEnv FUEL_ENV production 
    SetEnv GA_API_CACHE_TIME 1234 
    SetEnv SOME_API_KEY nahnah 
  </IfModule> 
</IfModule>

###fuel::migrate This will run the FuelPHP database migration script env FUEL_ENV=environment php oil r migrate. The "environment" will be the one set in the custom Chef JSON.

###fuel::rdsconfig If you have correctly setup RDS to work with OpsWorks instances, use this recipe to create a database configuration file db.php in the correct environment directory. The Database values are set in the custom Chef JSON:

{ 
    "custom_env": {
        "production_site": {
            "environment": "production",
            "database": {
                "dbname": "dbname", 
                "host": "mydatabase.abcd1234.region.rds.amazonaws.com", 
                "user": "username", 
                "password": "p@55w0rD",
                "port": "3306"
           },
            "env_vars" : [ 
                ...
            ]
        }
    }
}

In this example the file will be created in current/fuel/app/config/production/db.php. If the environment is set to staging it will be created in current/fuel/app/config/staging/db.php.

###fuel::dbconfig If a OpsWorks Database layer is used intead of RDS use this recipe to create the db.php config file in the correct environment dicrectory. There is no need to create a custom Chef JSON entry for this recipe as OpsWorks provides this information internaly via deploy[:database].

###fuel::ses This recipe creates a configuration file for the alleluu/fuel-aws-ses package. This recipe uses the custom Chef JSON "ses" entry to setup the file. This file is created in the root config directory (it is not environment specific)

{ 
    "custom_env": {
        "production_site": {
            "environment": "production",
            "ses": {
                "access_key": "SDFGHJKL", 
                "secret_key": "DFGH123456POIUY0987"
           }
        }
    }
}

##workers Recipes to startup beanstalkd and supervisor.

###workers::supervisor Starts up supervisor using the configuration file that must be located in the root of the project.

###workers::beanstalkd Starts up beanstalkd.

##symfony This cookbook contains a collection of recipes to help setup a symfony 2 application.

###symfony::acl_setup This recipe installs acl.

###symfony::configure This recipe requires acl_setup. This recipe should be broken down into multiple ones as it is currently a collection of multiple actions:

• It gives the symfony application write access to app/cache/* and app/logs/*.
• Creates custom .htaccess to setup environment variables similar to the env_vars recipe for FuelPHP.
• Downloads Composer and runs install command.
• Includes the symfony::paramconfig recipe

###symfony::paramconfig This recipe creates a custom parameters.yml using values from the custom Chef JSON entry "parameters":

{ 
    "custom_env": {
        "production_site": {
            "values" : [ 
                // for custom environment values 
            ],
            "parameters" : [ 
                "locale: en",
                "database_name: my_database_name"
            ]
        }
    }
}

MIT LICENSE

Copyright (c) 2013 onema

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.