Laravel Envoy 优雅的SSH远程任务执行工具

前言

最近公司开发框架由Thinkphp换成了Laravel,每次项目更新上线,都会先更新代码,再执行命令来确保项目运行:

  • 登录服务器,打开命令行;
  • 进入项目所在文件夹(项目根目录)cd /innfotech/www/xxx/ ;
  • 把本地代码更新为最新的 svn up;
  • 然后再执行一些命令:composer的,artisan的等

刚开始,手动做这些事情,觉得还行,久而久之, 会觉得这种方式太过麻烦,比较繁琐,还容易出现失误。所以针对这个问题,打算找一个解决方案。

Laravel Envoy 就是我找到解决方案

Laravel Envoy 为定义在远程服务器上运行的通用任务提供了一种简洁、轻便的语法。它使用了 Blade 风格的语法,让你可以很方便的启动任务来进行项目部署、Artisan 命令运行等操作。目前,Envoy 只支持 Mac 及 Linux 操作系统。

TA 允许你通过最少的配置, 只需要在本地的命令行下执行如下的一行命令:envoy run deploy,就可以把上面所有的事情都做了。

话不多说,下面开始介绍 Laravel Envoy的安装和使用!

安装

Laravel Envoy Github地址:https://github.com/laravel/envoy

Laravel Envoy 的运行需要 PHP 5.4 以上, 使用 Composer Global 安装:

安装composer

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

//将Composer配置给所有用户
composer global require "laravel/installer"

安装 Laravel Envoy

composer global require "laravel/envoy=~1.0"
微信截图_20190123164325.png

注意: 需要把 ~/.composer/vendor/bin 放到你的 PATH 里面

//将bin放入当前用户Path
echo 'export PATH=$PATH:/root/.composer/vendor/bin' >> ~/.bashrc
//导入,免登出
source ~/.bashrc
//添加larvel执行权限
chmod +x /root/.composer/vendor/laravel/installer/laravel
//添加envoy执行权限
chomp +x /root/.composer/vendor/laravel/envoy/envoy

注意:

这里需要proc_open支持所以你查看是否支持

/usr/local/php/etc/php.ini
//删除
disable_functions中
proc_open proc_status

安装完成后测试

➜ envoy --version
Laravel Envoy version 1.0.16

以后要更新的话, 只需要执行以下

composer global update 

简单使用

1.初始化并创建 deploy 任务

首先, 在你的 项目 跟目录下, 执行以下命令进行初始化

➜ envoy init vagrant@192.168.1.1(服务器IP)
Envoy file created!
微信截图_20190123164309.png

上面的命令会在此文件夹下生成一个 Envoy.blade.php 的文件, 内容如下

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

@task('deploy')
    <!--需要执行的命令-->
    cd /innfotech/www/xxx
    svn up
    composer update
    composer dump-autoload
    php artisan cache:clear
    php artisan migrate--seed
@endtask

Envoy.blade.php的语法很简单:

@servers 的数组被定义在文件的起始位置处,让你在声明任务时可以在 on 选项里参照使用这些服务器。`

@task声明里,你可以放置当任务运行时想要在远程服务器运行的 Bash 命令。

微信截图_20190123164336.png

然后运行命令:envoy run deploy就可以了

高级使用

你可以通过指定服务器的 IP 地址为 127.0.0.1 来执行本地任务:(目前,Envoy 只支持 Mac和Linux环境 )

@servers(['localhost' => '127.0.0.1'])

任务启动

有时,你可能想在任务启动前运行一些 PHP 代码。这时可以使用 @setup 区块在 Envoy 文件中声明变量以及运行普通的 PHP 程序:

@setup
    $now = new DateTime();

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

如果你想在任务执行前引入其他 PHP 文件,可以直接在 Envoy.blade.php 文件起始位置使用 @include

@include('vendor/autoload.php')

@task('foo')
    # ...
@endtask

任务变量

如果需要的话,你也可以通过命令行选项来传递变量至 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

任务宏

任务宏通过一个统一的、便捷的名字来划分一组任务,来让你把小而专的子任务合并到大的任务里。比如说,一个名为deploy 的任务宏可以在它定义范围内列出子任务名字 gitcomposer 来运行各自对应的任务:

@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

多个服务器

你可以在多个服务器上运行任务。首先,增加额外的服务器至你的 @servers 声明,每个服务器必须分配一个唯一的名称。一旦你定义好其它服务器,就能够在任务声明的 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 task

任务确认

如果你想要在运行任务之前进行提示确认,则可以增加 confirm 命令到任务声明。这个选项对于破坏性的操作来说是相当有用的:

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

通知

Slack

slack.jpg

Envoy 也支持任务执行完毕后发送通知至 Slack@slack 命令接收 Slack hook 网址和频道名称。你可以通在在 Slack 的控制面板上创建 「Incoming WebHooks」 时来检索 webhook 网址。webhook-url 参数必须是 @slack 的 Incoming WebHooks 所提供的完整网址:

@finished
    @slack('webhook-url', '#bots')
@endfinished

你可以选择下方的任意一个来作为 channel 参数:

  • 如果要发送通知至一个频道: #channel
  • 如果要发送通知给一位用户: @user
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351

推荐阅读更多精彩内容