Laravel-Artisan Cookbook

Did you ever want to to run Laravel's php artisan commands on an automated infrastructure? If you are using Chef then this cookbook is for you.

Scope

This cookbook supports some of the artisan commands, that are useful on a load balanced server infrastructure.

Commands that are particular useful for development are not supported.

Supported commands:

• clear-compiled
• down
• env
• up
• cache:clear
• config:cache
• config:clear
• migrate:status
• package:discover
• queue:work
• schedule:run
• view:clear

Requirements

• Chef 12.7 or higher

Platform Support

This cookbook has been developed and used on Ubuntu 16.04.

Environment Support

Supported Environments:
* Vagrant
* AWS Opsworks

Cookbook Dependencies

Currently none.

Usage

Place a dependency on the mysql cookbook in your cookbook's metadata.rb

depends 'laravel-artisan'

or add the dependency in your Berksfile:

ruby
cookbook 'laravel-artisan'


Then, you can run the recipes using Chef's runlist. Right away this will throw an Exception. To get it work properly you have
to pass a path to the directory where the artisan file is located.

Envirionment file

Passing the path to the artisan file via an environment file:
json
{
"name": "development",
"description": "Vagrant Development Environment",
"default_attributes": {
"laravel-artisan": {
"path": "<path-to-artisan-file>"
}
},
"json_class": "Chef::Environment",
"chef_type": "environment"
}


AWS Opsworks

Using AWS Opsworks you can pass in the path via custom json:
json
{
"laravel-artisan": {
"path": "<path-to-artisan-file>"
}
}


Recipes

• laravel-artisan::clear-compiled - Remove the compiled class file
• laravel-artisan::down - Put the application into maintenance mode.
• laravel-artisan::env - Display the current framework environment.
• laravel-aritsan::up - Bring the application out of maintenance mode.
• laravel-artisan::cache_clear - Flush the application cache.
• laravel-artisan::config_cache - Create a cache file for faster configuration loading.
• laravel-artisan::config_clear - Remove the configuaration cache file.
• laravel-artisan::migrate_status - Show the status of each migration.
• laravel-artisan::package_discover - Rebuild the cached package manifest.
• laravel-artisan::queue_work - Start processing jobs on the queue as a daemon.
• laravel-artisan::queue_stop - Stop processing jobs on the queue as a daemon.
• laravel-artisan::schedule_run - Run the scheduled commands.
• laravel-artisan::schedule_remove - Remove the cronjob that runs php artisan schedule:run
• laravel-artisan::view_clear - Clear all compiled view files.