\nL’exemple est assez basique, mais peut servir de base pour des strat\u00e9gies de d\u00e9ploiement plus complexes.<\/p>\n
Les pr\u00e9requis \u00e9tant les suivants :<\/p>\n
- \n
- site h\u00e9berg\u00e9 sur un h\u00e9bergement avec acc\u00e8s SSH<\/li>\n<\/ul>\n
Pour mettre en place ce processus nous allons utiliser les outils suivants :<\/p>\n
- \n
- git<\/li>\n
- gilab<\/li>\n<\/ul>\n
Les \u00e9tapes \u00e0 r\u00e9aliser seront les suivantes :<\/p>\n
\n- \n
- Cr\u00e9ation du projet sur gitlab<\/a><\/li>\n
- Installation de Prestashop en local<\/a><\/li>\n
- Installation initiale de prestashop distant<\/a><\/li>\n
- Configuration gitlab et serveur<\/a><\/li>\n
- Cr\u00e9ation du fichier .gitlab-ci.yml<\/a><\/li>\n<\/ol>\n<\/div>\n
<\/a>1\/ Cr\u00e9ation du projet sur gitlab<\/strong><\/p>\n
Pour commencer il faut s’inscrire sur gitlab.com<\/a>.
\nVous pouvez ensuite cr\u00e9er votre projet en mode public ou priv\u00e9 selon vos besoins.
\nJe ne d\u00e9taille pas le processus de cr\u00e9ation qui est relativement ais\u00e9, nous reviendrons plus tard sur les configurations sp\u00e9cifiques.
\nIl est \u00e9galement possible d’h\u00e9berger sa propre plateforme gitlab, mais ce n’est pas l’objet de cet article.<\/p>\n<\/a>2\/ Installation de Prestashop en local<\/strong><\/p>\n
- \n
- T\u00e9l\u00e9charger la derni\u00e8re version 1.6.1.x<\/strong> de Prestashop depuis la page suivante : https:\/\/www.prestashop.com\/fr\/versions-developpeurs<\/a><\/li>\n
- Puis proc\u00e9der \u00e0 l’installation locale du projet<\/li>\n<\/ul>\n
Notre site de d\u00e9veloppement local \u00e9tant configur\u00e9, il est est temps de versionner le projet avec git.
\nPour cela vous pouvez ex\u00e9cuter la commande suivante dans le dossier d’installation.<\/p>\ngit init .<\/pre>\n
Pour \u00e9viter de versionner les fichiers non n\u00e9cessaires, vous pouvez ensuite mettre en place le fichier .gitignore suivant :<\/p>\n
# Editors, tools and OS's\r\n\r\n.buildpath\r\n.project\r\n.settings\r\n.idea\r\n.svn\r\n.DS_Store\r\n.sass-cache\r\nconfig.codekit\r\n*.sublime-project\r\n*.sublime-workspace\r\nnbproject\r\nbower_components\r\ncomposer.lock\r\n\r\n# Cache, temp and personal files\r\n\r\ncache\/*\r\n!cache\/index.php\r\n!cache\/*\/index.php\r\ndownload\/*\r\n!download\/index.php\r\n!download\/.htaccess\r\nimg\/*\r\n!img\/admin\/*\r\n!img\/admin\/jquery-ui\/*\r\n!img\/index.php\r\n!img\/*\/index.php\r\nlog\/*\r\n!log\/index.php\r\nupload\/*\r\n!upload\/index.php\r\n!upload\/.htaccess\r\nadmin-dev\/autoupgrade\/*\r\nadmin-dev\/backups\/*\r\nadmin-dev\/import\/*\r\n\r\nthemes\/*\/cache\/*\r\nadmin-dev\/themes\/*\/cache\/*\r\n\r\n# Config\r\n\r\nconfig\/settings.inc.php\r\nconfig\/settings.old.php\r\nconfig\/xml\/*\r\n!config\/xml\/themes\/default.xml\r\n\r\n# Themes, modules and overrides\r\nadmin-dev\/themes\/default\/sass\/ie.sass\r\nadmin-dev\/themes\/default\/sass\/print.sass\r\nadmin-dev\/themes\/default\/screen.sass\r\nadmin-dev\/themes\/default\/css\/ie.css\r\nadmin-dev\/themes\/default\/css\/print.css\r\nadmin-dev\/themes\/default\/css\/screen.css\r\n\r\n# Translations and emails templates\r\n\r\ntranslations\/*\r\n!translations\/index.php\r\n!translations\/fr\/\r\nmails\/*\r\n!mails\/fr\/\r\nthemes\/default-bootstrap\/lang\/*\r\nthemes\/default-bootstrap\/modules\/*\/translations\/*.php\r\nthemes\/default-bootstrap\/mails\/*\r\n!themes\/default-bootstrap\/mails\/en\/\r\nthemes\/default-bootstrap\/modules\/*\/mails\/*\r\n!themes\/default-bootstrap\/modules\/*\/mails\/en\r\n\r\n# MISC\r\n\r\n*sitemap.xml\r\nrobots.txt\r\n<\/pre>\n
Puis ajouter l’ensemble des fichiers au d\u00e9p\u00f4t<\/p>\n
git add .\r\ngit commit -m \"Creation du projet\"\r\n<\/pre>\n
Votre versionning local est maintenant en place, vous pouvez d\u00e9j\u00e0 d\u00e9velopper et historiser vos modifications.<\/p>\n
Pour finaliser la configuration de git nous allons ajouter notre d\u00e9p\u00f4t gitlab en d\u00e9p\u00f4t distant<\/p>\n
git remote add origin https:\/\/youruser@gitlab.com\/youruser\/your-project.git\r\n<\/pre>\n
( Note : vous pouvez ajouter l’url en https ou en ssh selon vos pr\u00e9f\u00e9rences )<\/p>\n
Poussez vos modifications sur le d\u00e9p\u00f4t distant avant de passer \u00e0 l’\u00e9tape suivante :<\/p>\n
git push origin master\r\n<\/pre>\n
<\/p>\n
<\/a>3\/ Installation initiale de prestashop distant<\/strong><\/p>\n
<\/p>\n
Apr\u00e8s avoir cr\u00e9\u00e9s le vhost et la base de donn\u00e9es n\u00e9cessaire \u00e0 l’installation du projet.
\n– Rendez-vous dans le dossier ou vous souhaitez installer le projet et clonez le depuis gitlab<\/p>\ngit clone https:\/\/youruser@gitlab.com\/youruser\/your-project.git\r\n<\/pre>\n
– Importer votre base de donn\u00e9es sur le serveur en changeant bien les urls dans la table ps_shop_url
\n– R\u00e9cup\u00e9rer votre fichier local config\/settings.inc.php et modifier le avec les informations du serveur<\/p>\nVotre serveur de prod est \u00e0 pr\u00e9sent install\u00e9, votre projet et git\u00e9.
\nIl est d\u00e9j\u00e0 possible de proc\u00e9der \u00e0 des mises \u00e0 jour assez facilement manuellement, via des git push et des git pull sur les diff\u00e9rents environnements.
\nC’est d\u00e9j\u00e0 bien mais cela n\u00e9cessite encore de se connecter en ssh au serveur pour puller les changements.
\nAvec gitlab il est possible de faire tout \u00e7a de mani\u00e8re automatique \ud83d\ude42<\/p>\n<\/p>\n
<\/a>4\/ Configuration gitlab et serveur<\/strong><\/p>\n
<\/p>\n
– Mise en place d’une deploy key<\/p>\n
Pour commencer il faut pouvoir puller les mises \u00e0 jour du serveur sans avoir de mot de passe \u00e0 saisir.
\nC’est possible avec gitlab avec le principe des deploys-keys qui se base sur une authentification ssh.<\/p>\nPour commencer il faut donc g\u00e9n\u00e9rer une cl\u00e9 ssh (sans passphrase ) sur votre serveur
\nVia la commande suivante :<\/p>\nssh-keygen -t rsa -b 4096 -C \"cle gitlab\"\r\n<\/pre>\n
Laissez ensuite les options par d\u00e9faut, et n’entrez pas de passphrase.
\nR\u00e9cup\u00e9rer le contenu de votre cl\u00e9 publique via la commande<\/p>\ncat ~\/.ssh\/id_rsa.pub\r\n<\/pre>\n
Dans gitlab rendez-vous dans \u00ab\u00a0Settings \/ Repository\u00a0\u00bb<\/p>\n
![\"Gitlab](\"https:\/\/www.h-hennes.fr\/blog\/wp-content\/uploads\/2017\/04\/gitlab-deploy-key.jpg\")
<\/p>\nDonner un titre \u00e0 votre cl\u00e9, puis copier la cl\u00e9 publique.
\nVous pouvez ensuite \u00e0 votre choix autoriser ou non l’acc\u00e8s en \u00e9criture au d\u00e9pot.<\/p>\nUne fois votre cl\u00e9 ajout\u00e9e au d\u00e9pot, vous pouvez changer l’url du remote pour prendre l’acc\u00e8s SSH<\/p>\n
git remote set-url origin git@gitlab.com:youruser\/your-project.git\r\n<\/pre>\n
Puis \u00e0 tester un git pull pour v\u00e9rifier que tout fonctionne sans saisie de mot de passe.
\nCeci devrait donner un r\u00e9sultat comme cela<\/p>\n![\"Gitlab](\"https:\/\/www.h-hennes.fr\/blog\/wp-content\/uploads\/2017\/04\/gitlab-deploy-key-ssh-result.jpg\")
<\/p>\n– Cr\u00e9ation des variables du projet<\/strong><\/p>\n
Il est temps \u00e0 pr\u00e9sent de configurer les variables n\u00e9cessaires au d\u00e9ploiement continu de votre projet.
\nPour cela rendez-vous dans \u00ab\u00a0Settings\u00a0\u00bb puis CI\/CD Pipelines\u00a0\u00bb , puis dans la partie \u00ab\u00a0Secret Variables\u00a0\u00bb<\/p>\nNous allons d\u00e9finir les variables suivantes ( \u00e0 adapter avec vos acc\u00e8s ) :<\/p>\n
SSH_HOST : (h\u00f4te de connexion ssh ) ex: herve@test.com
\nPROJECT_PATH : ( chemin du projet sur le serveur ) ex: \/var\/www\/mywebsite\/<\/p>\nSSH_KEY : ( cl\u00e9 ssh ) :
\nPour cette variable c’est un peu particulier, il va falloir autoriser le runner de d\u00e9ploiement \u00e0 se connecter \u00e0 votre serveur via ssh pour lancer les commandes de mise \u00e0 jour.
\nIl est donc n\u00e9cessaire de cr\u00e9er une cl\u00e9 ssh ( sans passphrase ) permettant l’acc\u00e8s \u00e0 votre serveur, et de coller la cl\u00e9 priv\u00e9e dans ce champ.<\/p>\nIl est possible d’utiliser des runners priv\u00e9s, mais dans notre cas nous utiliserons les runners accessibles \u00e0 l’ensemble des projets gitlab.<\/p>\n
La configuration est \u00e0 pr\u00e9sent termin\u00e9e, il est temps de voir le plus int\u00e9ressant, le fichier gitlab-ci \ud83d\ude09<\/p>\n
<\/p>\n
<\/a>5\/ Cr\u00e9ation du fichier .gitlab-ci.yml<\/strong><\/p>\n
<\/p>\n
- Puis proc\u00e9der \u00e0 l’installation locale du projet<\/li>\n<\/ul>\n
- Installation de Prestashop en local<\/a><\/li>\n
- Cr\u00e9ation du projet sur gitlab<\/a><\/li>\n
![\"Pipeline](\"https:\/\/www.h-hennes.fr\/blog\/wp-content\/uploads\/2017\/04\/pipeline-ok-gitlab.jpg\")
<\/p>\n