Comment puis-je utiliser Laravel Envoy ou Déploieur avec Semaphoreci?

Les plats clés

• Semaphoreci, un service continu d'intégration et de livraison, peut être utilisé conjointement avec Laravel Envoy ou déploieur pour automatiser le processus de déploiement après des tests réussis.
• Des outils de déploiement tels que Laravel Envoy et Deployeur peuvent être configurés pour travailler avec Semaphoreci en définissant des serveurs et en créant des tâches pour gérer le processus de déploiement. La stratégie de déploiement peut être configurée sur la page du projet dans Semaphoreci, avec l'option de déploiement automatique ou manuel.
• Le processus d'intégration et de déploiement est déclenché en commettant des modifications dans le référentiel. Si des problèmes surviennent, Semaphoreci offre la possibilité d'afficher les journaux et d'étudier le problème. Il offre également l'option de SSH dans le serveur de construction pour un dépannage supplémentaire.

Cet article a été révisé par des pairs par Wern Ancheta et Viraj Khatavkar. Merci à tous les pairs examinateurs de SitePoint pour avoir fait du contenu SitePoint le meilleur possible!

---

L'automatisation des tests, l'intégration continue et la livraison continue sont très répandues dans la communauté maintenant. Cela a donné vie à plusieurs services en essayant de rendre le processus plus agréable et moins écrasant pour les développeurs, afin qu'ils puissent se concentrer sur la livraison de logiciels au lieu de créer / configurer des outils pour ce faire. L'un de ces services est Semaphoreci.

Dans cet article, nous allons couvrir comment utiliser nos propres scripts et outils de déploiement pour poursuivre le processus de déploiement après un test réussi.

Nous utiliserons Semaphoreci pour une livraison continue et un déploieur pour pousser notre code vers le serveur de production DigitalOcean. Si vous n'êtes pas familier avec le déploieur, nous vous recommandons de consulter cette introduction.

Application de démonstration

Nous utiliserons une application 500px qui charge les photos du marché. Il a été construit à l'aide de Laravel et vous pouvez lire l'article complet sur son processus de construction ici, et trouver le repo sur github.

Création d'un script de déploieur

La façon dont le déploiement fonctionne est en définissant les serveurs, puis en créant des tâches qui gèrent le processus de déploiement de l'application sur ces serveurs. Notre script Deploy.php ressemble à ceci:

<span><span><?php </span></span><span>
</span><span><span>require_once "recipe/common.php";
</span></span><span>
</span><span><span>set('ssh_type', 'native');
</span></span><span><span>set('default_stage', 'staging');
</span></span><span><span>env('deploy_path', '/var/www');
</span></span><span><span>env('composer_options', 'install --no-dev --prefer-dist --optimize-autoloader --no-progress --no-interaction');
</span></span><span><span>set('copy_dirs', [
</span></span><span>    <span>'app/commands',
</span></span><span>    <span>'app/config',
</span></span><span>    <span>'app/controllers',
</span></span><span>    <span>'app/database',
</span></span><span>    <span>'app/lang',
</span></span><span>    <span>'app/models',
</span></span><span>    <span>'app/src',
</span></span><span>    <span>'app/start',
</span></span><span>    <span>'app/tests',
</span></span><span>    <span>'app/views',
</span></span><span>    <span>'app/filters.php',
</span></span><span>    <span>'app/routes.php',
</span></span><span>    <span>'bootstrap',
</span></span><span>    <span>'public',
</span></span><span>    <span>'composer.json',
</span></span><span>    <span>'composer.lock',
</span></span><span>    <span>'artisan',
</span></span><span>    <span>'.env',
</span></span><span><span>]);
</span></span><span>
</span><span><span>set('shared_dirs', [
</span></span><span>    <span>'app/storage/cache',
</span></span><span>    <span>'app/storage/logs',
</span></span><span>    <span>'app/storage/meta',
</span></span><span>    <span>'app/storage/sessions',
</span></span><span>    <span>'app/storage/views',
</span></span><span><span>]);
</span></span><span><span>set('writable_dirs', get('shared_dirs'));
</span></span><span><span>set('http_user', 'www-data');
</span></span><span>
</span><span><span>server('digitalocean', '174.138.78.215')
</span></span><span>    <span>->identityFile()
</span></span><span>    <span>->user('root')
</span></span><span>    <span>->stage('staging');
</span></span><span>
</span><span><span>task('deploy:upload', function() {
</span></span><span>    <span>$files = get('copy_dirs');
</span></span><span>    <span>$releasePath = env('release_path');
</span></span><span>
</span><span>    <span>foreach ($files as $file)
</span></span><span>    <span>{
</span></span><span>        <span>upload($file, "<span><span>{$releasePath}</span>/<span>{$file}</span>"</span>);
</span></span><span>    <span>}
</span></span><span><span>});
</span></span><span>
</span><span><span>task('deploy:staging', [
</span></span><span>    <span>'deploy:prepare',
</span></span><span>    <span>'deploy:release',
</span></span><span>    <span>'deploy:upload',
</span></span><span>    <span>'deploy:shared',
</span></span><span>    <span>'deploy:writable',
</span></span><span>    <span>'deploy:symlink',
</span></span><span>    <span>'deploy:vendors',
</span></span><span>    <span>'current',// print current release number
</span></span><span><span>])->desc('Deploy application to staging.');
</span></span><span>
</span><span><span>after('deploy:staging', 'success');
</span></span></span>

Vous devez lire l'article de déploiement si vous souhaitez en savoir plus sur ce que fait ce script spécifique. Notre prochaine étape consiste à créer un projet Semaphoreci. Veuillez lire l'article du cours intensif si vous n'avez jamais essayé Semaphoreci auparavant, et faites cela.

Configuration du déploiement

Pour configurer la stratégie de déploiement, nous devons aller sur la page du projet et cliquer sur Configurer le déploiement.

Ensuite, nous sélectionnons l'option de déploiement générique, de sorte que Semaphoreci nous donne la liberté d'ajouter la configuration manuelle.

Après avoir sélectionné le déploiement automatique, Semaphoreci nous donnera la possibilité de spécifier les commandes de déploiement. La différence entre manuelle et automatique est que le déploiement automatique est déclenché après chaque test réussi, tandis que le manuel nous permettra de déployer tout engagement réussi.

Nous pouvons choisir d'inclure le deployeur.phar dans notre référentiel en tant que fichier phar ou l'exiger à l'aide du compositeur. Quoi qu'il en soit, les commandes seront similaires.

Si nous avons choisi de déployer l'application à l'aide de SSH, Semaphoreci nous donne la possibilité de stocker notre clé privée SSH sur leurs serveurs et de la rendre disponible dans la phase de déploiement.

Remarque: Semaphoreci recommande de créer une nouvelle clé SSH spécifiquement pour le processus de déploiement. Au cas où quelqu'un a volé nos clés ou quelque chose, nous pouvons facilement le révoquer. La clé sera également cryptée avant de la stocker de leur côté.

La clé sera disponible sous ~ / .ssh / id_rsa, de sorte que l'identité () peut être laissée par défaut.

Push to Deploy

Maintenant que tout est configuré, nous devons commettre des modifications au référentiel pour déclencher le processus d'intégration et de déploiement.

<span><span><?php </span></span><span>
</span><span><span>require_once "recipe/common.php";
</span></span><span>
</span><span><span>set('ssh_type', 'native');
</span></span><span><span>set('default_stage', 'staging');
</span></span><span><span>env('deploy_path', '/var/www');
</span></span><span><span>env('composer_options', 'install --no-dev --prefer-dist --optimize-autoloader --no-progress --no-interaction');
</span></span><span><span>set('copy_dirs', [
</span></span><span>    <span>'app/commands',
</span></span><span>    <span>'app/config',
</span></span><span>    <span>'app/controllers',
</span></span><span>    <span>'app/database',
</span></span><span>    <span>'app/lang',
</span></span><span>    <span>'app/models',
</span></span><span>    <span>'app/src',
</span></span><span>    <span>'app/start',
</span></span><span>    <span>'app/tests',
</span></span><span>    <span>'app/views',
</span></span><span>    <span>'app/filters.php',
</span></span><span>    <span>'app/routes.php',
</span></span><span>    <span>'bootstrap',
</span></span><span>    <span>'public',
</span></span><span>    <span>'composer.json',
</span></span><span>    <span>'composer.lock',
</span></span><span>    <span>'artisan',
</span></span><span>    <span>'.env',
</span></span><span><span>]);
</span></span><span>
</span><span><span>set('shared_dirs', [
</span></span><span>    <span>'app/storage/cache',
</span></span><span>    <span>'app/storage/logs',
</span></span><span>    <span>'app/storage/meta',
</span></span><span>    <span>'app/storage/sessions',
</span></span><span>    <span>'app/storage/views',
</span></span><span><span>]);
</span></span><span><span>set('writable_dirs', get('shared_dirs'));
</span></span><span><span>set('http_user', 'www-data');
</span></span><span>
</span><span><span>server('digitalocean', '174.138.78.215')
</span></span><span>    <span>->identityFile()
</span></span><span>    <span>->user('root')
</span></span><span>    <span>->stage('staging');
</span></span><span>
</span><span><span>task('deploy:upload', function() {
</span></span><span>    <span>$files = get('copy_dirs');
</span></span><span>    <span>$releasePath = env('release_path');
</span></span><span>
</span><span>    <span>foreach ($files as $file)
</span></span><span>    <span>{
</span></span><span>        <span>upload($file, "<span><span>{$releasePath}</span>/<span>{$file}</span>"</span>);
</span></span><span>    <span>}
</span></span><span><span>});
</span></span><span>
</span><span><span>task('deploy:staging', [
</span></span><span>    <span>'deploy:prepare',
</span></span><span>    <span>'deploy:release',
</span></span><span>    <span>'deploy:upload',
</span></span><span>    <span>'deploy:shared',
</span></span><span>    <span>'deploy:writable',
</span></span><span>    <span>'deploy:symlink',
</span></span><span>    <span>'deploy:vendors',
</span></span><span>    <span>'current',// print current release number
</span></span><span><span>])->desc('Deploy application to staging.');
</span></span><span>
</span><span><span>after('deploy:staging', 'success');
</span></span></span>

Si quelque chose se passe mal, nous pouvons cliquer sur le processus de déploiement échoué et voir les journaux pour étudier le problème davantage.

La capture d'écran ci-dessus est un engagement raté en raison de la commande compilée claire artisan-PHP renvoyant une erreur car l'extension McRypt n'a pas été activée.

Remarque: une autre astuce soignée que Semaphoreci fournit est de SSHing au serveur de construction pour voir ce qui s'est mal passé.

Autres outils de déploiement

Le même processus que nous avons utilisé ici peut être appliqué à tout autre outil de déploiement. Laravel Envoy, par exemple, pourrait être configuré comme ceci:

// Edit something
<span>git add .
</span><span>git commit -am "Updated deploy"
</span><span>git push origin master
</span>

et dans l'étape de commande de déploiement, nous installons et exécutrions envoyé:

@servers(['web' => 'root@ip-address'])

@task('deploy', ['on' => 'web'])
cd /var/www

@if($new) {{-- If this is the first deployment --}}
git init
git remote add origin repo@github.git
@endif

git reset --hard
git pull origin master

composer update
composer dumpautoload -o

@if($new)
    chmod -R 755 storage
    php artisan storage:link
    php artisan key:generate
@endif

php artisan migrate --force

php artisan config:clear
php artisan route:clear

php artisan optimize
php artisan config:cache
php artisan route:cache
php artisan view:clear
@endtask

c'est tout! Envoy va maintenant s'authentifier avec la clé que nous avons ajoutée et exécuter la commande de mise à jour que nous avons spécifiée.

Conclusion

Les outils

CI / CD sont une grande amélioration pour le flux de travail d'un développeur et aident certainement les équipes à intégrer un nouveau code dans les systèmes de production. Semaphoreci est un excellent choix que je recommande pour son interface facile à utiliser et son merveilleux support. Si vous avez des commentaires ou des questions, veuillez les poster ci-dessous!

Questions fréquemment posées (FAQ) sur Laravel Envoy, Déploieur et Semaphoreci

Comment puis-je intégrer Laravel Envoy avec Semaphoreci pour une intégration continue?

L'intégration de Laravel Envoy à Semaphoreci implique quelques étapes. Tout d'abord, vous devez configurer votre projet Laravel sur Semaphoreci. Après cela, vous devez installer Envoy dans votre projet à l'aide de Composer. Une fois installé, vous pouvez créer un fichier Envoy.blade.php dans votre répertoire racine de projet. Ce fichier contiendra toutes les tâches que vous souhaitez automatiser. Ensuite, vous pouvez ajouter une nouvelle commande dans votre pipeline Semaphoreci pour exécuter les tâches envoyées. La commande ressemblera à ceci: PHP Vendor / Bin / Envoy Exécuter le déploiement.

Quels sont les avantages de l'utilisation du déploiement avec Laravel?

Le déploieur est un outil de déploiement écrit en PHP, c'est simple , fonctionnel et parfait pour les applications PHP comme Laravel. Il fournit une prise en charge prête à l'emploi pour Laravel, ce qui signifie que vous n'avez pas à rédiger des scripts personnalisés pour déployer vos applications Laravel. Le déploieur s'occupe de toutes les tâches de déploiement, telles que la réalisation du dernier code de votre référentiel, l'exécution de l'installation du compositeur, l'exécution de migrations et le redémarrage de PHP-FPM. Il prend également en charge les déploiements de temps nul, les déploiements atomiques et les déploiements parallèles, ce qui peut réduire considérablement votre temps de déploiement.

Comment puis-je utiliser GitLab CI / CD avec Laravel et Envoy?

Pour utiliser GitLab GitLab CI / CD avec Laravel et Envoy, vous devez créer un fichier .gitLab-ci.yml dans votre répertoire racine de projet. Ce fichier définira les étapes de votre pipeline CI / CD. Vous pouvez définir une étape pour tester votre application, une étape de création de votre application et une étape de déploiement de votre application. Dans l'étape de déploiement, vous pouvez utiliser Envoy pour automatiser les tâches de déploiement. Il vous suffit d'ajouter un script dans votre fichier .gitlab-ci.yml pour exécuter les tâches envoyées, comme ceci: script: php fournisseur / bin / envoyé exécuter le déploiement.

Comment puis-je configurer correctement Laravel pour CI / Cd?

Configuration de Laravel pour CI / CD consiste à configurer votre environnement de test, à rédiger des tests pour votre application, à configurer votre processus de création et à configurer votre processus de déploiement. Vous pouvez utiliser PHPUnit pour les tests, le compositeur pour la gestion des dépendances et des outils tels que Laravel Envoy ou Déploieur pour automatiser les tâches de déploiement. Vous devez également choisir une plate-forme CI / CD, comme Semaphoreci ou GitLab CI / CD, et le configurer pour exécuter vos tests, créer votre application et déployer votre application.

Comment puis-je déployer une application Laravel avec CI / CD et Envoy?

Déployer une application Laravel avec CI / CD et Envoy implique la configuration d'un pipeline CI / CD qui comprend une étape de déploiement. À ce stade, vous pouvez utiliser Envoy pour automatiser les tâches de déploiement. Il vous suffit de créer un fichier Envoy.blade.php dans le répertoire racine de votre projet et définir vos tâches dans ce fichier. Ensuite, vous pouvez ajouter une commande dans votre pipeline CI / CD pour exécuter les tâches envoyées. La commande ressemblera à ceci: les fournisseurs / bac / envoyés de PHP déploient.

Quel est le rôle de Semaphoreci dans le déploiement de Laravel?

Semaphoreci est une plate-forme d'intégration et de livraison continue qui peut automatiser Le processus de test et de déploiement de vos applications Laravel. Vous pouvez configurer un pipeline dans Semaphoreci pour exécuter vos tests, créer votre application et déployer votre application. Semaphoreci prend en charge un large éventail de langages et de cadres, y compris PHP et Laravel, et il s'intègre à de nombreux outils populaires, comme Laravel Envoy and Deployeur.

Comment puis-je utiliser Laravel Envoy pour le déploiement?

Laravel Envoy vous permet de définir des tâches dans une syntaxe de lame et de les exécuter sur vos serveurs distants. Pour utiliser Envoy pour le déploiement, vous devez l'installer dans votre projet à l'aide de Composer. Ensuite, vous pouvez créer un fichier Envoy.blade.php dans le répertoire racine de votre projet et définir vos tâches de déploiement dans ce fichier. Une fois vos tâches définies, vous pouvez les exécuter à l'aide de la commande Envoy Run.

Comment puis-je utiliser le déploieur pour le déploiement de Laravel?

Le déploiement est un outil de déploiement PHP qui fournit hors du temps - Prise en charge de la boîte pour Laravel. Pour utiliser le déploieur pour le déploiement de Laravel, vous devez l'installer dans votre projet à l'aide de Composer. Ensuite, vous pouvez créer un fichier deploy.php dans le répertoire racine de votre projet et définir vos tâches de déploiement dans ce fichier. Une fois vos tâches définies, vous pouvez les exécuter à l'aide de la commande DEP Deploy.

Quelles sont les différences entre Laravel Envoy et Deployeur?

Laravel Envoy et Deployeur sont tous deux des outils de déploiement PHP, mais ils avoir quelques différences. Envoy utilise une syntaxe de lame pour définir des tâches, tandis que Deployeur utilise une syntaxe PHP. Envoy est plus spécifique à Laravel, tandis que Deployeur prend en charge de nombreux cadres différents. Envoy est plus simple et plus facile à utiliser, mais le déploieur offre des fonctionnalités plus avancées, comme les déploiements en temps zéro-bas, les déploiements atomiques et les déploiements parallèles.

Puis-je utiliser à la fois Laravel Envoy and Deployeur dans le même projet?

Oui, vous pouvez utiliser à la fois Laravel Envoy et déploier dans le même projet. Cependant, il n'est généralement pas nécessaire d'utiliser les deux outils, car ils servent des fins similaires. Vous pouvez choisir celui qui correspond le mieux à vos besoins. Si vous préférez un outil plus simple avec une syntaxe de lame, vous pouvez choisir Envoy. Si vous préférez un outil plus avancé avec la prise en charge de nombreux frameworks différents, vous pouvez choisir le déploieur.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!