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.
Create custom files to include environment variables using either .htaccess or php files.
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.4.0

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

##cronjobs This cookbook creates cronjobs based on configuration values

###cronjobs::default (experimental) Default will create multiple cronjobs based on the following configuration values:

{
    "custom_env": {
        "cron_jobs": [  
            {
                // Send an email every sunday at 8:10
                "name": "send_email_sunday_8",
                "minute": "10", 
                "hour":   "8", 
                "month" :  "*",
                "weekday": "6",
                "command": "cd /srv/www/staging_site/current && php .lib/mailing.php" 
            },
            {
                // Run at 8:00 PM every weekday Monday through Friday ONLY in November. 
                Notice there is no day
                "name": "run_at_20h_nov", 
                "minute": "0", 
                "hour":   "20",
                "month":   "10", 
                "weekday": "1-5",
                "command": "cd /srv/www/staging_site/current && php app/console command:start:jobs" 
            },
            {
                // Run Every 12 Hours - 1AM and 1PM
                "name": "run_every_12h",
                "minute" :  "*",
                "hour":   "1-13",
                "month" :  "*",
                "weekday" :  "*",
                "command": "cd /srv/www/production_site/current && php app/console hello:world" 
            },
            {
                // Run every 15 minutes
                "name": "do_something_stupid_every_15m",
                "minute": "15", 
                "hour" :  "*",
                "month" :  "*",
                "weekday" :  "*",
                "command": "cd /srv/www/production_site/current && php app/console memory:leak" 
            },
        ]
    }
}

Use on setup and deploy life cycles.

For more information see the AWS OpsWorks documentation.

All parameters are required.

##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:

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

Use recipe on Setup ONLY.

###phpenv::php_redis This recipe installs the redis php module using PECL (Requires the php-pear OS package).

Use recipe on Setup ONLY.

###phpenv::htaccess_env_vars This recipe creates a custom .htaccess in the directory of your choice and sets environment variables using the apache setEnv directive. A default .htaccess file is provided with this recipe, but a custom .htaccess file can be used. The recipe can create a unique .htaccess file for each application in the stack. Two configuration values are required to make this recipe work: htaccess_template for example htaccess.rb, and path_to_vars This is the path where the htaccess file will be created. The evironment variables can be set in the custom Chef JSON like this:

{
    "custom_env": {
        "staging_site": {
            "environment": "staging",
            "htaccess_template": "htaccess.rb",
            "path_to_vars": "web",
            "env_vars" : [ 
                "CACHE_TIME 3600", 
                "SOME_API_KEY BlahBlah", 
                "ANOTHER_API_KEY helloWorld!" 
            ] 
        },
        "production_site": {
            "environment": "production",
            "htaccess_template": "advanced_htaccess.rb",
            "path_to_vars": "public",
            "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" (KEY space VALUE)

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

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

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 AVAILABLE 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 GA_API_CACHE_TIME 1234 
    SetEnv SOME_API_KEY nahnah 
  </IfModule> 
</IfModule>

###phpenv::php_env_vars This recipe creates a custom environment_variables.php in the directory of your choice and sets environment variables using the putenv function. In order to use this file and have the env vars available on every request, the file must be included each time. The recipe can create a unique file for each application in the stack. One configuration values is required to make this recipe work: path_to_vars. This is the path where the environment_variales.php file will be created.

The evironment variables can be set in the custom Chef JSON like this:

{
    "custom_env": {
        "staging_site": {
            "environment": "staging",
            "path_to_vars": "src/acme/application/config/staging",
            "env_vars" : [ 
                "CACHE_TIME=3600", 
                "SOME_API_KEY=BlahBlah", 
                "ANOTHER_API_KEY=helloWorld!" 
            ] 
        },
        "production_site": {
            "htaccess_template": "advanced_htaccess.rb",
            "path_to_vars": "src/acme/application/config/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"

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 AVAILABLE IN THE TERMINAL. ANY TASKS YOU RUN FROM THE TERMINAL MUST SET THE EVIRONMENT NAME The environment_variables.php generated by this recipe will look like this:

    // Environment Variables for application production_site 
    putenv("ANOTHER_API_KEY hello-monkey!");
    putenv("FUEL_ENV production");
    putenv("GA_API_CACHE_TIME 1234");
    putenv("SOME_API_KEY nahnah");

###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 Deprecated, use phpenv::htaccess_env_vars or phpenv::php_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.

<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

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.

hedinfaok / opsworks-chef-cookbooks Goto Github PK

opsworks-chef-cookbooks's Introduction

AWS OpstWorks PHP Cookbooks.

Summary

Version

Credits

Installation

Cookbooks

MIT LICENSE

opsworks-chef-cookbooks's People

Contributors

Watchers

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent