▶

Envoy 任務執行

介紹

Laravel Envoy 提供了簡潔，輕量的語法，定義在遠端伺服器執行的共同任務。使用 Blade 風格的語法，你可以簡單的設置部署任務，執行 Artisan 命令或是更多。

提醒: Envoy 需要 PHP 5.4 或更高的版本，並且只能在 Mac / Linux 作業系統下執行。

安裝

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

composer global require "laravel/envoy=~1.0"

記得將 ~/.composer/vendor/bin 路徑加入 PATH，如此在終端機執行 envoy 命令時才找得到。

再來，在專案根目錄建立 Envoy.blade.php 檔案。這裡有個範例可以讓你作為起頭：

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

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

如你所見，@servers 陣列建立在檔案的起始。你可以在宣告任務時，在 on 選項裡參照這些伺服器。在你的 @task 宣告裡，寫入想要在遠端伺服器執行的 Bash 程式碼。

init 命令可以簡單的建立一個基本的 Envoy 檔：

envoy init user@192.168.1.1

執行任務

使用 run 命令去執行設定的任務：

envoy run foo

如有需要，你可以傳入參數到 Envoy 檔案：

envoy run deploy --branch=master

利用你所熟悉的 Blade 語法使用這些參數：

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

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

啟動碼

你可以使用 @setup 語法，然後就能夠在 Envoy 檔案裡宣告 PHP 變數，以及執行一般的 PHP 程式碼：

@setup
	$now = new DateTime();

	$environment = isset($env) ? $env : "testing";
@endsetup

你也可以使用 @include 引入 PHP 檔案：

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

任務執行之前進行確認

如果你想要在伺服器執行你指定的任務之前進行確認，可以使用 confirm 選項：

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

多伺服器

你可以簡單的在多個伺服器執行任務。只要在任務宣告裡列出伺服器名稱：

@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

任務巨集

巨集讓你可以只要使用一個命令，就能夠循序執行一組任務。例如：

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

@macro('deploy')
	foo
	bar
@endmacro

@task('foo')
	echo "HELLO"
@endtask

@task('bar')
	echo "WORLD"
@endtask

現在 deploy 巨集可以經由一個簡單的命令執行：

envoy run deploy

提醒通知

HipChat

你可能想要在執行完任務後，發送通知到團隊的 HipChat 聊天室，使用簡單的 @hipchat 宣告：

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

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

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

你也可以自定發送到 hipchat 聊天室的訊息，任何在 @setup 裡宣告，或是經由 @include 引入的變數都可以使用在訊息裡：

@after
	@hipchat('token', 'room', 'Envoy', "$task ran on [$environment]")
@endafter

這是一個令人驚豔的簡單方式，讓你的團隊保持通知在伺服器執行的任務。

Slack

下面的語法可以發送通知到 Slack：

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

當你在 Slack 的網站建立 Incoming WebHooks 時會取得一組 webhook 的網址。hook 參數指的是 Slack 的 Incoming WebHooks 所提供的整串網址。

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

你可以為 channel 參數指定下方的其中一種：

  • 如果要發送通知至一個頻道：#channel
  • 如果要發送通知給一位使用者：@user

如果沒有指定 channel 參數，那麼就會使用預設的頻道。

注意：Slack的通知只會在所有任務都成功執行後才會送出。

更新 Envoy

如果要更新 Envoy，只需要使用 Composer：

composer global update