mikevrind/deployer

Easy deployer for web projects using Gitlab

Thursday, July 7, 2016
by MikeVrind
Repository
3 Watchers
1 Stars
443 Installations

PHP
0 Dependents
0 Suggesters
3 Forks
1 Open issues
17 Versions
1 % Grown

The README.md

Deployer

, _(*1)

Use this package to automate the deployment process of your Laravel project that are hosted on Gitlab. Just follow the installation instructions. Don't forget to check the configuration file for the deployment options!, _(*2)

Installation

Require this package with composer:, _(*3)

composer require mikevrind/deployer

After updating composer, add the DeployerServiceProvider to the providers array in config/app.php, _(*4)

MikeVrind\Deployer\DeployerServiceProvider::class,

Configuration

The setup of the deployer can (and should be) changed by publishing the configuration file., _(*5)

You should use Artisan to copy the default configuration file from the /vendor directory to /config/deployer.php with the following command:, _(*6)

php artisan vendor:publish --provider="MikeVrind\Deployer\DeployerServiceProvider"

It's advised to define the settings via your .env file so that it's possible to change the behavior of the deployer per environment, _(*7)

CSRF Token

Update the VerifyCsrfToken middleware by adding '_deployer/deploy' to the $except array.
Without this exception, all webhooks will fail because of a missing token in each request., _(*8)

.env setup

Add the following lines to your .env(.example) file. The DEPLOYER_REMOTE_* settings are used to establish a CLI connection with the server., _(*9)

DEPLOYER_ENABLED=true
DEPLOYER_MAIL_ENABLED=true
DEPLOYER_REPO_BRANCH=
DEPLOYER_REPO_PROJECT_ID=
DEPLOYER_REPO_REPOSITORY=

DEPLOYER_REMOTE_HOST=
DEPLOYER_REMOTE_USER=
DEPLOYER_REMOTE_PWD=
DEPLOYER_REMOTE_KEY=
DEPLOYER_REMOTE_KEYTEXT=
DEPLOYER_REMOTE_KEYPHRASE=
DEPLOYER_REMOTE_TIMEOUT=

Settings

DEPLOYER_ENABLED (default; false)

Determines if the deployer should be enabled for this environment, _(*10)

DEPLOYER_MAIL_ENABLED (default; false)

Determines if after deployment has been completed a mail should be send to the configured recipients, _(*11)

DEPLOYER_REPO_BRANCH (default; master)

Determines to which branch the deployer should listen to when the web hook is fired, _(*12)

DEPLOYER_REPO_PROJECT_ID (default; 1)

Determines to which project ID the deployer should listen to when the web hook is fired, _(*13)

DEPLOYER_REPO_REPOSITORY (default; git@git.domain.tld/group/project.git)

Determines to which project ID the deployer should listen to when the web hook is fired, _(*14)

DEPLOYER_REMOTE_HOST (default; '')

Determines to which HOST the SSH connection should be established, _(*15)

DEPLOYER_REMOTE_USER (default; '')

Determines the user that should be used for the SSH connection, _(*16)

DEPLOYER_REMOTE_PWD (optional, default; '')

Determines the password for the user that should be used for the SSH connection, _(*17)

DEPLOYER_REMOTE_KEY (optional, default; '')

Determines the public_key filename for the user that should be used for the SSH connection, _(*18)

DEPLOYER_REMOTE_KEYTEXT (optional, default; '')

Determines the public_key for the user that should be used for the SSH connection, _(*19)

DEPLOYER_REMOTE_KEYPHRASE (optional, default; '')

Determines the password for the public_key, _(*20)

DEPLOYER_REMOTE_TIMEOUT (default; 120)

Determines how long the connection should wait for your commands. Settings this to 0 will wait indefinitely for your command to finish., _(*21)

Webhook configuration

Open your project and go to Settings -> Web hooks. This package listens to the _deployer/deploy route.
So add something like http(s)://www.domain.tld/_deployer/deploy as the URL.
In most cases, the Push events trigger will be oke to use. Now add the new webhook and you're done!, _(*22)

Contributing

Please see CONTRIBUTING for details., _(*23)

Security

If you discover any (security related) issues, please create an issue in the the issue tracker., _(*24)

License

The MIT License (MIT). Please see License File for more information., _(*25)

The Versions

07/07 2016

dev-master

9999999-dev

Easy deployer for web projects using Gitlab

library deployer

Easy deployer for web projects using Gitlab

mikevrind/deployer

The README.md

Deployer

Installation

Configuration

CSRF Token

.env setup

Settings

DEPLOYER_ENABLED (default; false)

DEPLOYER_MAIL_ENABLED (default; false)

DEPLOYER_REPO_BRANCH (default; master)

DEPLOYER_REPO_PROJECT_ID (default; 1)

DEPLOYER_REPO_REPOSITORY (default; git@git.domain.tld/group/project.git)

DEPLOYER_REMOTE_HOST (default; '')

DEPLOYER_REMOTE_USER (default; '')

DEPLOYER_REMOTE_PWD (optional, default; '')

DEPLOYER_REMOTE_KEY (optional, default; '')

DEPLOYER_REMOTE_KEYTEXT (optional, default; '')

DEPLOYER_REMOTE_KEYPHRASE (optional, default; '')

DEPLOYER_REMOTE_TIMEOUT (default; 120)

Webhook configuration

Contributing

Security

License

The Versions

dev-master

The Requires

by Mike de Vrind

dev-dev

The Requires

by Mike de Vrind

1.1.11

The Requires

by Mike de Vrind

1.1.10

The Requires

by Mike de Vrind

1.1.9

The Requires

by Mike de Vrind

1.1.7

The Requires

by Mike de Vrind

1.1.8

The Requires

by Mike de Vrind

1.1.6

The Requires

by Mike de Vrind

1.1.5

The Requires

by Mike de Vrind

1.1.3

The Requires

by Mike de Vrind

1.1.2

The Requires

by Mike de Vrind

1.1.1

The Requires

by Mike de Vrind

1.1.0

The Requires

by Mike de Vrind

1.0.3

The Requires

by Mike de Vrind

1.0.2

The Requires

by Mike de Vrind

1.0.1

The Requires

by Mike de Vrind

1.0

The Requires

by Mike de Vrind