Este documento describe el uso de DeployerPHP para automatizar el despliegue de aplicaciones Symfony. DeployerPHP es una herramienta que permite configurar tareas para actualizar el código, instalar dependencias, compilar assets y más, de forma atómica y con rollbacks. Incluye recetas predefinidas para Symfony que automatizan tareas comunes como instalar vendors, limpiar caché y enlazar symlinks. El documento explica cómo configurar servidores, crear tareas personalizadas y utilizar funciones y variables para personalizar el pro

1. Despliegue de
aplicaciones Symfony
con DeployerPHP

2. Patrocinadores

3. SOY ÁLEX MARTÍN
Hago deploys y otras #mandangas todos los días en @innn
Puedes contactar conmigo en @alexdw

4. ¿QUÉ ES UN
DEPLOY?

5. Software deployment is all
of the activities that make a
software system available
for use.
https://en.wikipedia.org/wiki/Software_deployment

6. DEPLOY === COÑAZO

7. Es una tarea repetitiva…
y aburrida
➔ Subir ficheros
➔ Setear configuración
➔ Bajar dependencias
➔ Realizar migraciones de datos
➔ Construir assets
➔ Limpiar caché
➔ Reiniciar servidores
➔ ...

8. Traducido a
Symfony…
➔ git pull
➔ upload parameters.yml
➔ composer install
➔ doctrine:migrations
➔ assets:install && assetic:dump
➔ cache:clear
➔ apache2 reload // nginx reload
➔ ...

9. ¿CÓMO PODEMOS
AUTOMATIZARLO?

10. HERRAMIENTAS
Capistrano Magallanes
DeployerPHP

11. HERRAMIENTAS
Capistrano Magallanes
DeployerPHP

12. DeployerPHP

13. Principales
características
Rápido Modular Rollbacks Atómico

14. Principales
características

15. Instalación
global
wget http://deployer.org/deployer.phar
mv deployer.phar /usr/local/bin/dep
chmod +x /usr/local/bin/dep

16. Instalación
en vendors
php composer.phar require deployer/deployer:~3.0

17. Configuración
básica
// deploy.php
<?php
require 'recipe/symfony.php';
server('prod', 'host', 22)
->user('name')
->forwardAgent()
->stage('production')
->env('deploy_path', '/your/project/path');
set('repository', 'git@github.com:org/app.git');

18. dep deploy prod

19. |-- current → /home/www/releases/20140812131123
|-- releases
| `-- 20140812131123
| `-- 20140809150234
| `-- 20140801145678
`-- shared
Resultado

20. dep rollback prod
¿Algún error?

21. ENTREMOS EN
DETALLE …

22. Configuración
servidores
server('prod_1', 'domain.com')
->user('user')
->password('pass')
->env('deploy_path', '/home/www')
->stage('production');
server('prod_2', 'domain.com')
->user('user')
->password('pass')
->env('deploy_path', '/home/www')
->stage('production');

23. Configuración
servidores (tipos de conexión)
➔ Usuario y contraseña
server(...)
->user('user')
->password('pass')

24. Configuración
servidores (tipos de conexión)
➔ Usuario y contraseña
server(...)
->user('user')
->password('pass')
➔ Usuario y solicitud de contraseña
server(...)
->user('user')
->password(null)

25. Configuración
servidores (tipos de conexión)
➔ Usuario y contraseña
server(...)
->user('user')
->password('pass')
➔ Usuario y solicitud de contraseña
server(...)
->user('user')
->password(null)
➔ Con clave privada
server(...)
->user('name')
->identityFile();

26. Configuración
servidores (tipos de conexión)
➔ Con PEM file
server('ec2', 'host.aws.amazon.com')
->user('ec2-user')
->pemFile('~/.ssh/keys.pem');

27. Configuración
servidores (tipos de conexión)
➔ Con PEM file
server('ec2', 'host.aws.amazon.com')
->user('ec2-user')
->pemFile('~/.ssh/keys.pem');
➔ Con SSH config file
server(...)
->user('name')
->configFile('/path/to/file');

28. Configuración
servidores (con YAML)
➔ serverList('servers.yml');

29. Configuración
servidores (con YAML)
➔ serverList('servers.yml');
➔ prod:
host: domain.com
user: www
identity_file: ~
stage: production
deploy_path: /home/www/
beta:
host: beta.domain.com
user: www
password: pass
stage: beta
deploy_path: /home/www/

30. Tareas
DeployerPHP
➔ Sistema basado en tareas

31. Tareas
DeployerPHP
➔ Sistema basado en tareas
➔ Estas tareas pueden anidarse

32. Tareas
DeployerPHP
➔ Sistema basado en tareas
➔ Estas tareas pueden anidarse:
task('deploy', [
'deploy:prepare',
'deploy:update_code',
'deploy:vendors',
'deploy:symlink',
'cleanup'
]);

33. Creación de
tareas
➔ task('my_test_task', function () {
//
})->desc('Doing my stuff')->onlyOn('test');

34. Creación de
tareas
➔ task('my_test_task', function () {
//
})->desc('Doing my stuff')->onlyOn('test');
➔ dep my_test_task

35. Creación de
tareas
➔ task('my_test_task', function () {
//
})->desc('Doing my stuff')->onlyOn('test');
➔ dep my_test_task
➔ dep list

36. Creación de
Tareas (variables)
➔ Variables entorno
task('my_test_task', function () {
env('key');
env('key', 'value');
env('array.key');
});

37. Creación de
Tareas (variables)
➔ Variables entorno
task('my_test_task', function () {
env('key');
env('key', 'value');
env('array.key');
});
➔ Variables globales
set('key', 'value');
get('key');
has('key');

38. Creación de
Tareas (variables predefinidas)
➔ Definir repositorio
set('repository', 'git@github.com:user/project.git');

39. Creación de
Tareas (variables predefinidas)
➔ Definir repositorio
set('repository', 'git@github.com:user/project.git');
➔ Rama repositorio
set('branch','master');

40. Creación de
Tareas (variables predefinidas)
➔ Definir repositorio
set('repository', 'git@github.com:user/project.git');
➔ Rama repositorio
set('branch','master');
➔ Definir compartidos
set('shared_dirs', ['app/logs']);
set('shared_files', ['app/config/parameters.yml']);

41. Creación de
Tareas (variables predefinidas)
➔ Definir repositorio
set('repository', 'git@github.com:user/project.git');
➔ Rama repositorio
set('branch','master');
➔ Definir compartidos
set('shared_dirs', ['app/logs']);
set('shared_files', ['app/config/parameters.yml']);
➔ Permisos de escritura
set('writable_dirs', ['app/cache', 'app/logs']);
set('http_user', 'user');

42. Creación de
Tareas (variables predefinidas)
➔ Copiar directorios
set('copy_dirs', ['vendor']);
before('deploy:vendors', 'deploy:copy_dirs');

43. Creación de
Tareas (variables predefinidas)
➔ Copiar directorios
set('copy_dirs', ['vendor']);
before('deploy:vendors', 'deploy:copy_dirs');
➔ Versiones a mantener
set('keep_releases', 5);

44. Creación de
Tareas (variables predefinidas)
➔ Copiar directorios
set('copy_dirs', ['vendor']);
before('deploy:vendors', 'deploy:copy_dirs');
➔ Versiones a mantener
set('keep_releases', 5);
➔ Definir ruta composer
set('composer_command', '/bin/composer.phar');

45. Creación de
Tareas (funciones)
➔ Ejecutar en servidor
run(string $command)

46. Creación de
Tareas (funciones)
➔ Ejecutar en servidor
run(string $command)
➔ Ejecutar en local
runLocally(string $command, int $timeout = 60)

47. Creación de
Tareas (funciones)
➔ Ejecutar en servidor
run(string $command)
➔ Ejecutar en local
runLocally(string $command, int $timeout = 60)
➔ Navegar en servidor
cd(string $path)

48. Creación de
Tareas (funciones)
➔ Ejecutar en servidor
run(string $command)
➔ Ejecutar en local
runLocally(string $command, int $timeout = 60)
➔ Navegar en servidor
cd(string $path)
➔ Subir al servidor
upload($file, $uploadFile)

49. Creación de
Tareas (funciones)
➔ Ejecutar en servidor
run(string $command)
➔ Ejecutar en local
runLocally(string $command, int $timeout = 60)
➔ Navegar en servidor
cd(string $path)
➔ Subir al servidor
upload($file, $uploadFile)
➔ Descargar del servidor
download($localFile, $deploymentFile);

50. Creación de
Tareas (funciones)
➔ Escribir en consola
write($message)

51. Creación de
Tareas (funciones)
➔ Escribir en consola
write($message)
<info>...</info>
<comment></comment>
<error></error>

52. Creación de
Tareas (funciones)
➔ Escribir en consola
write($message)
<info>...</info>
<comment></comment>
<error></error>
➔ Escribir en una nueva línea
writeln($message)

53. Creación de
Tareas (funciones)
➔ Escribir en consola
write($message)
<info>...</info>
<comment></comment>
<error></error>
➔ Escribir en una nueva línea
writeln($message)
➔ Interacción con usuario
ask($message, $default)
askConfirmation($message[,$default = false])
askHiddenResponse(string $message)

54. Creación de
Tareas (funciones)
➔ Escribir en consola
write($message)
<info>...</info>
<comment></comment>
<error></error>
➔ Escribir en una nueva línea
writeln($message)
➔ Interacción con usuario
ask($message, $default)
askConfirmation($message[,$default = false])
askHiddenResponse(string $message)
set('upload_parameters',
askConfirmation('¿Subir el parameters?'));

55. Creación de
Tareas (hooks)
➔ After
task('deploy:done', function () {
write('Deploy done!');
});
after('deploy', 'deploy:done');

56. Creación de
Tareas (hooks)
➔ After
task('deploy:done', function () {
write('Deploy done!');
});
after('deploy', 'deploy:done');
➔ Before
task('deploy:init, function () {
write('Begin deploy!');
});
before('deploy', 'deploy:done');

57. Tareas
predefinidas (Recipes)
➔ CacheTool
Permite borrar cache APC / OPCACHE

58. Tareas
predefinidas (Recipes)
➔ CacheTool
Permite borrar cache APC / OPCACHE
➔ Local
Permite realizar deploys locales

59. Tareas
predefinidas (Recipes)
➔ CacheTool
Permite borrar cache APC / OPCACHE
➔ Local
Permite realizar deploys locales
➔ Newrelic
Notifica a newrelic de un nuevo deploy

60. Tareas
predefinidas (Recipes)
➔ CacheTool
Permite borrar cache APC / OPCACHE
➔ Local
Permite realizar deploys locales
➔ Newrelic
Notifica a newrelic de un nuevo deploy
➔ Rabbit
Permite mandar notificación a RabbitMQ

61. Tareas
predefinidas (Recipes)
➔ CacheTool
Permite borrar cache APC / OPCACHE
➔ Local
Permite realizar deploys locales
➔ Newrelic
Notifica a newrelic de un nuevo deploy
➔ Rabbit
Permite mandar notificación a RabbitMQ
➔ Rsync
Permite copiar ficheros mediante Rsync

62. Tareas
predefinidas (Recipes)
➔ Slack
Permite mandar notificación a Slack

63. Tareas
predefinidas (Recipes)
➔ Slack
Permite mandar notificación a Slack
➔ Configure
Permite configurar un vhost

64. Tareas
predefinidas (Recipes)
➔ Slack
Permite mandar notificación a Slack
➔ Configure
Permite configurar un vhost
➔ Hipchat
Permite mandar un mensaje a una sala de hipchat

65. Otros
recipes
➔ Symfony
➔ Symfony3
➔ Laravel
➔ CakePHP
➔ Codeigniter
➔ Yii
➔ …

66. Recipes
Symfony
➔ Definir assets
set('assets', ['web/css','web/images','web/js']);

67. Recipes
Symfony
➔ Definir assets
set('assets', ['web/css','web/images','web/js']);
➔ Definir carpetas var y bin
set('bin_dir', 'app'); //Symfony2
set('var_dir', 'app'); // Symfony2
set('bin_dir', 'bin'); //Symfony3
set('var_dir', 'var'); // Symfony3

68. Recipes
Symfony
➔ Definir assets
set('assets', ['web/css','web/images','web/js']);
➔ Definir carpetas var y bin
set('bin_dir', 'app'); //Symfony2
set('var_dir', 'app'); // Symfony2
set('bin_dir', 'bin'); //Symfony3
set('var_dir', 'var'); // Symfony3
➔ Compilar assets
set('dump_assets', true); //Symfony2

69. Recipes
Symfony
➔ Variables de entorno
env('env_vars, 'SYMFONY_ENV=prod');
env('env, 'prod');

70. Recipes
Symfony
➔ Variables de entorno
env('env_vars, 'SYMFONY_ENV=prod');
env('env, 'prod');
➔ Tarea principal
task('deploy', [
'deploy:prepare',
'deploy:release,
'deploy:update_code',
'deploy:create_cache_dir,
'deploy:shared,
'deploy:assets,
'deploy:vendors',
'deploy:assetic:dump,
'deploy:cache:warmup,
'deploy:writable',
'deploy:symlink',
'cleanup'
]);

72. ¿PREGUNTAS?
¿CERVEZAS?
Puedes encontrarme en
@alexdw
alex@alexdw.com