发布 | 10. Releases
10 发布
这部分是与被读取rel(4)，systools(3)以及script(4)在SASL手册页。
10.1发布概念
当您编写一个或多个应用程序时，您可能需要使用这些应用程序和Erlang/OTP应用程序的一个子集创建一个完整的系统。这被称为发布。
为此，请创建一个release resource file用于定义发行版中包含哪些应用程序的程序。
释放资源文件用于生成boot scripts和release packages。转移到并安装在另一个站点的系统称为目标系统。系统原则“中介绍了如何使用发行包创建目标系统。
10.2 释放资源文件
要定义一个版本，请创建一个版本资源文件，或简称为.rel文件。在文件中，指定版本的名称和版本，它基于哪个ERTS版本以及它由哪些应用程序组成：
{release, {Name,Vsn}, {erts, EVsn},
[{Application1, AppVsn1},
...
{ApplicationN, AppVsnN}]}.
Name，Vsn，EVsn，和AppVsn都是字符串。
该文件必须命名Rel.rel，其中Rel是唯一的名称。
每个Application（atom）AppVsn是发布中包含的应用程序的名称和版本。基于Erlang/OTP的最小版本由Kernel和STDLIB应用程序组成，因此这些应用程序必须包含在列表中。
如果要升级版本，则还必须包含SASL应用程序。
例如：ch_app from 的发布Applications包含以下.app文件：
{application, ch_app,
[{description, "Channel allocator"},
{vsn, "1"},
{modules, [ch_app, ch_sup, ch3]},
{registered, [ch3]},
{applications, [kernel, stdlib, sasl]},
{mod, {ch_app,[]}}
]}.
.rel文件还必须包含kernel，stdlib和sasl，因为这些应用程序是必需的ch_app。该文件被称为ch_rel-1.rel：
{release,
{"ch_rel", "A"},
{erts, "5.3"},
[{kernel, "2.9"},
{stdlib, "1.12"},
{sasl, "1.10"},
{ch_app, "1"}]
}.
10.3生成启动脚本
systools在SASL应用程序中包含用于构建和检查版本的工具。这些函数读取rel和.app文件并执行语法和相关性检查。该systools:make_script/1,2函数用于生成启动脚本（请参阅系统原理）：
1> systools:make_script("ch_rel-1", [local]).
ok
这会创建一个引导脚本，它是运行时系统使用的可读版本ch_rel-1.script和二进制版本ch_rel-1.boot。
"ch_rel-1"是.rel文件的名称，减去扩展名。
local是一个选项，意味着在启动脚本中使用找到应用程序的目录，而不是$ROOT/lib（$ROOT是已安装版本的根目录）。
这是在本地测试生成的启动脚本的有用方法。
当使用启动脚本启动Erlang/OTP时，.rel文件中的所有应用程序都会自动加载并启动：
% erl -boot ch_rel-1
Erlang (BEAM) emulator version 5.3
Eshell V5.3 (abort with ^G)
1>
=PROGRESS REPORT==== 13-Jun-2003::12:01:15 ===
supervisor: {local,sasl_safe_sup}
started: [{pid,<0.33.0>},
{name,alarm_handler},
{mfa,{alarm_handler,start_link,[]}},
{restart_type,permanent},
{shutdown,2000},
{child_type,worker}]
...
=PROGRESS REPORT==== 13-Jun-2003::12:01:15 ===
application: sasl
started_at: nonode@nohost
...
=PROGRESS REPORT==== 13-Jun-2003::12:01:15 ===
application: ch_app
started_at: nonode@nohost
10.4创建发布包
systools:make_tar/1,2函数将一个.rel文件作为输入并使用指定应用程序的代码（一个发行包）创建一个压缩的tar文件：
1> systools:make_script("ch_rel-1").
ok
2> systools:make_tar("ch_rel-1").
ok
发行包默认包含：
.app文件
.rel文件
- 所有应用程序的目标代码，按照
application directory structure
- 二进制引导脚本重命名为
start.boot
% tar tf ch_rel-1.tar
lib/kernel-2.9/ebin/kernel.app
lib/kernel-2.9/ebin/application.beam
...
lib/stdlib-1.12/ebin/stdlib.app
lib/stdlib-1.12/ebin/beam_lib.beam
...
lib/sasl-1.10/ebin/sasl.app
lib/sasl-1.10/ebin/sasl.beam
...
lib/ch_app-1/ebin/ch_app.app
lib/ch_app-1/ebin/ch_app.beam
lib/ch_app-1/ebin/ch_sup.beam
lib/ch_app-1/ebin/ch3.beam
releases/A/start.boot
releases/A/ch_rel-1.rel
releases/ch_rel-1.rel
生成一个新的引导脚本，而不使用local选项集，在发布包生成之前。在发布包中，所有应用程序目录都放在lib您不知道将在哪里安装发行包，因此不允许硬编码绝对路径。
释放资源文件mysystem.rel在tar文件中被复制。最初，该文件只存储在releases目录中，以便可以release_handler单独提取此文件。解压tar文件后，release_handler会自动将文件复制到releases/FIRST。但是，有时tar文件在不涉及release_handler（例如，解包第一个目标系统时）的情况下解压缩，因此文件现在在tar文件中被复制，因此不需要手动复制。
如果找到relup调用的文件和/或系统配置文件sys.config，则这些文件也包含在发行包中。看Release Handling。
可以设置选项以使发行包中包含源代码和ERTS二进制文件。
有关如何使用发行包安装第一个目标系统的信息，请参阅系统原则。有关如何在现有系统中安装新发行版软件包的信息，请参阅Release Handling。
10.5目录结构
释放处理程序从发行包安装的代码的目录结构如下所示：
$ROOT/lib/App1-AVsn1/ebin
/priv
/App2-AVsn2/ebin
/priv
...
/AppN-AVsnN/ebin
/priv
/erts-EVsn/bin
/releases/Vsn
/bin
lib- 应用程序目录
erts-EVsn/bin- Erlang运行时系统可执行文件
releases/Vsn-.rel文件和启动脚本start.boot; 如果存在于发布包中，relup和/或sys.config
bin- 顶级Erlang运行时系统可执行文件
应用程序不需要位于目录下$ROOT/lib。因此可以存在多个包含系统的不同部分的安装目录。例如，前面的例子可以扩展如下：
$SECOND_ROOT/.../SApp1-SAVsn1/ebin
/priv
/SApp2-SAVsn2/ebin
/priv
...
/SAppN-SAVsnN/ebin
/priv
$THIRD_ROOT/TApp1-TAVsn1/ebin
/priv
/TApp2-TAVsn2/ebin
/priv
...
/TAppN-TAVsnN/ebin
/priv
在调用systools:make_script/2函数时引入$SECOND_ROOT和$THIRD_ROOT当做variables。
无盘（Disk-Less）和/或只读客户端
如果一个完整的系统由无磁盘和/或只读客户机节点组成，clients则需要将一个目录添加到$ROOT目录中。只读节点是具有只读文件系统的节点。
clients目录是让每个支持的客户端节点的一个子目录。每个客户端目录的名称将作为相应客户端节点的名称。至少，每个客户端目录将包含bin和releases子目录。这些目录用于存储有关已安装版本的信息，并将当前版本指定给客户端。在$ROOT这样的目录包含以下内容：
$ROOT/...
/clients/ClientName1/bin
/releases/Vsn
/ClientName2/bin
/releases/Vsn
...
/ClientNameN/bin
/releases/Vsn
如果所有客户端都运行相同类型的Erlang机器，则使用此结构。如果有客户端运行不同类型的Erlang机器，或者在不同的操作系统上，那么该clients目录可以分成每个Erlang机器的一个子目录。或者，$ROOT可以针对每种机器设置一个。对于每种类型，$ROOT将包含为该目录指定的一些目录：
$ROOT/...
/clients/Type1/lib
/erts-EVsn
/bin
/ClientName1/bin
/releases/Vsn
/ClientName2/bin
/releases/Vsn
...
/ClientNameN/bin
/releases/Vsn
...
/TypeN/lib
/erts-EVsn
/bin
...
有了这个结构，Type1is的客户端的根目录$ROOT/clients/Type1。
