🚀 Déployer sur Heroku

Aujourd’hui, tu es capable de réaliser entièrement une application web. Tu utilises le design pattern MVC, tu sais développer la partie back-end, la partie front-end et accéder aux données d’une base MySQL !

Cependant, quel intérêt de savoir faire tout cela si tes applications restent uniquement accessible en local, sur ton propre pc ?

Objectifs

• Créer un compte et configurer Heroku en distant
• Préparer son repository pour Heroku
• Mettre en place le déploiement automatique via github

Le déploiement

Les terme déployer ou mise en production sont utilisés pour désigner le fait qu’une application va être accessible par d’autres utilisateurs que toi. Il existe plusieurs façons de déployer une application web. C’est souvent un choix de l’entreprise dans laquelle tu travailleras en tant que développeur et même si ces tâches sont parfois dédiées aux DevOps, c’est important d’être capable de déployer toi-même tes applications.

Lorsque tu mets en production, tu ne fais que copier ton application sur un serveur, qui est en réalité une machine physique guère différente de ton ordinateur de développement. Sur ce serveur, il faut installer les mêmes outils (PHP, un serveur HTTP, MySQL, composer, git, etc.). Il existe plusieurs catégories de serveurs. Tu peux gérer toi même une machine qui servira de serveur, mais la plupart du temps ce serveurs sont “loués” chez des hébergeurs (OVH, online.net,...) qui assurent un maximum de sécurité, disponibilité et débit.

Cette quête va permettre de déployer ton application sur la plateforme Heroku. La quête que tu vas suivre va te permettre d’utiliser un moyen de déploiement pour tes applications : Heroku.

Heroku est ce que l'on appelle une PAAS (Platform As A Service). C’est un type d'hébergement dit de "cloud computing". Il qui permet de donner accès à un serveur configurable simplement pour y installer des applications. Le PAAS s’occupe de la maintenance des outils liés au serveur et l’utilisateur (toi dans ce cas) s’occupe de la maintenance de son application.

Heroku est rapide et simple à mettre en place pour une application développées dans un grand nombre de langages, dont PHP. Tu n’auras pas besoin d’installer manuellement PHP, mySQL, PDO, Composer, etc. !

Tu uUtiliseras la version gratuite de Herokud’Heroku. Tu le devineras, elle comporte moins d’avantages que la version payante mais elle fait l’affaire pour tester une application en ligne. Les inconvénients sont les suivants :

• Si aucun utilisateur ne vient sur l’application pendant 30 mns, l’application sera reconstruite. Le temps de chargement de la page pourrait alors prendre environ 15 secondes pour le nouvel utilisateur.

• Si besoin de données persistantes (par exemple un système d’upload d’images), il faudra utiliser en parallèle un autre service tel que AWS S3 (ce n’est pas abordé dans cette quête) pour gérer ces données persistantes

Avant de démarrer cette quête, note que si tu as l’intention de connecter ton projet à une base de données mySQL, tu devras utiliser le module "ClearDB" de ClearDB,' Heroku qui te demandera un numéro de carte bleue (qui ne sera pas prélevée si tu conserves la version gratuite).

Heroku peut être configuré via son interface graphique en ligne ou via la ligne de commandes en installant Heroku en local. Pour cette quête, tu utiliseras l’interface graphique.

Objectifs

• Créer un compte et configurer Heroku en distant

• Préparer son repository pour Heroku

• Mettre en place le déploiement automatique via github

Etapes

Prépare ton repository pour Heroku

Le but de cette quête est de déployer une application web réalisée à partir du simple-mvc sur Heroku. Lorsque tu souhaiteras déployer un autre type de projet (Symfony par exemple), le processus sera en grande partie le même.

Pour cette première étape, tu peux utiliser un projet réalisé à partir du simple-mvc que tu aurais déjà versionné sur Github. Sinon, créé un nouveau projet à partir du simple-mvc.

Pour qu’il fonctionne avec Heroku, créé un fichier Procfile à la racine de ton projet dans lequel il faut écrire uniquement cette ligne :

web: vendor/bin/heroku-php-apache2 public/

Ceci va permettre d’indiquer où se trouve l’index de ton application.

Push ensuite tes modifications sur ton repository distant.

CréeCréé ton compte sur Heroku

Pour commencer, rends toi sur https://www.heroku.com/ et créé un compte utilisateur.

Une fois sur le dashboard, clique sur “create a new app”

N’ajoute pas de pipeline dans cet exemple. Note simplement que la pipeline pourra être ajoutée si tu souhaites mettre en place des outils d’intégration continue.

Une fois l’application créée, tu arrives directement sur l’onglet “Deploy”. Sélectionne “Github”.

Puis clique sur “Connect to Github”.

Tu pourras ensuite directement rechercher le repository que tu souhaites déployer :

Clique ensuite sur “Connect” Heroku te proposera automatiquement de mettre en place le déploiement automatique. Choisis la branche que tu souhaites déployer et clique sur “Enable Automatic Deploys”

Maintenant que ceci est fait, ton application sera déployée automatiquement à chaque fois que tu réaliseras un push sur la branche sélectionnée !

Tu peux vérifier que le déploiement automatique fonctionne de la façon suivante :

• Modifie index.php en ajoutant ceci juste après <?php :

die('Hello world');

• Commit et push ces modifications sur github.

• Au même moment, observe l’onglet “Activity” sur ton compte Heroku. Tu constateras que le déploiement se fait. Tu peux aussi cliquer sur “Build progress” et tu te rendras compte que Heroku comprend par lui même, par exemple, qu’il faut jouer la commande composer install !

Tu peux également forcer un déploiement manuel en cliquant simplement sur “Deploy branch” en bas de l’onglet “deploy”.

Une fois déployé, rends toi sur l’URL distante de ton application. S’il est écrit “Hello world”, c’est que le déploiement a bien fonctionné ! Il te reste une étape : connecter une base de données à ton projet !

Connecter une base de données à un projet Heroku

PLa méthode à utiliser pour installer une base de données MySQL, tu vas est d’ajouter un add-on Heroku gratuit. Tu pourrais bien sur à la place utiliser une base de données distante qui seraitest configurée pour accepter d’être utilisée par un autre serveur.

Sur Heroku, rends toi dans l’onglet “Resources” Sous Add-ons, recherche “mysql” puis sélectionne ClearDB MySQLMySQLl. Pour la version gratuite, sélectionne “Ignite - Free”. Si tu ne l’as pas déjà fait, il te sera demandé un numéro de carte bleue.

Une fois l’addon installé, tu asavons besoin des identifiants pour s’yte connecter. Tu peux les récupérer en te rendant dans l’onglet “Settings” puis en cliquant sur “Reveal Config Vars”. Ceci affichera les variables d’environnement

Récupère la valeur de CLEARDB_DATABASE_URL qui est construite de la manière suivante :

mysql://user:password@host/dbname?reconnect=true

Maintenant que tu disposes de ces informations, tu vas les ajouter à la suite comme dans l’exemple suivant :

Il s’agit tout simplement de configurer les variables d’environnement comme tu avais l’habitude de le faire dans config/db.php de simple-mvc. La seule différence est que tu as ajouté une autre variable d’environnement qui correspond à l’environnement.

Si tu utilise le simple-mvc vierge et que tu retires le die(‘hello world’), tu peux constater que maintenant, ton application fonctionne et l’index affiche “Hello wilders” car il n’a pas rencontré d’erreur (et a donc réussi à se connecter à la base de données). Il te reste maintenant à importer ta base de données. Pour cela, tu peux utiliser mysql-workbench en indiquant les données de connexions comme dans cet exemple :

Puis si tu utilises le simple-mvc, importer les tables grâce au fichier sql fourni

Si tu test l’ajout d’un nouvel item, ne soit pas étonné par les ids insérés dans ta base, ils s’incrémentent ici de 10 en 10 au lieu de 1 en 1 comme tu en as l’habitude

Challenge

Déplois ton premier projet sur heroku !

En suivant cette quête, déplois ton propre projet. Tu peux partir d’un simple-mvc vierge ou d’un projet existant (ton hackathon, un projet 2, un projet perso etc)

Poste ensuite l’adresse de ton projet pour valider ce challenge !

Critères de validation

• Le lien vers le projet fonctionne
• L’url est construite de la façon suivante : https://nom-du-projet.herokuapp.com
• Si le simple-mvc a été utilisé, la route /item/index affiche bien une liste d’items