Download the PHP package qualitycode/phing-deploy without Composer

README

Deploy permets :

• la création d'un package pour le déploiement
• le déploiement d'un package
• l'analyse statique du code

Il permet de gérer :

• plusieurs projets
• plusieurs environnements de déploiement
• plusieurs serveurs par environnement

Pré-requis

Serveur de déploiement

• php >= 5.3
• php-ssh
• git
• composer
• installer la clef publique du serveur de déploiement sur les différents serveurs où l'on doit déployer
• ajouter la clef publique du serveur de déploiement sur bitbucket et github

Fichiers de configuration du projet

Les fichiers de configuration du projet doivent être disponible pour chacun des environnements de déploiement.

Par exemple pour parameters.yml => parameters.yml.production

Fonctionnement

Deploy task

1. En local
   1. création du répertoire de release
   2. clonage du repository
   3. récupération du dernier tag de la branche configurée si il y a des tags ou récupération du tag passé en paramètre
   4. récupération de composer.phar
   5. copie des fichiers de configuration spécifique à l'environnement
   6. composer install
   7. exécution de la tache "package" du build.xml du projet
   8. création d'un package (fichier tgz)
2. Sur le(s) serveur(s) distant(s)
   1. création des répertoires du projet
   2. copie du package
   3. création du répertoire pour le déploiement
   4. décompression du package
   5. installation des cron
   6. exécution de la tache "deploy" du build.xml du projet
   7. mise à jour du lien current
   8. nettoyage des anciens déploiement

Installation

That's all !

Utilisation

• ./vendor/bin/phing help => Display this message
• ./vendor/bin/phing prepare -Dproject.name=test -Dstage.name=production => Prepare server
• ./vendor/bin/phing rollback -Dproject.name=test -Dstage.name=production => Rollback to previous deployment
• ./vendor/bin/phing package -Dproject.name=test -Dstage.name=production -Drepository.tag=1.0 => Application packaging
• ./vendor/bin/phing deploy -Dproject.name=test -Dstage.name=production -Drepository.tag=1.0 => Application deployment
• ./vendor/bin/phing qa -Dproject.name=test -Dstage.name=production -Drepository.tag=1.0 => Run qa tools
• ./vendor/bin/phing deploy-with-qa -Dproject.name=test -Dstage.name=production -Drepository.tag=1.0 => Run qa tools and deployment tasks

Si le projet est un bundle ou une library, le deployement n'a pas de sens, penser à mettre deploy.enable à false dans le fichier de configuration du projet.

Structure

Projet

Release

Remote

Taches spécifiques au projet

S'il y a besoin d'exécuter des taches spécifiques au projet, il suffit de placer un fichier phing build.xml à sa racine avec 3 targets :

• pre-package => avant la création de l'archive (par exemple : minification js et css)
• post-package => après la création du package (par exemple : versionning du package, envoie d'un mail)
• pre-deploy => avant le déploiement
• post-deploy => après le déploiement
• pre-rollback => avant le rollback
• post-rollback => après le rollback

Si la tache a besoin d'être éxécutée sur le serveur, il faut passer par la target deploy.tool.ssh

Mise en place de cron

Dans le projet mettre les cron dans :

Les chemins des scripts dans les fichiers cron doivent être précédé par .

Configuration

Paramètres et leur emplacement conseillé :

properties/build.properties

properties/project/project_name.properties

properties/stage/stage_name.properties

properties/stage/stage_name/project_name.properties

Vous pouvez surcharger ici tous les paramètres