服務(wù) —— Envoy 任務(wù)運(yùn)行器（SSH任務(wù)）

1、簡(jiǎn)介

Laravel Envoy?為定義運(yùn)行在遠(yuǎn)程主機(jī)上的通用任務(wù)只支持Mac和Linux操作系統(tǒng)。

1.1 安裝

首先，使用Composer的global?命令安裝Envoy：

composer global require "laravel/envoy=~1.0"

確保~/.composer/vendor/bin目錄在系統(tǒng)路徑PATH中否則在終端中由于找不到envoy而無(wú)法執(zhí)行該命令。

1.1.1 更新Envoy

還可以使用Composer保持安裝的Envoy是最新版本：

composer global update

2、編寫任務(wù)

所有的Envoy任務(wù)都定義在項(xiàng)目根目錄下的Envoy.blade.php文件中，下面是一個(gè)讓你開始的示例：

@servers(['web' => 'user@192.168.1.1'])

@task('foo', ['on' => 'web'])
    ls -la
@endtask

正如你所看到的，@servers數(shù)組定義在文件頂部，從而允許你在任務(wù)聲明中使用on選項(xiàng)引用這些服務(wù)器，在?@task聲明中，應(yīng)該放置將要在服務(wù)器上運(yùn)行的Bash代碼。

啟動(dòng)

有時(shí)候，你需要在評(píng)估Envoy任務(wù)之前執(zhí)行一些PHP代碼，可以在Envoy文件中使用@setup指令來聲明變量和要執(zhí)行的PHP代碼：

@setup
    $now = new DateTime();
    $environment = isset($env) ? $env : "testing";
@endsetup

還可以使用@include來引入外部PHP文件：

@include('vendor/autoload.php');

確認(rèn)任務(wù)

如果你想要在服務(wù)器上運(yùn)行給定任務(wù)之前彈出彈出提示進(jìn)行確認(rèn)，可以在任務(wù)聲明中使用confirm指令：

@task('deploy', ['on' => 'web', 'confirm' => true])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

2.1 任務(wù)變量

如果需要的話，你可以使用命令行開關(guān)傳遞變量到Envoy文件，從而允許你自定義任務(wù)：

envoy run deploy --branch=master

你可以在任務(wù)中通過Blade的“echo”語(yǔ)法使用該選項(xiàng)：

@servers(['web' => '192.168.1.1'])

@task('deploy', ['on' => 'web'])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

2.2 多個(gè)服務(wù)器

你可以輕松地在多主機(jī)上運(yùn)行同一個(gè)任務(wù)，首先，添加額外服務(wù)器到@servers聲明，每個(gè)服務(wù)器應(yīng)該被指配一個(gè)唯一的名字。定義好服務(wù)器后，在任務(wù)聲明中簡(jiǎn)單列出所有服務(wù)器即可：

@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

默認(rèn)情況下，該任務(wù)將會(huì)依次在每個(gè)服務(wù)器上執(zhí)行，這意味著，該任務(wù)在第一臺(tái)服務(wù)器上運(yùn)行完成后才會(huì)開始在第二臺(tái)服務(wù)器運(yùn)行。

2.2.1 平行運(yùn)行

如果你想要在多個(gè)服務(wù)器上平行運(yùn)行，添加parallel選項(xiàng)到任務(wù)聲明：

@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

2.3 任務(wù)宏

宏允許你使用單個(gè)命令中定義多個(gè)依次運(yùn)行的任務(wù)。例如，deploy宏會(huì)運(yùn)行g(shù)it和composer任務(wù)：

@servers(['web' => '192.168.1.1'])

@macro('deploy')
    git
    composer
@endmacro

@task('git')
    git pull origin master
@endtask

@task('composer')
    composer install
@endtask

宏被定義好了之后，你就可以通過如下單個(gè)命令運(yùn)行它：

envoy run deploy

3、運(yùn)行任務(wù)

要從Envoy.blade.php文件中運(yùn)行一個(gè)任務(wù)，需要執(zhí)行Envoy的run命令，然后傳遞你要執(zhí)行的任務(wù)的命令名或宏。Envoy將會(huì)運(yùn)行命令并從服務(wù)打印輸出：

envoy run task

4、通知

4.1?HipChat

運(yùn)行完一個(gè)任務(wù)后，可以使用Envoy的@hipchat指令發(fā)送通知到團(tuán)隊(duì)的HipChat房間，該指令接收一個(gè)API令牌、房間名稱、和用戶名：

@servers(['web' => '192.168.1.1'])

@task('foo', ['on' => 'web'])
    ls -la
@endtask

@after
    @hipchat('token', 'room', 'Envoy')
@endafter

需要的話，你還可以傳遞自定義發(fā)送給HipChat房間的消息，所有在Envoy任務(wù)中有效的變量在構(gòu)建消息時(shí)也有效：

@after
    @hipchat('token', 'room', 'Envoy', "{$task} ran in the {$env} environment.")
@endafter

4.2?Slack

除了HipChat之外，Envoy還支持發(fā)送通知到Slack。@slack指令接收一個(gè)Slack鉤子URL、頻道名稱、和你要發(fā)送給該頻道的消息：

@after
    @slack('hook', 'channel', 'message')
@endafter

你可以通過創(chuàng)建集成到Slack網(wǎng)站的Incoming WebHooks來獲取鉤子URL，該hook參數(shù)是由?Incoming Webhooks Slack?集成提供的完整webhook URL，例如：

https://hooks.slack.com/services/ZZZZZZZZZ/YYYYYYYYY/XXXXXXXXXXXXXXX

你可以提供下面兩種其中之一作為頻道參數(shù)：

• 發(fā)送消息到頻道:?#channel
• 發(fā)送消息到用戶:?@user