Laravel Envoy 为定义远程服务器的日常任务,提供了一套简洁、轻量的语法。Blade 风格语法即可实现部署任务的配置、Artisan 命令的执行等。目前,Envoy 仅支持 Mac 和 Linux 操作系统。
首先,运行 Composer 的 global require
命令进行全局安装 Envoy :
composer global require laravel/envoy
由于全局 Composer 库有时会导致包版本冲突,因此您可能希望考虑使用 cgr
,它是 composer global require
命令的直接替代品。 cgr
库的安装说明可参阅 found on GitHub 。
注意:确保将
〜/ .composer / vendor / bin
目录放在 PATH 中,以便在终端中运行envoy
命令时找到envoy
可执行文件。
您也可以使用 Composer 使您的 Envoy 安装保持最新。 使用 composer global update
命令将更新所有全局安装的 Composer 包:
composer global update
你的所有 Envoy 任务都应该在项目根目录中的 Envoy.blade.php
文件中定义。 这是一个让你入门的例子:
@servers(['web' => ['user@192.168.1.1']])
@task('foo', ['on' => 'web'])
ls -la
@endtask
如您所见,在文件顶部定义了一个 @server
数组,允许您在任务声明的 on
选项中引用这些服务器。 在你的 @ task
声明中,你应该放置在任务执行时应该在你的服务器上运行的 Bash 代码。
您可以通过将服务器的 IP 地址指定为 127.0.0.1
来强制脚本在本地运行:
@servers(['localhost' => '127.0.0.1'])
有时,您可能需要在执行 Envoy 任务之前执行一些 PHP 代码。 您可以使用 @ setup
指令声明变量,并在执行任何其他任务之前执行其他常规 PHP 工作:
@setup
$now = new DateTime();
$environment = isset($env) ? $env : "testing";
@endsetup
如果在执行任务之前需要其他 PHP 文件,可以在 Envoy.blade.php
文件的顶部使用 @include
指令:
@include('vendor/autoload.php')
@task('foo')
# ...
@endtask
您还可以导入其他 Envoy 文件,以便将 stories 和 task 添加到您的文件中。 在导入它们之后,您可以在这些文件中执行任务,就好像它们是在您自己的文件中定义的一样。你应该在你的 Envoy.blade.php
文件使用 @import
指令:
@import('package/Envoy.blade.php')
如果需要,您可以使用命令行将选项值传递到 Envoy 任务:
envoy run deploy --branch=master
您可以通过 Blade的「echo」 语法访问任务中的选项。 您也可以在任务中使用 if
语句和循环。 例如,在执行 git pull
命令之前,让我们验证 $branch
变量的存在:
@servers(['web' => '192.168.1.1'])
@task('deploy', ['on' => 'web'])
cd site
@if ($branch)
git pull origin {{ $branch }}
@endif
php artisan migrate
@endtask
Stories 将一组任务分组在一个方便的名称下,允许您将小型,集中的任务分组到大型任务中。 例如, deploy
故事可以通过在其定义中列出任务名称来运行 git
和 composer
任务:
@servers(['web' => '192.168.1.1'])
@story('deploy')
git
composer
@endstory
@task('git')
git pull origin master
@endtask
@task('composer')
composer install
@endtask
一旦编写了 story ,你可以像一个典型的任务一样运行它:
envoy run deploy
Envoy 允许您轻松跨多个服务器运行任务。 首先,在 @server
声明中添加其他服务器。 应为每个服务器分配一个唯一的名称。 定义了其他服务器后,列出任务的 on
数组中的每个服务器:
@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])
@task('deploy', ['on' => ['web-1', 'web-2']])
cd site
git pull origin {{ $branch }}
php artisan migrate
@endtask
默认情况下,将在每个服务器上串行执行任务。 换句话说,任务将在继续在第二台服务器上执行之前在第一台服务器上完成运行。 如果您想并行运行多个服务器上的任务,请在任务声明中添加 parallel
选项:
@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])
@task('deploy', ['on' => ['web-1', 'web-2'], 'parallel' => true])
cd site
git pull origin {{ $branch }}
php artisan migrate
@endtask
要运行在 Envoy.blade.php
文件中定义的任务或故事,请执行 Envoy 的 run
命令,传递您要执行的任务或故事的名称。 当任务运行时, Envoy 将运行任务并显示服务器的输出:
envoy run deploy
如果您希望在服务器上运行给定任务之前提示您进行确认,则应将 confirm
指令添加到任务声明中。 此选项对于破坏性操作特别有用:
@task('deploy', ['on' => 'web', 'confirm' => true])
cd site
git pull origin {{ $branch }}
php artisan migrate
@endtask
Envoy 还支持在执行每个任务后向 Slack 发送通知。 @slack
指令接受 Slack 钩子 URL 和通道名称。 您可以通过在 Slack 控制面板中创建 Incoming WebHooks
集成来检索您的 webhook URL 。 您应该将整个webhook URL传递给 @slack
指令:
@finished
@slack('webhook-url', '#bots')
@endfinished
你可以提供以下其中一项作为频道参数
<div class="content-list" markdown="1">
- 给频道发送通知: #channel
- 给用户发送通知: @user
</div>
Envoy 还支持在执行每项任务后向 Discord 发送通知。 @ discord
指令接受 Discord 钩子 URL 和消息。 您可以通过在 Webhook
中创建 Webhook 并选择 webhook 应发布到哪个频道来检索您的 webhook URL。 您应该将整个 Webhook URL 传递到@ discord
指令:
@finished
@discord('discord-webhook-url')
@endfinished