Déployer un projet existant __en local__.

===== Méthode de déploiement en local =====

Sous SSH, rendez-vous à la racine du répertoire dans lequel vous avez l’habitude de déployer vos projets et débuter par un **cook update** :

=== Récupérer les fichiers du projet : ===

**A.** Si projet versionné sous Git :

**B.** Si projet versionné sous SVN :

=== Récupérer la base de données : ===

**1.** Faire un //dump// de la base :

**2.** Faire un //fetch// de la base :

**3.** Le //fetch// terminé, une url va vous être communiquée. Par exemple :

**3a.** Faire un copier de cette url en prenant garde à :
– retirer tout ce qui se trouve après « <- /data/www..." qui ne fait pas partie de l'url - **BIEN RESTAURER LA BASE DANS LE PROJET LOCAL (paramètre __e:local__ de la commande) LORS DE L'EXECUTION DE LA COMMANDE QUI VA SUIVRE!!!** **3b.** Faire un coller de cette url à la suite de la commande suivante :

Par exemple : **cook manbow e:local c.db.restore:/tmp/manbow.prod/prodmanbow@10.128.0.114/prod.2012-10-08.sql.gz** === Quelques manipulations pour finir : === **1.** Définir l'url du site :

**2.** Pour les e-commerces (notamment ceux avec facettes) :

**3.** Webdeveloper toolbar : Cookies > Delete session cookies

**4.** Ne pas oublier d’ajouter votre nouveau site dans votre //host//.

===== Déployer un projet qui nécessite une clé webfactory =====

Il peut arriver que le déploiement s’arrête et que cook nous affiche une erreur du type //Unable to download : /modules/synchronizer/synchronizer-3.5.1 in local repository//.
Le projet utilise un module payant qui nécessite l’ajout d’une clé webfactory dans les settings de cook.

Les settings de cook, si ils sont identiques par défaut pour chaque projet, peuvent être surchargés pour des besoins spécifiques.
Le fichier //defaults.py// se trouve dans le répertoire :// /home/nom_du_user/projects/nom_du_projet/settings/ //.

ATTENTION : vous pouvez modifier ce fichier pour vos besoins, mais ne commitez pas vos modifications !

===== Mettre à jour les médias =====

Il est possible que le projet ait été déployé sans les médias.

Pour mettre à jour les médias sur votre projet local __depuis__ un serveur distant (demo, prod, int), utiliser c.media.rsync.__to__ :

Pour mettre à jour les médias sur un serveur distant (demo, prod, int) __depuis__ votre projet local, utiliser c.media.rsync.__from__ :

===== Troubleshooting =====

=== Si la connexion en admin est impossible ===

=== Si le site s’affiche mal (pas de css, problème d’url) ===
**1.** Vérifier le contenu du fichier //profile// se trouvant à la racine du site. Par exemple :

**2.** Se rendre à la racine du répertoire //config// de votre projet.

**3.** Repérer le fichier //project..xml//. Dans notre exemple : project.intlangf.xml.

**4.** Vérifier dans ce fichier que l’url vers votre projet est correcte.

===== Méthode de déploiement en intégration ou en production =====
(à mettre au propre choli-bô)

Depuis la branche ‘master’ :

* git st -> on vérifie d’abord que tout a bien été commité.
* git co integration/production
* git pull
* git merge master -> (où ‘master’ est la branche de travail)
* git push
* git co master -> (où ‘master’ est la branche de travail)

* cook update
* cook rbscorpo e:int/e:prod c.deploy

Effectuer un déploiement qui comprend uniquement des changements de fichiers (ne lance aucune commande Change) :
* cook rbscorpo e:int/e:prod c.deploy.dirty

Pour lancer une commande après le c.deploy.dirty (clear-webapp-cache par exemple) :
* cook rbscorpo e/int/e:prod c.cmd: »cwc »

Pour lancer plusieurs commandes après le c.deploy.dirty :
* cook rbscorpo e/int/e:prod c.cmd: »clear-all,compile-all »

cook groupauto e:int c.deploy.dirty:branch=forfait

Connexion impossible à la base de données pendant un déploiement de projet existant en local

Se connecter à mysql :

Extraction et remplissage d’une base de données

ATTENTION: veiller à créer d’abord une base de données vide sous mysql (C4_manbow dans notre exemple) !