lanvige (Lanvige Jiang)

Rails Variants Tips

lanvige — Thu, 11 Sep 2014 20:04:13 +0800

原贴 http://lanvige.github.io/2014/09/11/rails-variants-tips/

现在 Web 界流行一个新词Responsive Web Design，目的就是让一套网页在不同的设备上都能展现内容，像 BootStrap 这样的主流框架也都对其进行支持，很是方便，但有时不同设备上要求是不同的，可以说是完全不同的样式，在开发过程中仍需要使用不同的模板来渲染。

Image source:

提到不同模板，在 Rails 中，普遍的方案是加入一个新的 Mime，为这种 Mime 建一个 Template Engine。示例：RailsCasts #199 Mobile Devices。

Action Pack Variants

Rails 4.1 中推出了一个新功能 Action Pack Variants，主要就是简化多设备上的模板问题。

具体用法

#抄自 release notes

# You can set the variant in a before_action:
request.variant = :tablet if request.user_agent =~ /iPad/

#Respond to variants in the action just like you respond to formats:
respond_to do |format|
  format.html do |html|
    html.tablet # renders app/views/projects/show.html+tablet.erb
    html.phone { extra_setup; render ... }
  end
end

# Provide separate templates for each format and variant:

app/views/projects/show.html.erb
app/views/projects/show.html+tablet.erb
app/views/projects/show.html+phone.erb
You can also simplify the variants definition using the inline syntax:

respond_to do |format|
  format.js         { render "trash" }
  format.html.phone { redirect_to progress_path }
  format.html.none  { render "trash" }
end

Tip 1 判断浏览器类型

判断浏览器是一件很烦的事情，好在有很多地方都已经写好可以借用：如ruby-china。

不过这里要推荐的是一个 gem，叫作browser

gem 'browser'

然后就可以享受到多如牛毛的判断，更多看 github 页面。

browser.name 
browser.mobile?
browser.tablet?
browser.firefox?
browser.ie?
browser.ie6?

Tip 2 参数指定浏览器类型

通过手机，模拟器可以看到效果，但调试起来却不方便，在 Chrome 中安装 Agnet Simulate 是个好办法，但... RailsCast 中给出了一个通过 params 来改变状态的方法，这里依然实用。

def mobile_device?
  session[:mobile_override] = params[:mobile] if params[:mobile]
  if session[:mobile_override]
    session[:mobile_override] == '1'
  else
    browser.mobile?
  end
end

通过 params mobile=1 来强制设定浏览器类型，然后将其存到 session 中，即可以方便的调试。

Tip 3 Devise 等如何使用

上面示例中，把判断设备的代码放在了 application_controller.rb 中，但如果在像 devise 中如何使用 Variants 呢？

因为 devise 的自定义类中，会继承class RegistrationsController < ::Devise::RegistrationsController，而非 application_controller.rb，所以判断方法无法在这里使用。

第一个方案是，在自定义类中重写一变判断方法，Too Sha too kill...

第二种，可以使用Concerns

# controllers/concerns/detect_format_variant.rb
module DetectFormatVariant
  extend ActiveSupport::Concern

  included do
    before_filter :set_device_type
  end

  private

  ## Mobile device
  # detect_device
  # 用Rails 4.1中的variants来进行设备匹配
  def set_device_type
    session[:mobile_override] = params[:mobile] if params[:mobile]
    if mobile_device?
      request.variant = :phone
    end
  end

  def mobile_device?
    if session[:mobile_override]
      session[:mobile_override] == '1'
    else
      browser.mobile?
    end
  end
end

在需要进行判断的 controller 中加入

# Base controller
class ApplicationController < ActionController::Base
  include DetectFormatVariant
end

# Devise
class RegistrationsController < ::Devise::RegistrationsController
  include DetectFormatVariant
end

REF::

如果想深入了解 Variants，可以看看这篇： http://ryanbigg.com/2009/04/how-rails-works-2-mime-types-respond_to/

Sidekiq 精通 36 分钟

lanvige — Thu, 12 Jun 2014 08:02:39 +0800

原贴 http://lanvige.github.io/2014/06/10/sidekiq-in-rails/

Image modify from whitepages

http://sidekiq.org/
https://github.com/mperham/sidekiq
http://railscasts.com/episodes/366-sidekiq

阅读前需要了解 Redis、Background Job 等概念，本文自动化部署使用的是 Capistrano 3。

Rails 中配置 Sidekiq

$ gem install sidekiq

# Installing connection_pool 2.0.0
# Installing redis 3.0.7
# Installing redis-namespace 1.4.1
# Installing sidekiq 3.1.3

将 Redis 的配置信息放到 Rails 4 中的secrets.yml中：

redis: &redis
   redis_server: 'localhost'
   redis_port: 6379
   redis_db_num: 0
   redis_namespace: 'highlander_sidekiq'


development:
  <<: *redis

在initializers下新建sidekiq.rb文件，用来初始化 Redis 和 Sidekiq config

redis_server = Rails.application.secrets.redis_server
redis_port = Rails.application.secrets.redis_port
redis_db_num = Rails.application.secrets.redis_db_num
redis_namespace = Rails.application.secrets.redis_namespace


Sidekiq.configure_server do |config|
  p redis_server
  config.redis = { url: "redis://#{redis_server}:#{redis_port}/#{redis_db_num}", namespace: redis_namespace }
end

Sidekiq.configure_client do |config|
  config.redis = { url: "redis://#{redis_server}:#{redis_port}/#{redis_db_num}", namespace: redis_namespace }
end

sidekiq 配置参数

命令后加上 --help 可以看到其配置参数：

$ bundle exec sidekiq --help
    -c, --concurrency INT            processor threads to use
    -d, --daemon                     Daemonize process
    -e, --environment ENV            Application environment
    -g, --tag TAG                    Process tag for procline
    -i, --index INT                  unique process index on this machine
    -q, --queue QUEUE[,WEIGHT]       Queues to process with optional weights
    -r, --require [PATH|DIR]         Location of Rails application with workers or file to require
    -t, --timeout NUM                Shutdown timeout
    -v, --verbose                    Print more verbose output
    -C, --config PATH                path to YAML config file
    -L, --logfile PATH               path to writable logfile
    -P, --pidfile PATH               path to pidfile
    -V, --version                    Print version and exit
    -h, --help                       Show help

Queues 的用法

可以通过 linux cli 的方式，使用添数来启动 sidekiq: bundle exec sidekiq -q queue_name_1,queue_name_2，也可以将这些参数放到 yml 中，通过 -C 参数来启动 bundle exec sidekiq -C config/sidekiq.yml

sidekiq 启动配置文件

:concurrency: 5
:pidfile: tmp/pids/sidekiq.pid

:queues:
    - default
    - [myqueue, 2]

development:
  :concurrency: 5
staging:
  :concurrency: 10
production:
  :concurrency: 20

Worker

class SmsWorker
  include Sidekiq::Worker

  def perform(name, count)
    # do something
    p name
  end
end

Run

配置好这些东西，就可以对刚才写的 SmsWorker 进行测试了。

首先，要启动 Sidekiq:

$ bundle exec sidekiq -C config/sidekiq.yml                                                   ✘

"localhost"
2014-06-10T05:08:07Z 36163 TID-ox8pyjylc INFO: Booting Sidekiq 3.1.3 with redis options {:url=>"redis://localhost:6379/0", :namespace=>"highlander_sidekiq"}

         s
        ss
   sss  sss         ss
   s  sss s   ssss sss   ____  _     _      _    _
   s     sssss ssss     / ___|(_) __| | ___| | _(_) __ _
  s         sss         \___ \| |/ _` |/ _ \ |/ / |/ _` |
  s sssss  s             ___) | | (_| |  __/   <| | (_| |
  ss    s  s            |____/|_|\__,_|\___|_|\_\_|\__, |
  s     s s                                           |_|
        s s
       sss
       sss

在另一个 Term 中使用 Rails Console 进行测试

$ rails c

# 调用perform
SmsWorker.perform_async 'Hello World', 0

就可以在 sidekiq 的调试窗口中看到输出了。

Deploy with Capistrano

添加 gem capistrano-sidekiq添加到 Rails Project

gem 'capistrano-sidekiq' , group: :development

然后，项目中运行'cap -vT'，可以看到添加下面这些有关 sidekiq 的命令。

cap sidekiq:quiet                  # Quiet sidekiq (stop processing new tasks)
cap sidekiq:respawn                # Respawn missing sidekiq proccesses
cap sidekiq:restart                # Restart sidekiq
cap sidekiq:rolling_restart        # Rolling-restart sidekiq
cap sidekiq:start                  # Start sidekiq
cap sidekiq:stop                   # Stop sidekiq

(x)Cap 2.x 中可以配置 cmd 来选择 sidekiq.yml 进行启动，但 Cap 3.x 中就只能过配在 stage 下纯代码的方式来配置 (x)，后来问了下作者，sidekiq_config 就是用来在 3.x 中使用 yml 来启动的：

以下为 cap-sidekiq 的参数配置和其默认值：

:sidekiq_default_hooks =>  true
:sidekiq_pid =>  File.join(shared_path, 'tmp', 'pids', 'sidekiq.pid')
:sidekiq_env =>  fetch(:rack_env, fetch(:rails_env, fetch(:stage)))
:sidekiq_log =>  File.join(shared_path, 'log', 'sidekiq.log')
:sidekiq_options =>  nil
:sidekiq_require => nil
:sidekiq_tag => nil
:sidekiq_config => nil
:sidekiq_queue => nil
:sidekiq_timeout =>  10
:sidekiq_role =>  :app
:sidekiq_processes =>  1
:sidekiq_concurrency => nil

sidekiq_default_hooks 是 capistrano-sidekiq 提供的默认的 hooks，在 cap 的指定 task 前后指行相应的 task，如发布前关闭 sidekiq，发布完后启动 Sidekiq。具体见代码。如果不需要，可以设置该值为 false，即可关闭。

Rails 中的 Cap 配置示例：

示例如下，在 stage 中配置 concurrency pool size 和 named queue 的值

## sidekiq
set :sidekiq_concurrency, 10
set :sidekiq_queue, ['client_sms,2', 'client_emails,5', 'default,3', 'foo']

## or use config.yml file
set :sidekiq_config, "#{current_path}/config/sidekiq.yml"

会启动如下命令：

RBENV_ROOT=~/.rbenv RBENV_VERSION=2.1.2 ~/.rbenv/bin/rbenv exec bundle exec sidekiq --index 0 --pidfile /home/ares/apps/highlander/shared/tmp/pids/sidekiq.pid --environment production --logfile /home/ares/apps/highlander/shared/log/sidekiq.log --queue sms, notification --concurrency 10 --daemon

这里有一个问题，我第一天使用时，花了半天去调试，发现是'set pry'的问题 Not started sidekiq after deploy - if pty is true。

当初忘记为什么，在 deploy.rb 中设置 pry 为 true 了，只好在 production stage 的配置中，设置回来。

set :pty, false

进程监控

# 查看sidekiq进程
$ ps aux | grep sidekiq

使用自带的监控页面

gem 'sinatra'

require 'sidekiq/web'
mount Sidekiq::Web => '/sidekiq'

这样，就可以在页面上看到 sidekiq 的运行情况了。更多详情见：sidekiq Monitoring

REF::

http://railscasts.com/episodes/366-sidekiq?view=asciicast
http://stackoverflow.com/questions/14825565/sidekiq-deploy-to-multiple-environments

Capistrano 3 实现 Rails 自动化部署

lanvige — Tue, 15 Apr 2014 14:25:11 +0800

原文始发：http://lanvige.github.io/2014/02/21/using-capistrano-3-to-deploy/

Offical Site: http://capistranorb.com/
Github: https://github.com/capistrano/capistrano

Capistrano 3.1 相对于之前的 2.x 有着很大不同，本想用自动化发布，应该是分分种搞定的事情，没想到找文档，看说明，花了一天也没看出个什么，于是晚上花时间把 2.x 和 3.1 的代码过了下，做了个对比，总算搞明白了里面的一些机制。

使用版本

unicorn 4.8.2
rails 4.1.0
ruby 2.1.1
capistrano 3.1

安装::

在Gemfile中添加 Capistrano 和其它用到的插件

group :development do
  gem 'capistrano'
  gem 'capistrano-bundler'
  gem 'capistrano-rails'
  gem 'capistrano-rbenv'
  # Add this if you're using rvm
  # gem 'capistrano-rvm'
end

项目中初始化 Capistrano

$ cap install

会生成如下目录文件，Capfile用来配置 Capistrano，deploy.rb是一些共用 task 的定义，而production.rb/staging.rb用来定义具体的 stage 的 tasks。

├── Capfile   
├── config   
│   ├── deploy   
│   │   ├── production.rb   
│   │   └── staging.rb   
│   └── deploy.rb   
└── lib   
    └── capistrano   
        └── tasks

安装完成之后，通过 cap -vT 来查看当前项目的可执行任务列表。

cap bundler:install                # Install the current Bundler environment
cap deploy                         # Deploy a new release
cap deploy:check                   # Check required files and directories exist
cap deploy:check:directories       # Check shared and release directories exist
cap deploy:check:linked_dirs       # Check directories to be linked exist in shared
cap deploy:check:linked_files      # Check files to be linked exist in shared
cap deploy:check:make_linked_dirs  # Check directories of files to be linked exist in shared
...
cap install                        # Install Capistrano, cap install STAGES=staging,production

这些命令其中就包括刚刚执行的cap install，其它用到的，后面再讲。

配置 Capistrano

- 在`Capfile`里开启要用到的一些插件

require 'capistrano/setup'
require 'capistrano/deploy'

require 'capistrano/rbenv'
require 'capistrano/bundler'
require 'capistrano/rails/assets'
require 'capistrano/rails/migrations'

Dir.glob('lib/capistrano/tasks/*.cap').each { |r| import r }

###

本文件中用来配置共用变量。

# config valid only for Capistrano 3.1
lock '3.1.0'

set :application, 'appname'
set :deploy_user, 'ares'

set :scm, :git
set :repo_url, 'git@github.org:lanvige/railsapp.git'

# rbenv
set :rbenv_type, :user
set :rbenv_ruby, '2.1.1'
set :rbenv_prefix, "RBENV_ROOT=#{fetch(:rbenv_path)} RBENV_VERSION=#{fetch(:rbenv_ruby)} #{fetch(:rbenv_path)}/bin/rbenv exec"
set :rbenv_map_bins, %w{rake gem bundle ruby rails}

# how many old releases do we want to keep, not much
set :keep_releases, 5

# files we want symlinking to specific entries in shared
set :linked_files, %w{config/database.yml config/application.yml config/secrets.yml}

# dirs we want symlinking to shared
set :linked_dirs, %w{bin log tmp/pids tmp/cache tmp/sockets vendor/bundle public/system}

namespace :deploy do
  after :finishing, 'deploy:cleanup'
end

rbenv 的配置见这里
linked_files & linked_dirs 见这里。

- 配置`Stage`

关于 Stage，详见：

一个很重要的配置是 Role、Server（User）以及其对应关系，为了方便，Cap3 中提供了多种配置形式，各有不同的侧重，但用途都是一样的，见下面。

# 以role为中心的写法
role :app, %w{deploy@example.com, deploy@example.local}
role :web, %w{deploy@example.com}
role :db,  %w{deploy@example.com}

# 以server为中心的写法，上面的写法可以用以下写法代替：
server 'example.com', user: 'deploy', roles: %w{web app db}
server 'example.local', user: 'deploy', roles: %w{app}

# 如果要对某服务器配置SSH等更多时，也可以用这种写法：
server 'example.com',
  user: 'user_name',
  roles: %w{web app},
  ssh_options: {
    user: 'user_name', # overrides user setting above
    keys: %w(/home/user_name/.ssh/id_rsa),
    forward_agent: false,
    auth_methods: %w(publickey password)
    # password: 'please use keys'
  }

Stage 示例

set :stage, :test
set :branch, 'develop'

server '192.168.1.1', user: 'ares', roles: %w{web app db}

set :deploy_to, "/home/#{fetch(:deploy_user)}/apps/appname"

# dont try and infer something as important as environment from
# stage name.
set :rails_env, :test

# number of unicorn workers, this will be reflected in
# the unicorn.rb and the monit configs
set :unicorn_worker_count, 5

# whether we're using ssl or not, used for building nginx
# config file
set :enable_ssl, false

开始部署::

- 部署

$ cap production deploy --dry-run
$ cap production deploy

输入服务器用户密码后就 deploy 就进行了。不想每次都输密码，ssh-copy-id可能是你想要的。

- 服务器生成目录详解

运行多次 deploy 之后会生成这样的目录结构：

.
├── current -> /home/ares/apps/appname/releases/20140325071623
├── releases
│   ├── 20140325065734
│   ├── 20140325071310
│   ├── 20140325071623
│   └── 20140325074922
├── repo
│   ├── branches
│   ├── config
│   ├── description
│   ├── FETCH_HEAD
│   ├── HEAD
│   ├── hooks
│   ├── info
│   ├── objects
│   ├── packed-refs
│   └── refs
├── revisions.log
└── shared
    ├── bin
    ├── bundle
    ├── config
    ├── log
    ├── public
    ├── tmp
    └── vendor

release 每次发布都会产成一个目录，该目录下存放着 Rails 项目源码，多个目录是为了 rollback 而设。
current 是指当前版本，软链接到 release 下的某个版本目录。
repo 存的是项目的.git 目录
shared 是项目中共享的内容，如 config 文件，不随每次发布而改动。

- Rollback

$ cap production deploy:rollback

Rollback 其实就是把 current 目录指向到 releases 里上次发布的目录。

关键词解析::

- `Cap Flow`

系统默认包含下面的这些 Task，Task 是有顺序的，在每个 Task 之前和之后可以通过before, after添加自定义的 Task。更多 Flow 介绍，见这里

deploy:starting
deploy:started
deploy:reverting - revert server(s) to previous release
deploy:reverted - reverted hook
deploy:publishing
deploy:published
deploy:finishing_rollback - finish the rollback, clean up everything
deploy:finished

在这些 Flow 之外也有一些常用的 Task：

##### deploy:check 对应 Cap 2.x 中的 deploy:setup。

check 不属于 deploy flow，它的目的主要是在服务器上创建所需要的目录（主要是 shared, release），然后就是对应的 linked_dir & linked_files 操作。

deploy:cold in 2.x

新的系统中，核心的 deploy task 是幂等 (idempotent) 的，所以像cap deploy:cold这样的预执行命令（创建目录结构）就不再被需要了。
dry run

dry-run 主要是保证每一个命令都能被执行到，但不会在服务器上产生任何改动。

$ cap production deploy —dry-run

- Stage

Cap 中有和 Rails 一样的运行环境（Environment）的概念 (Cap 中叫作Stage，默认建了 2 个 Stage，staging, production），就是不同环境下对应不同的服务器。

deploy.rb中定义着公用的变量，对应到不同的 Stage，可以定义一些专有的变量，同时也可以覆写 deploy.rb 中的公用变量。

注：Stage 名字默认对应 Rails 的 environment 名字（development, test, production）。可通过设置进行映射。

set :rails_env, :test

- `linked_files` & `linked_dirs`

Capistrano 使用Shared目录来管理那些在不同Release中共用的文件，最主要的一个shared/config中包含每个发布所需要的配置文件

##### linked_dirs 是将项目的指定目录链接到 shared 目录中。这个操作会在从 repo 取下代码之后进行。
##### linked_files 和 linked_dirs 相反，它是将 shared 中的文件链接到项目中，文件要首先存在于 shared 目录中，不然 deploy 时会报错。 Rails 项目中，主要就是database.yml，secret.yml这样的敏感文件。对于这些文件最好的做法就是从 Git 中过滤掉，然后每个开发者和服务器都单独配置。

- MySQL

在尝试使用 SQLite3 进行 Cap 测试通过后，将 DB 换成 MySQL，然后又出错了。错误是数据库不存在，一直以为是在创建数据库时未指定RAILS_EVN，后来发现 migrations 在执行前也没有运行db:create来创建数据库。

在运行 deploy 前，自己手工创建数据库，然后 deploy 就能正常运行了。猜想：create 属于一次性操作，所以没有将其作为 task 放入 deploy 中。

- Ask

在 deploy.rb 和 stage 文件中，我们可以设置变量的值。但有时，值会在运行时才被确定，这样就可以通过 ask 来设定。

ask :branch, ‘my_default_branch’

这样在 branch 变量第一次被使用时，会有输入提示，就可以动态设置该值了。

- Role

角色的目的是让 Task 可以运行在不同的机器上。更多

一个线上程序中有着多种服务器，像 DB Server, APP server, Web Server，在不同的 Server 上要运行不同的部署方案。Cap 也把这些也考虑到了，可以通过创建不同的 Role 来对这些服务器进行归类，为 Task 指定 Role 来运行。

- Tasks

如何自定义 taskdoc

- Cold Start

可以在发布进行之前做一些准备工作，比如，创建 linked_files、Unicorn、Nginx 的配置及创建 Service 的工作。

现行的作法是，定制一个 task，在 Deploy 之前进行，在服务器创建目录，然后从本地将文件预先upload!) 到服务器的相应目录（主要是shared/config）。

- sudo

Capistrano 3 推荐使用 passwordless sudo。这样非 root 用户也可以直接使用 sudo 命令，而不必通过 PTY 来输入密码。Guide:

其实就是在系统里，给指定用户赋上某些指令的 sudo 权限。在 Ubuntu 下，修改 /etc/sudoers来添加要使用的命令。

ares ALL=NOPASSWD:/usr/sbin/service, /bin/ln
#也可以将所有程序都设置为不要密码，不过太不安全，不建议
#ares ALL=(ALL) NOPASSWD: ALL

- PTYs

PTY 就是让用户在当前 Terminal 中执行任务时，可以进行交互。比如说执行 sudo 任务时，可以远程输入密码。更多

ps：试着启用 pts，但输入密码后无反应。

- ssh-copy-id

每次运行 cap 都要输入密码，可以将本地的 ssh 公钥存到 server 上，就可以省下很多时间。

ssh-copy-id 就是这么一个将本机的公钥复制到远程机器的 authorized_keys 文件的工具，其也能让你拥有远程机器的 home, ~./ssh , 和 ~/.ssh/authorized_keys 的权利。

首先本地机器上要创建 ssh key

$ ssh-keygen

$ ssh-copy-id ares@192.168.1.1

Mac OSX 上 ssh-copy-id 不是默认安装的，可通过 Homebrew 进行安装

$ brew install ssh-copy-id

问：二级目录换成二级域名的方案？

lanvige — Wed, 18 Jul 2012 13:23:39 +0800

Rails 3 项目的 api 之前是放在 http://www.myapp.com/api/v1/ 下的，现在想换成二级域名，像 http://api.myapp.com/v1

有好的解决方案吗？

理论上 api 和 www 是同一套代码，能想到的也就是重做一个 router，将路径重定向。

不知谁有这方面的经验。

NYC 逛街时看到的一家店 Ruby Tuesday

lanvige — Tue, 03 Jul 2012 15:31:03 +0800

44 街吧，走着走着忽然备感亲切。

Ubuntu 中使用 Gmail 发送邮件需要安装 mutt 之类的工具吗？

lanvige — Thu, 05 Jan 2012 19:55:13 +0800

我使用 Devise，用户注册时会发一个激活信息，目前使用 Gmail 作 Mail Server。

这段代码在 OS X 上工作正常，但在 Ubuntu 11.04 X64 下，邮件就是发送不出来，也没有任何错误，Dev log 中也没其它信息。

查到这么一个帖子，和我问题较相似： http://stackoverflow.com/questions/8498586/rails-mailer-ubuntu

装了 mutt 这样的 mail agent，但似乎问题依旧。

Ubuntu 上还要配其它东西吗？

lanvige (Lanvige Jiang)

Rails Variants Tips

Action Pack Variants

具体用法

Tip 1 判断浏览器类型

Tip 2 参数指定浏览器类型

Tip 3 Devise 等如何使用

REF::

Sidekiq 精通 36 分钟

Rails 中配置 Sidekiq

sidekiq 配置参数

Worker

Run

Deploy with Capistrano

Rails 中的 Cap 配置示例：

进程监控

使用自带的监控页面

REF::

Capistrano 3 实现 Rails 自动化部署

使用版本

安装::

项目中初始化 Capistrano

配置 Capistrano

- 在Capfile里开启要用到的一些插件

- 配置Stage

开始部署::

- 部署

- 服务器生成目录详解

- Rollback

关键词解析::

- Cap Flow

deploy:cold in 2.x

dry run

- Stage

- linked_files & linked_dirs

- MySQL

- Ask

- Role

- Tasks

- Cold Start

- sudo

- PTYs

- ssh-copy-id

问：二级目录换成二级域名的方案？

NYC 逛街时看到的一家店 Ruby Tuesday

Ubuntu 中使用 Gmail 发送邮件需要安装 mutt 之类的工具吗？

- 在`Capfile`里开启要用到的一些插件

- 配置`Stage`

- `Cap Flow`

- `linked_files` & `linked_dirs`