Rex 是 Perl 編寫的基于 SSH 鏈接的集群配置管理系統，語法上類似 Puppet DSL。官網中文版見 http://rex.perl-china.com 。本文僅為本人在部門 Wiki 上編寫的簡介性文檔。
常用命令參數
rex 命令參數很多，不過因為我們的環境是 krb 認證的，所以有些參數只能寫在 Rexfile 里。所以一般固定在存放了 Rexfile 的 /etc/puppet/webui 下執行命令，很多配置就自動加載了。那么還需要用到的命令參數基本就只有下面幾個：
-Tv： 查看當前 Rexfile 里定義了哪些 Task 任務，以及服務器組。
-H： 指定 Task 將在哪些 Host 上執行。這里比較方便的地方是支持 10.5.16.[95..110] 這樣的寫法。
-G： 指定 Task 將在哪些 Group 上執行。Group 的定義方式很多，Rex 默認支持的有直接在 Rexfile 里通過 group 指令指定，通過 ini 配置文件設定等等。目前我是實現了一個 groups_db 指令，來從我們的 sqlite 里獲取。groups_db('cdnbj::nginx') 就會自動生成一個名叫 ‘cdnbj::nginx' 的服務器組，包括 cdnbj 里所有部署了 nginx 的服務器。
-e： 指定一個臨時任務。通常是'say run “ipconfig”‘這樣的簡單命令形式。如果需要復雜邏輯，還是在 Rexfile 里書寫 Task。
-q：指定運行日志級別，有 -q 和 -qq。
-d：指定運行日志級別，有 -d 和 -dd。
Rexfile 介紹
參數設置部分：
復制代碼 代碼如下:
set connection => "OpenSSH";
user "root";
krb5_auth;
parallelism 10;
這四行指定采用 kerberos 認證，并發 10 個進程執行 ssh 命令。
復制代碼 代碼如下:
desc "install puppet agent";
task "puppet_install", sub {
}
before "puppet_install", sub {
}
after "puppet_install", sub {
}
這幾行就是 Rexfile 的任務定義主體格式。task 指令定義任務，任務會在具體的 -H 或者 -G 服務器上執行。其他都是可選項，desc內容會在 -Tv 的時候顯示；before 和 after 定義的任務會在執行對應 task 之前或之后，在'''rex命令執行處，即10.4.1.21本地'''執行。
常用指令介紹
run
運行命令。如果有回調函數，那么會把 stdout 和 stderr 傳給回調函數；如果沒有，直接把 stdout 作為返回值。
比如：
復制代碼 代碼如下:
say run "uptime";
run "nginx -v", sub { my ($out, $err) = @_; say $err };
file
分發文件。語法類似 Puppet 的 file。支持 source、template、ensure、on_change 等操作。注意：rex 是順序執行 Rexfile 的，所以不用設置 Puppet 的 require 指令。
比如：
復制代碼 代碼如下:
file "/etc/yum.repos.d/xiaonei-private.repo",
source => "repos/xiaonei-private.repo";
file "/etc/nginx/nginx.conf",
content => template("templates/etc/nginx/nginx.conf.tpl"),
owner => "nginx",
group => "nginx",
mode => 644,
ensure => 'file',
on_change => sub { service nginx => "restart"; };
file "/etc/nginx/conf.d",
ensure => "directory",
pkg
安裝軟件包，在早期版本命令寫作 install package => "nginx" ，最近改成 pkg 了，更像 Puppet 語法了。
也支持傳遞數組作為 pkg 內容。另外，rex 還 提供了一個 update_package_db 指令，用于執行 yum clean all 或者 apt-get update 操作。這點是 Puppet 欠缺的。
比如：
復制代碼 代碼如下:
update_package_db();
my $packages = case operating_system,
Debian => ["apache2", "libphp5-apache2"],
CentOS => ["httpd", "php5"],
pkg $packages,
ensure => "present";
ensure 也支持 present、absent、latest 等幾種含義。同 Puppet。
account
用戶管理原先用 create_user 和 create_group 指令，最近把 create_user 更新為 account 指令。
比如：
復制代碼 代碼如下:
create_group 'puppet';
account "puppet",
ensure => "present",
uid => 509,
home => '/home/puppet',
comment => 'Puppet Account',
expire => '2015-05-30',
groups => ['puppet'],
password => 'puppet',
system => 1,
no_create_home => TRUE,
ssh_key => "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQChUw...";
tail
用來同時觀測多臺主機的日志的最新追加情況。應該是比較有用的一個小功能。代碼如下：
復制代碼 代碼如下:
tail "/var/log/syslog", sub {
my ($data) = @_;
my $server = Rex->get_current_connection()->{'server'};
print "$server>> $data/n";
};
遠程主機詳情相關變量
Puppet 有專門的 Facts 變量來判定遠程主機的詳情。Rex 因為走 SSH 連接，不會在遠程主機上跑一個 agent 來收集這些信息，所以還是通過遠程執行命令的方式來提供相關內容。目前常用的幾個函數(也可以認為是變量)有：
is_redhat
這個用來判斷操作系統是否是 RedHat 系列。之前因為有一批 Debian 的機器，所以 Rexfile 里一直有這么個操作邏輯：
復制代碼 代碼如下:
if ( is_debian ) {
} elsif ( is_redhat ) {
} else {
}
operating_system_version
這個用來判斷具體的操作系統版本號。比如 CentOS5 跟 CentOS6 應該應用的操作就不一樣，甚至 CentOS6.5 和 CentOS6.2 也有可能不一致。
比如 Rexfile 里的 1w10 任務：
復制代碼 代碼如下:
if ( is_redhat and operating_system_version >= 64 )
}
route
rex 可以收集的信息比 puppet 要多很多，比如網絡相關、sysctl 相關等等。Rexfile 里的 1w10 任務用到了 route 信息來獲取默認網關和網卡接口。
復制代碼 代碼如下:
my ($default_route) = grep {
$_->{"flags"} =~ m/UG/ && (
$_->{"destination"} eq "0.0.0.0" ||
$_->{"destination"} eq "default" )
} route;
if ($default_route) {
my $default_gw = $default_route->{"gateway"};
my $default_if = $default_route->{"iface"};
run "ip route change default via ${default_gw} dev ${default_if} initcwnd 10 initrwnd 10";
};
connection
在多臺主機執行任務的時候，大多希望在輸出的時候看到某條結果是哪個主機返回的。前面 tail 任務就用到了，不過寫起來非常復雜的樣子。其實 rex 提供給更簡潔一點的寫法。就是 connection->server。
復制代碼 代碼如下:
task 'tellmewhoyouare', sub {
say connection->server;
}
當前連接的服務器的整個信息，也可以通過 get_system_information 指令來獲取，這兩個指令其實是等同的。不過根據字面意思一般用來不同語境下。這些信息如果要完整查看，可以通過 dump_system_information 指令來查看。這個命令跟 print Dumper get_system_information() 不一樣的是，會把每個鍵作為單獨變量。而這些變量就是可以直接用于 rex 的 template 里的內嵌變量。比如：
復制代碼 代碼如下:
listen <%= $eth0_ip %>:80;
visible_hostname <%= $hostname %>
不在 dump_system_information 清單里的變量，也想在 template 里使用的，就必須顯式傳遞。這點和 Puppet 不一致，puppet 在 template 里可以通過 scope.lookupvar() 指令獲取任意pp類里設定的變量，這一點完全無視詞法作用域的存在==！比如：
復制代碼 代碼如下:
file '/etc/elasticsearch/elasticsearch.yml',
content => template('files/es.yml.tmpl', conf => {
clustername => 'logstash'
});
對應的 es.yml.tmpl 里寫作：
復制代碼 代碼如下:
clustername: <%= $conf->{'clustername'} %>
這樣才行。
