luyadev / luya-deployer
This is the LUYA recipe to deploy an application with Deployer, the Deployment Tool for PHP.
Installs: 56 604
Dependents: 4
Suggesters: 0
Security: 0
Stars: 7
Watchers: 6
Forks: 6
Open Issues: 0
Type:luya-core
Requires
- deployer/deployer: ^7.0
Requires (Dev)
- luyadev/luya-testsuite: ^3.0
README
LUYA Deployer
This is the recipe to deploy your LUYA Website with PHP Deployer.
Version 3.0 of LUYA Deployer is compatible with PHP Deployer 7
Install
Add the deployer composer package to your project:
composer require luyadev/luya-deployer --dev
Create a deploy.php
file with the content of your host configuration(s) and store it in the root directory of your project:
<?php namespace Deployer; require 'vendor/luyadev/luya-deployer/luya.php'; // define your configuration here host('SSHHOST.COM') ->setLabels(['stage' => 'prod']) ->set('remote_user', 'SSHUSER') ->set('deploy_path', '~/httpdocs'); set('repository', 'https://USER:PASSWORD@github.com/VENDOR/REPO.git');
To deploy to the above configured server just go into the console and run:
./vendor/bin/dep luya prod
The LUYA Deployer will now deploy the to the above host with prod
Config. The stage()
method determines which Config ENV should be taken, therefore those values must correlate each other.
Configure Hosting
In order to run your website, you have to modify the root directory of your website to current/public_html
folder. Deployer will create the following folders:
- current
- releases
- shared
Those folders are located in your defined deploy_path
folder. So the current/public_html
should be the only directory visible by the web.
Options
Several options and can be defined with set(OPTION, VALUE)
. Its recommend to set the define the option for a given server:
host('luya.io') ->stage('prod') ->set(COMPOSER_IGNORE_PLATFORM_REQS, true) ->set('deploy_path', '~/httpdocs');
Available Options
In order to configure a branch to deploy use
set('branch', 'myCheckoutBranch');
Unglue
In order to use unglue you can add after('luya:commands', 'unglue');
in your deploy.php. This will download the unglue phar file and compile the files according to the .unglue file. You will also need to set('unglue_server', 'https://...');
to your Unglue server URL.
Authorization Password / SSH Key
Since the password()
method has been removed, authentication can either be done using SSH Keys or by entering the password while deployment. The dep luya prod
command will prompt for the users password unless he could not connect by SSH Key. By default the ~/.ssh/id_rsa
will be taken to make a first attempt. You can configure ssh settings with the following methods:
->configFile('~/.ssh/config') ->identityFile('~/.ssh/id_rsa') ->forwardAgent(true) ->multiplexing(true)
Read the PHP Deployer Docs for more informations. As we can not cover everything about SSH Keys but a here is a very basic example setup. First you have to create an SSH key, then the Server you'd like to connect must have stored the public key .pub
file. So you should never publish the private key but the public key can be stored on the Server:
- Generate an SSH Key
ssh-keygen -t rsa -b 2048 -C "luyadeployer"
- When prompting for
Enter passphrase (empty for no passphrase):
skip this step (at least when setting up an continuous deployment f.e.). - Copy the content of
~/.ssh/id_rsa.pub
which is the public key. - Add the public key to
~/.ssh/authorized_keys
on the Server or usessh-copy-id
. Also Plesk f.e. has visual tools to do so Plesk SSH Keys Extension