Git hook deployment made for Laravel

Install

Via Composer

$ composer require webklex/laravel-git-hook

Setup

Add the service provider to the providers array in config/app.php.

'providers' => [
    Webklex\GitHook\Providers\LaravelServiceProvider::class,
];

Publishing

You can publish everything at once

php artisan vendor:publish --provider="Webklex\GitHook\Providers\LaravelServiceProvider"

Usage

This library is designed to handle the automatic deployment by git hooks as simple as possible. There isn't much todo to get started: just add the Provider and edit the config/git-hook.php file to make it fit your needs.

Custom configuration can be made within the config/git-hook.php file:

| Parameter | Default | Options | Description | | ------------------ | :-------------------------------: | :---------------------------------------: | --------------------------------------------------------------------------------------------------------: | | email_recipients | [] | [['name' => '', 'address' => ''], ...] | Get notified by mail. Just add your credentials | | email_email_sender | ['address' => '', 'name' => ''] | ['address' => '', 'name' => ''] | Specify a custom email sender address | | repo_path | null | Leave empty to auto detect the vcs root | Perhaps your repository is somehow specially structured, if that's the case, specify your repository path | | allowed_sources | [] | ['192.168.1.1', '192.168.1.2', ...] | If you want to secure the deployment process a bit more, whitelist the remote repository IPs | | remote | origin | | Your remote branch name | | git_path | /usr/bin/git | | Where is the git binary located | | logfile | git-hook | | Name of the logfile. It will be stored under storage/logs | | service | github | github, gitbucket, gitlab | Define your remote git service. This is required to identify the payload | | url | git-hook | | Define the deployment url. Keep in mind, that the given parameter will be added to your app.url | | before_pull | [] | ['down', ['cmd', ['arg1' => 1]]] | If you have any commands that have to be called before a pull event, specify them here | | after_pull | [] | ['cmd', ['cmd1', ['arg1' => 1]], 'up'] | If you have any commands that have to be called after a pull event, specify them here |

If you are concerned someone could guess it, use a more cryptic url such as: JHFUjhd67567JHFGhsd78236784wegfJHFghdgf

Potential problems:

Please make sure your www-data user can actually perform a git pull on the server without having to enter a password: so you might want to take a look at ssh-keys or something similar

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email github@webklex.com instead of using the issue tracker.

Credits

• Webklex
• All Contributors

License

The MIT License (MIT). Please see License File for more information.