Share
Si vous êtes un programmeur PHP travaillant avec le framework Laravel, je suis sûr que vous déployez votre application Web sur des serveurs cloud sur des fournisseurs tels que Linode, Digital Ocean, Vultr et les autres. En effet, avec un framework tel que Laravel, qui fonctionne étroitement avec des outils tels que Git et Composer, il est de moins en moins probable que votre application puisse être servie à partir d'un environnement d'hébergement partagé..
Cet article explique comment configurer votre serveur Web pour votre application Laravel sur un hébergement Linode en nuage à l'aide de l'outil de gestion de serveur RunCloud.io..
Vous pouvez vous inscrire pour un compte gratuit RunCloud maintenant.
Nous utiliserons Git aux côtés de la fonctionnalité Webhook de GitHub. Lorsque tout est terminé, nous pouvons simplement faire un commit et un push vers GitHub, et votre serveur sera mis à jour avec le dernier code source. RunCloud facilite la configuration de votre serveur pour pouvoir déployer votre application de cette manière, et je vais vous montrer comment le faire aujourd'hui..
Bien sûr, vous pouvez sélectionner la branche que vous souhaitez que le serveur actif détecte. Il peut s'agir du maître ou de toute autre branche que vous définissez, ce qui signifie que cette méthode de déploiement est idéale pour l'incorporation dans un flux de travail en même temps qu'un environnement de transfert et de production..
De plus, je devrais mentionner que cela ne se limite pas aux référentiels GitHub. Il fonctionnera également avec GitLab, Bitbucket et probablement n’importe quel autre service d’hébergement Git, à condition qu’ils disposent des fonctionnalités clés Webhook et Deployment..
Il convient également de mentionner que RunCloud fonctionne avec l’un des fournisseurs d’hébergement en nuage. Linode a été choisi uniquement à titre d'exemple de fournisseur d'hébergement cloud adapté.
Avant de commencer, je veux que vous sachiez que vous allez installer le serveur Web Nginx, qui fonctionne mieux avec Laravel. Cependant, RunCloud a également la possibilité d’installer le serveur Web Apache. Dans ce cas, vous pouvez tirer parti des configurations .htaccess..
Je vais sauter la partie sur l'enregistrement, car je suis sûr que vous pouvez y remédier assez rapidement et facilement..
Si vous êtes prêt, commençons.
Lorsque vous êtes connecté à votre tableau de bord sur Linode.com, il vous suffit de déployer un nouveau linode (ils appellent leur instance de service un «linode»). En bas à droite du tableau de bord, vous devriez voir un lien qui dit Ajouter une linode.
Ensuite, vous sélectionnez l’instance de linode souhaitée et le centre de données sur lequel vous voulez que votre linode soit déployé, puis cliquez sur le bouton Ajouter cette linode bouton.
A présent, vous devriez avoir un linode indiquant l’état de Étant créé.
Une fois cette opération terminée, vous aurez un serveur vide. Vous devez toujours déployer une image pour le système d'exploitation pour ce serveur. Et pour que cela fonctionne avec RunCloud plus tard, vous devez déployer un nouveau système d'exploitation Ubuntu 16.04 LTS..
Cliquez sur le nom du linode. Dans l'exemple ci-dessus, le nom est linode4362539. Cela vous amènera à la capture d'écran suivante. Il suffit de cliquer sur le lien qui dit Déployer une image.
Ici, assurez-vous de sélectionner Ubuntu 16.04 LTS comme image. Pour le reste, vous pouvez choisir la configuration que vous jugez appropriée. Pour cet espace de 20 Go et 1 Go de RAM linode, je pousse mon disque de swap au maximum, soit 512 Mo.
Entrez votre mot de passe root et conservez-le en sécurité. Vous en aurez besoin plus tard. Lorsque vous êtes prêt, cliquez sur le bouton Déployer bouton.
Maintenant, cliquez sur le Démarrage bouton pour allumer le serveur.
Vous devriez pouvoir voir que votre serveur linode n’est pas étiqueté avec Fonctionnement dans la fenêtre de droite. Essayons de vous connecter à votre serveur et voyons si cela fonctionne. Clique sur le Accès à distance languette.
dans le Accès à distance l'onglet, vous devriez pouvoir voir plus d'informations sur votre serveur, y compris les adresses IP. Copiez cette information et protégez-la. Nous en aurons bientôt besoin.
Pour vous connecter à votre serveur, vous pouvez utiliser n’importe quel client SSH que vous connaissez. Si vous êtes comme moi et que vous ne voulez pas vous écarter du navigateur, vous pouvez également utiliser un client SSH Web intégré à Linode. Faites défiler vers le bas et recherchez un lien qui dit Lancer la console.
En cliquant sur ce lien, vous exécuterez Lish, le client SSH basé sur le Web. Il suffit d'entrer racine en tant que votre nom d'utilisateur et le mot de passe que vous avez créé lors du déploiement de l'image.
Bien! Votre serveur est prêt à être configuré avec PHP, Nginx et MariaDB (et d’autres outils). C'est là que vous utiliserez RunCloud.
Si vous n'avez pas encore enregistré de compte RunCloud, vous devez le faire maintenant. Il n'y a aucun risque à essayer RunCloud rien que pour ce tutoriel, car il vous donnera un essai gratuit de cinq jours qui vous donnera un accès complet à toutes les fonctionnalités du plan Pro afin que vous puissiez les tester. Une fois la période de cinq jours écoulée, si vous n'avez pas effectué de mise à niveau, ne vous inquiétez pas, vous êtes seulement rétrogradé à leur niveau d'utilisateur gratuit. Mais à seulement 10 $ par mois pour le compte de forfait Pro, qui autorise des serveurs illimités, RunCloud est un outil plutôt cool à avoir dans votre arsenal de développeurs..
Donc, de RunCloud, nous voulons connecter notre Linode et le transformer en un serveur Web opérationnel sur Internet.
Depuis votre tableau de bord sur RunCloud, cliquez sur le bouton qui dit Connecter un serveur en haut à droite.
Entrez les informations requises sur votre serveur chez Linode. Vous pouvez revenir à votre tableau de bord Linode pour les vérifier. Mais la partie la plus importante est votre adresse IP. Assurez-vous que vous avez le droit. Sinon, le processus de connexion et l'installation échoueront.
Une fois que vous êtes prêt, cliquez sur Connecter ce serveur.
Maintenant, RunCloud vous présentera du code que vous devez exécuter sur votre serveur Linode. Il suffit de copier tout cela car nous allons l'exécuter dans la console Lish après cette opération..
Si la fenêtre Lish est toujours active, vous pouvez coller le script d'installation que vous avez précédemment copié à partir du tableau de bord RunCloud..
Collez le code du script d’installation et cliquez sur le bouton Entrer clé. Après quelques instants, lorsque vous examinerez le tableau de bord RunCloud, vous verrez que RunCloud affiche une barre de progression et des notifications indiquant la progression de l'installation lorsque RunCloud se synchronise avec le serveur. Cela signifie qu'une connexion a été faite.
Une fois l'installation terminée, le mot de passe root vous sera présenté dans votre base de données MariaDB. Assurez-vous de garder cela en sécurité. Il existe également un utilisateur MariaDB créé avec le nom d'utilisateur. runcloud.
Une fois que tout est terminé, vous pouvez revenir à votre tableau de bord RunCloud et consulter votre liste de serveurs. Vous devriez avoir une boîte avec votre nouveau serveur comme ceci.
Votre serveur Web n'a peut-être pas démarré. Cliquez sur ce serveur pour commencer à le gérer. Cette capture d'écran ci-dessous est la vue principale pour la gestion d'un serveur.
Parcourez le menu de gauche et recherchez Prestations de service.
Ici, vous pouvez activer à la fois Apache et Nginx. Plus tard, lors de la création de votre projet d’application Web, vous pouvez choisir de déployer la version de PHP avec le type de serveur Web que vous souhaitez exécuter: hybride Apache-Nginx ou Nginx natif..
Pour l'instant, activons simplement les services requis.
À ce stade, nous devrions pouvoir lancer un navigateur et entrer l'adresse IP de ce serveur. Vous devriez obtenir la page de site Web vide par défaut de RunCloud.
Maintenant que votre serveur est entièrement configuré et connecté à RunCloud, vous pouvez simplement utiliser RunCloud pour le gérer. Lors de la gestion d'un serveur à l'aide de SSH, la création d'un hôte virtuel est toujours fastidieuse. Les choses sont beaucoup plus faciles avec RunCloud.
Avant de pouvoir déployer votre projet Laravel, vous avez besoin d'un endroit où vivra l'application. Alors maintenant, vous devez créer un hôte virtuel sur votre serveur Web. Dans la nomenclature RunCloud, cela s'appelle un 'Application Web'.
Dans votre tableau de bord RunCloud, après avoir sélectionné votre serveur, recherchez le Application Web menu de la barre latérale gauche.
Maintenant, cliquez sur le Créer une application bouton.
Sur l'écran suivant, vous allez définir les configurations de votre application Web..
Ce sont les paramètres que j'ai choisis pour cela. Bien sûr, vous êtes libre de définir vos propres valeurs comme bon vous semble.
Nom de l'application Web: my-laravel-app Nom de domaine: fotofaze.me (uniquement un domaine disponible) Utilisateur: runcloud Chemin d'accès public: / public Version PHP: 7.1 Pile d'applications Web: NGINX natif
Permettez-moi de vous expliquer les valeurs qui sont définies.
Vous pouvez définir n’importe quel nom pour votre application Web en tant que référence à votre projet. En ce qui concerne le nom de domaine, définissez un nom de domaine que vous utiliserez pour le projet. Plus tard, vous pourrez définir des noms de domaine supplémentaires pour le projet. Normalement, vous voudriez que votre site Web fonctionne avec et sans le sous-domaine «www». Nous pouvons ajouter que plus tard.
Utilisateur fait référence à l'utilisateur Linux sur votre serveur. Vous pouvez créer plus d'utilisateurs si vous souhaitez affecter ce projet à un utilisateur spécifique. Et cet utilisateur particulier aura accès au serveur via SSH. Mais j'utilise simplement l'utilisateur runcloud par défaut créé lors de l'installation du serveur..
Chemin public est où se trouve votre dossier Web public. Par défaut, une application Laravel utilisera le “/Publique”Dossier pour le dossier Web accessible au public. Tous les autres dossiers sont en dehors de ce dossier. C'est pourquoi nous avons défini “/Publique" pour ça.
Je choisis la dernière version de PHP 7.1. Et enfin, pour Pile d'applications Web, Je sélectionne le NGINX natif. Une autre option est l'hybride NGINX + Apache2, qui vous permet d'accéder au fichier de configuration .htaccess. Mais je vais avec NGINX tout le chemin pour cette option.
À ce stade, votre site Web ne fonctionnera toujours pas avec votre domaine. Nous devons toujours le configurer avec le bon DNS. Faisons cela dans la section suivante.
Dans la section précédente, j'ai défini le nom de domaine de fotofaze.me. Mais je veux aussi que www.fotofaze.me fonctionne également avec cette application Web. Donc, avant de définir le DNS, faisons une étape supplémentaire dans RunCloud pour ce serveur.
Après avoir créé votre application Web, vous devriez voir le tableau de bord de votre application Web. De là, cliquez sur le Nom de domaine languette.
Nous pouvons voir que fotofaze.me est déjà répertorié. J'ai encore besoin d'ajouter www.fotofaze.me à la liste. Entrez simplement le nom de domaine et cliquez sur le bouton “Joindre un nom de domaine" bouton.
J'utilise Namecheap pour mes noms de domaine. Et l’avantage, c’est qu’il est livré avec un serveur DNS intégré. Sinon, vous devrez peut-être utiliser CloudFlare ou le service DNS de Linode. Ce que nous devons faire, c'est définir deux enregistrements DNS dans la gestion DNS. L'un est un enregistrement A et l'autre est un CNAME..
Dans ma liste de noms de domaine Namecheap, il suffit de cliquer sur le bouton Gérer bouton.
De là, je clique sur le DNS avancé languette.
Ici, quel que soit le service DNS que vous utilisez, nous devons définir les enregistrements DNS suivants:
Type: A Hôte: @ Valeur: 139.162.5.220 (adresse IP de votre serveur) Type: CNAME Hôte: www Valeur: fotofaze.me (votre nom de domaine)
Voici à quoi ressemblent mes paramètres dans Namecheap Advanced DNS.
Laissez un peu de temps pour que les modifications DNS soient résolues avant de tester votre site Web dans le navigateur. Une fois les modifications activées, vous devriez recevoir l'erreur NGINX 403 lorsque vous visitez votre site. C'est parce que votre /Publique le dossier est actuellement vide, mais il vous permet de savoir que tout fonctionne.
Une dernière partie en ce qui concerne le nom de domaine consiste à activer SSL. Cela permet à notre site Web d'être accessible à l'aide du protocole https: // sur le port 443 au lieu de http: // sur le port 80. Les avantages sont nombreux. En plus des raisons de sécurité, il est également bon pour le référencement.
Revenons au tableau de bord des applications Web My-Laravel-App et cliquez maintenant sur le bouton SSL / TLS languette. Les certificats SSL coûtaient des centaines de dollars. Mais grâce à Let's Encrypt, nous pouvons désormais déployer gratuitement des certificats SSL pour nos noms de domaine. Cela pourrait être très technique si vous ajoutiez manuellement le certificat SSL Let's Encrypt, mais avec RunCloud, c'est un jeu d'enfant en un clic..
Une fois ici, vous pouvez sélectionner Cryptons comme votre Méthode SSL. Et puis cliquez sur le Soumettre bouton.
Votre site Web devrait fonctionner avec le https: // protocole maintenant.
Parce que nous allons déployer une application Laravel, nous aurons besoin d'une base de données. Faisons cela maintenant. Parcourez le menu de gauche et cliquez sur le bouton Base de données menu.
Maintenant, cliquez sur le Créer une base de données bouton.
Entrez simplement un nom pour votre base de données et cliquez sur le bouton Ajouter une nouvelle base de données bouton.
Nous devons maintenant ajouter un utilisateur de base de données et l’affecter à notre base de données. Clique sur le Ajouter un utilisateur bouton.
Maintenant, entrez simplement un nom d'utilisateur et un mot de passe. Et puis cliquez sur le Ajouter bouton.
Ensuite, nous affectons le nouvel utilisateur à la base de données créée précédemment. Cliquez sur le petit Attacher un utilisateur icône sur votre liste de base de données.
Comme vous n’avez qu’un seul utilisateur pour le moment, assurez-vous qu’il est bien sélectionné puis cliquez sur le bouton Attacher bouton.
Une fois cela fait, c'est ce que vous verrez. le laraveluser est maintenant attaché à la Laravelapp base de données.
Nous sommes maintenant sur le point de faire de la programmation PHP avec Laravel. Mais avant cela, créons un référentiel de projet GitHub dans lequel nous pourrons plus tard pousser notre code source.
Un développeur web solo doit normalement gérer trois emplacements où réside son code source:
Dans cette partie du didacticiel, nous allons créer notre référentiel de projet sur GitHub. Plus tard, nous utiliserons ce référentiel pour transférer le travail de notre environnement de développement sur notre ordinateur local vers ce référentiel de projet GitHub spécifique..
Sur GitHub, si vous êtes connecté, vous pouvez cliquer sur le petit plus (+) sur le côté droit de la barre supérieure. Et vous devriez voir un menu pour Nouveau référentiel. Cliquez dessus.
Entrez simplement les détails de votre projet avec quelque chose comme ci-dessous. Cliquez sur le bouton vert qui dit Créer un référentiel.
Vous devriez avoir une vue comme celle-ci maintenant.
La zone surlignée en rouge correspond à l'adresse du référentiel de votre projet sur GitHub. Nous en aurons besoin plus tard lors de la configuration de la représentation à distance du projet à partir de notre ordinateur de développement local..
Nous sommes maintenant prêts à commencer le développement sur notre ordinateur local et à transmettre le code à GitHub..
Dans cette partie du didacticiel, nous allons configurer notre ordinateur local avec notre version de développement de notre projet Laravel. Plus tard, nous chargerons cela sur un service d’hébergement Git (nous utiliserons GitHub). Après cela, nous demanderons à notre serveur Linode de récupérer du code auprès de GitHub afin que notre serveur de production déploie toujours le dernier code source..
En guise de remarque, ce tutoriel ignore la partie relative à la configuration de votre compte GitHub avec votre clé publique SSH pour une communication sécurisée. Nous utiliserons beaucoup l'écran du terminal pour SSH. J'utilise normalement Putty sous Windows.
Si vous débutez dans GitHub, vous pouvez consulter le didacticiel sur la génération et la configuration de votre ordinateur local avec une clé SSH à utiliser avec GitHub..
La gestion du déploiement de Git sur votre serveur live peut facilement être configurée avec RunCloud. Une fois que tout est configuré, avec un simple push Git depuis votre ordinateur local, vous pouvez toujours être sûr que votre serveur récupérera automatiquement ces mises à jour. Pas de FTP, plus d'instructions de ligne de commande.
Le moyen le plus simple de démarrer un projet Laravel est d'utiliser Composer. Si vous ne connaissez pas Composer, assurez-vous de lire et d'installer le logiciel sur votre ordinateur local. Le compositeur n'est pas juste pour Laravel. Composer simplifiera la gestion des bibliothèques et des dépendances pour tout projet PHP. Son utilisation est considérée comme essentielle au développement d'applications PHP modernes..
Ouvrez votre outil de terminal préféré et exécutez la commande suivante pour créer un projet Laravel.
$ composer create-project --prefer-dist laravel / laravel my-laravel
Cela peut prendre un certain temps, car Composer télécharge et installe Laravel sur votre ordinateur. Le compositeur créera un dossier appelé mon-laravel et tout stocker là-bas. D'abord, allons dans ce dossier.
$ cd my-laravel
Pour vous assurer que votre application Laravel fonctionne correctement, vous devez configurer vos paramètres de connexion à la base de données. Vous pouvez le faire en modifiant le .env fichier. Utilisez n'importe quel éditeur de texte que vous connaissez et modifiez ce fichier. Voici ce qu'un typique .env le fichier contiendrait. Vous pouvez le mettre à jour selon vos propres besoins.
APP_NAME = Laravel APP_ENV = local APP_KEY = APP_DEBUG = true APP_LOG_LEVEL = débogage APP_URL = http: // localhost DB_CONNECTION = mysql DB_HOST = 127.0.0.1 DB_PORT = 3306 DB_DATABASE = homestead DB_USERNAME
Retour à l'outil de ligne de commande, créons d'abord une clé pour cette application laravel. Entrez la commande suivante dans le terminal. La commande suivante mettra à jour le fichier .env avec une clé de hachage.
$ clé artisan php: générer
Maintenant initialisons-le pour le suivi Git.
$ git init $ git add --all $ git commit -m "premier commit"
Peut-être que je devrais aussi expliquer un peu le .gitignore fichier qui vient avec Laravel. Vous pouvez consulter ce fichier et voir quels fichiers ne sont pas suivis. Par exemple, .env qui stocke vos informations de connexion à la base de données ne sont pas suivies. Cela signifie que vous utiliserez différentes méthodes. .env fichiers pour votre ordinateur local et pour votre serveur live.
Dans la section précédente, j'ai parlé de l'adresse de votre référentiel Git distant sur GitHub. Exécutez la commande ci-dessous avec votre propre adresse..
$ git remote ajouter l'origine [email protected]: kidino / my-laravel.git
Ensuite, nous dirons à notre projet Git local où se trouve notre projet sur GitHub. Pour cela, nous devons ajouter une représentation du référentiel distant.
$ git push -u origine master
Si vous le faites bien, votre projet sur GitHub aurait dû être mis à jour avec quelque chose comme ça. Si vous rencontrez des problèmes, Git n'est peut-être pas configuré correctement sur votre ordinateur ou vous n'avez pas généré votre clé SSH locale..
Consultez le site Web de GitHub pour vous aider avec cela.
Nous pouvons maintenant commencer à configurer le déploiement automatique à l'aide de points d'ancrage et de déclencheurs Web. Une fois que nous avons cela, votre code sera automatiquement envoyé à votre serveur via RunCloud chaque fois que vous transmettez votre travail à GitHub..
Pour ce faire, nous devons d’abord générer une clé de déploiement via le panneau de RunCloud. Depuis le panneau de votre serveur, dans le menu de gauche, vous devriez pouvoir trouver un menu intitulé Clé de déploiement.
Vous devriez déjà en avoir un pour l'utilisateur runcloud. Si vous vous en souvenez, lorsque nous avons créé l'application Web, nous avons mentionné que l'utilisateur est runcloud.
Cliquez sur la petite icône pour afficher la clé SSH de cet utilisateur. Si vous obtenez quelque chose comme cela, cela signifie qu'une clé SSH n'a jamais été créée pour cet utilisateur par le passé. Cliquez D'accord afin qu'une nouvelle clé SSH soit créée.
Une fois que tout est en ordre, une mise en page comme celle-ci vous sera présentée. C'est la clé SSH que vous devez entrer dans GitHub. Grâce à cela, GitHub peut reconnaître les demandes d'extraction lorsque le serveur souhaite extraire de nouvelles mises à jour. Tout copier.
Maintenant passons à GitHub.
Allez dans votre projet et cliquez sur l'onglet qui dit Réglages. Puis cliquez sur le Déployer des clés menu dans la barre latérale gauche.
Comme vous n’avez peut-être pas encore de clé, cliquez simplement sur le bouton Ajouter la clé de déploiement bouton.
Donnez-lui simplement un nom et vous pourrez ensuite entrer votre clé de déploiement SSH que nous avons obtenue de RunCloud. Clique le Ajouter une clé bouton.
Nous allons ensuite configurer un déclencheur Web Hook. Un point d'ancrage Web GitHub fonctionne comme ceci: chaque fois que nous envoyons de nouvelles mises à jour à GitHub, nous pouvons demander à GitHub d'avertir les autres services ou serveurs de ce nouveau transfert. Dans ce cas, nous dirons à GitHub d'avertir notre serveur en direct. Et cela peut facilement être fait via RunCloud.
Dans RunCloud, ouvrez votre application Web que vous avez créée précédemment. Et cliquez sur l'onglet intitulé Git.
Faites défiler la liste et entrez les détails de votre référentiel sur GitHub. Voici à quoi ressemble le projet que nous avons réalisé dans ce didacticiel. Vous pouvez définir votre propre branche pour un déploiement en direct si vous ne voulez pas qu'elle soit maîtresse. Mais pour cet exemple, nous allons rester avec maître.
En d'autres termes, lorsque vous transmettez votre branche principale à GitHub, le serveur actif prend cela pour signifier la mise à jour du code source sur le serveur. Il fera ensuite un pull de la branche master et se mettra à jour.
Si vous êtes prêt, cliquez sur le bouton intitulé Attacher un référentiel Git.
Ceci est la vue que vous obtenez lorsque vous avez mis à jour votre application Web avec un déploiement Git.
Vous pouvez voir maintenant que vous avez une URL Git WebHook. Ceci est l'URL que nous allons copier et mettre dans GitHub.
Avant cela, personnalisons notre script de déploiement sur notre serveur..
Le script de déploiement est le script bash que vous pouvez utiliser pour demander à votre serveur de faire certaines choses avant ou après l'extraction de GIT. Si vous utilisez Laravel, vous saurez que Laravel dépend fortement de la commande artisan et du compositeur pour faciliter votre développement et votre déploiement..
Pour modifier le script de déploiement, faites défiler jusqu'au script de déploiement GIT dans l'onglet GIT de l'application Web. Ici, vous pouvez ajouter votre propre script à exécuter. Assurez-vous d'inclure le git pull quelque part dans votre script de déploiement. Vous pouvez écrire le script avec Replacer pour une utilisation simplifiée.
Ci-dessous le script que j'utilise.
$ git merge $ composer dump-autoload -o $ composer installer $ php artisan migrate --force $ php artisan vue-compilée $ php artisan vue: clear $ php config artisan: configuration $ php artisan optimiser - composeur dump-autoload -o $ file d'attente artisan php: redémarrer
Vous pouvez utiliser ce même script. Cochez la case et cliquez sur le bouton sauvegarder bouton.
Maintenant remontez. Nous avons toujours besoin de mettre notre URL Git Webhook dans GitHub.
Copiez cette URL, puis nous passerons à GitHub. Dans GitHub, accédez au référentiel de votre projet. Puis cliquez sur le Réglages languette. Puis sur le Webhooks menu de la barre latérale. Et puis sur le Ajouter Webhook bouton.
Collez simplement l'URL Git WebHook que nous avons obtenue de RunCloud dans le champ de texte URL de charge utile. Assurez-vous de sélectionner application / json pour Type de contenu. Cela devrait suffire. Puis cliquez sur le Ajouter Webhook bouton.
Accentsconagua