daltcore/laravel-deploy-helper

Helper for Laravel to deploy from artisan

Thursday, October 19, 2017
by RamonSmit
Repository
5 Watchers
66 Stars
4,015 Installations

PHP
1 Dependents
0 Suggesters
4 Forks
0 Open issues
29 Versions
11 % Grown

The README.md

Laravel Deploy Helper

, _(*1)

Compatible with Laravel 5.1, 5.4 and higher., _(*2)

For Laravel 5.1 use branch 5.1 and tag v0.5.x, _(*3)

LDH is a Laravel package that helps with deploying your website without the usage of FTP.
The LDH packages uses SSH to build a deployment environment on the server for zero-downtime deployments
and rollback functionality., _(*4)

Everyone is allowed to help getting this package bigger and better! ;-), _(*5)

Install

Via Composer, _(*6)

``` bash $ composer require daltcore/laravel-deploy-helper, _(*7)


In your config/app.php
``` php
DALTCORE\LaravelDeployHelper\LdhServiceProvider::class,

Publish configuration, _(*8)

$ php artisan vendor:publish --tag=ldh-config

Usage

Deploy to server
Deploy full instance to the remote server, _(*9)

php artisan ldh:deploy --stage=production --branch=develop

Patch to server
Push a simple patch to the remote server (minor changes only), _(*10)

php artisan ldh:patch --stage=production --branch=patch

Rollback one instance
Something went horrably wrong, go back in history, _(*11)

php artisan ldh:rollback --stage=production

Configuration

stages
In the stages section you have to define your stages information., _(*12)

git
You can use git's http url with basic auth. Example: https://username:password@github.com/repo/name.git .
You can use git's ssh. Example: git@github.com:repo/name.git, _(*13)

connection
In the connection section you can add your ssh details for deploying, _(*14)

remote.root
Here you can put the root directory where LDH can set up it's directory structure, _(*15)

commands
This is a array with commands that needs to be executed from the /current directory, _(*16)

shared.directories
This is te section with directories that needs to be copied from the previous deploy to the next one, _(*17)

shared.files
The same as with the directories, but then with files., _(*18)

config.dependencies
Here you can optionally put some dependencies (applications) that you want to use for deploy.
You can use this for checking if everything on the server is setup correctly with the versions.
You may want use 'true' for no version checking, but instead just checking if the application exists., _(*19)

config.keep
How many 'shadow' copies of the old deploys needs to exist. These come in handy for the rollback feature., _(*20)

Config example:, _(*21)

<?php

return [
    'default' => [
        'stage' => 'production',
    ],

    'stages' => [
        'production' => [
            'git' => '',

            'branch' => '',

            'connection' => [
                'host'     => '',
                'username' => '',
                'password' => '',
                // 'key'       => '',
                // 'keytext'   => '',
                // 'keyphrase' => '',
                // 'agent'     => '',
                'timeout'  => 10,
            ],

            'remote' => [
                'root' => '/var/www',
            ],

            'commands' => [
                'composer install',
            ],

            'shared' => [
                'directories' => [
                    'public',
                    'storage',
                ],
                'files'       => [
                    '.env',
                ],
            ],

            'config' => [
                'dependencies' => [
                    'php' => '>=5.6',
                    'git' => true,
                ],
                'keep'         => 4,
            ],
        ],
    ],
];

Directory structure

LDH deploys the following directory structure on first deploy, _(*22)

.
├── current -> /var/www/vhosts/example.org/releases/1498833243
├── ldh.json
├── patches
│   └── 0001-Update-readme.md.patch
├── releases
│   └── 1498833243
└── shared

As you can see, LDH makes a static link from /current to /releases/1496845077.
You you only have to point your vhost to the /current/public for your Laravel website to work., _(*23)

License

, _(*24)

The Versions

19/10 2017

dev-master

9999999-dev https://github.com/daltcore/laravel-deploy-helper

Helper for Laravel to deploy from artisan

library laravel-deploy-helper

Helper for Laravel to deploy from artisan

daltcore/laravel-deploy-helper

The README.md

Laravel Deploy Helper

Install

Usage

Configuration

Directory structure

License

The Versions

dev-master

The Requires

The Development Requires

by Ramon Smit

v1.1.9

The Requires

The Development Requires

by Ramon Smit

v1.1.8

The Requires

The Development Requires

by Ramon Smit

v1.1.7

The Requires

The Development Requires

by Ramon Smit

v1.1.6

The Requires

The Development Requires

by Ramon Smit

v1.1.5

The Requires

The Development Requires

by Ramon Smit

5.1.x-dev

The Requires

The Development Requires

by Ramon Smit

v0.5.6

The Requires

The Development Requires

by Ramon Smit

v0.5.5

The Requires

The Development Requires

by Ramon Smit

v0.5.4

The Requires

The Development Requires

by Ramon Smit

v1.1.4

The Requires

The Development Requires

by Ramon Smit

v1.1.3

The Requires

The Development Requires

by Ramon Smit

v1.1.2

The Requires

The Development Requires

by Ramon Smit

v1.1.1

The Requires

The Development Requires

by Ramon Smit

v1.1.0

The Requires

by Ramon Smit

v1.0.10

The Requires

by Ramon Smit

v1.0.9

The Requires

by Ramon Smit

v1.0.8

The Requires

by Ramon Smit

v0.5.3