rebar生成erlang release 并进行热代码升级

### 使用rebar生成Erlang Release并进行热代码升级 #### 一、使用rebar创建一个OTP项目 在深入探讨如何使用rebar工具生成Erlang release并进行热代码升级之前，我们首先需要了解如何使用rebar来创建一个基本的Erlang OTP项目。 ##### 第1步：创建项目目录 在开始前，你需要准备一个用于存放项目的空目录。例如，假设你的用户名是`bland`，你可以按照以下步骤创建一个名为`myapp`的项目目录： ```bash bland@thinkpad:~/workspace/黑米/研发/项目/SiteLyst3/rebar_test$ mkdir myapp bland@thinkpad:~/workspace/黑米/研发/项目/SiteLyst3/rebar_test$ cd myapp ``` ##### 第2步：获取rebar文件 接下来，你需要下载rebar工具。可以通过访问GitHub上的rebar项目页面下载或克隆该项目。这里采用下载方式获取rebar文件： ```bash bland@thinkpad:~/workspace/黑米/研发/项目/SiteLyst3/rebar_test$ wget http://cloud.github.com/downloads/basho/rebar/rebar --2011-05-13 09:37:13-- http://cloud.github.com/downloads/basho/rebar/rebar 正在解析主机 cloud.github.com... 204.246.165.144, 204.246.165.231, 204.246.165.99 正在连接 cloud.github.com|204.246.165.144|:80... 已连接。 已发出 HTTP 请求，正在等待回应... 200 OK 长度：102570 (100K) [application/octet-stream] 正在保存至: “rebar” 100%[======================================>] 102,570 --.-K/s in 1.3s 2011-05-13 09:37:23 (74.4 KB/s) - 已保存 “rebar” [102570/102570] ``` 如果你更倾向于使用Git来克隆rebar项目，可以通过下面的命令： ```bash git clone https://github.com/basho/rebar.git ``` ##### 第3步：创建一个OTP项目 一旦有了rebar文件，就可以通过它来创建一个新的Erlang OTP项目。在这个例子中，我们将创建一个名为`myapp`的应用程序： ```bash bland@thinkpad:~/workspace/黑米/研发/项目/SiteLyst3/rebar_test/myapp$ ./rebar create-app appid=myapp ==> myapp (create-app) Writing src/myapp.app.src Writing src/myapp_app.erl Writing src/myapp_sup.erl ``` 此时，rebar已经为我们创建了一些基本的文件结构，包括应用程序描述文件（`.app.src`）、启动模块 (`myapp_app.erl`) 和监督树模块 (`myapp_sup.erl`)。 ##### 第4步：增加一个Gen Server 接下来，我们可以添加一个Gen Server到我们的应用中。这可以通过修改`myapp_sup.erl`文件来完成，具体示例如下： ```erlang init([]) -> Server1 = {myapp_server, {myapp_server, start_link, []}, permanent, 5000, worker, [myapp_server]}, {ok, {{one_for_one, 5, 10}, [Server1]}}. ``` 同时还需要修改`myapp.app.src`文件，确保`myapp_server`被正确地包含在内： ```erlang {modules, [ myapp_app, myapp_sup, myapp_server ]}. ``` ##### 第5步：编译项目 现在可以使用rebar工具来编译整个项目了： ```bash bland@thinkpad:~/workspace/黑米/研发/项目/SiteLyst3/rebar_test/myapp$ ./rebar compile ==> myapp (compile) Compiled src/myapp_app.erl Compiled src/myapp_sup.erl Compiled src/myapp_server.erl ``` #### 二、测试应用程序 在部署之前，应该先对应用程序进行简单的测试。rebar支持两种测试框架：eunit和common_test。这里使用eunit进行简单的测试。 在`src/myapp_app.erl`文件中加入测试相关的代码： ```erlang -ifdef(TEST). -include_lib("eunit/include/eunit.hrl"). -endif. -ifdef(TEST). simple_test() -> ok = application:start(myapp), ?assertNot(undefined == whereis(myapp_sup)). -endif. ``` #### 三、生成Release 完成以上步骤后，就可以使用rebar生成release包了。release包是Erlang/OTP应用的标准部署格式，它包含了运行应用程序所需的所有依赖库以及必要的启动脚本。 使用rebar生成release的具体步骤如下： 1. **安装rebar3**：如果还没有安装rebar3，可以通过以下命令安装： ```bash curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py pip install rebar3 ``` 2. **生成release**：使用rebar3生成release包： ```bash rebar3 release ``` 生成的release包将位于`_build/default/rel/myapp`目录下。 #### 四、热代码升级 热代码升级是Erlang的一个重要特性，允许在不中断服务的情况下更新应用程序代码。要实现这一点，你需要执行以下步骤： 1. **启动release**：使用`start.sh`脚本来启动release： ```bash _build/default/rel/myapp/bin/myapp start ``` 2. **停止应用程序**：在新版本部署之前，需要先停止当前的应用程序： ```bash _build/default/rel/myapp/bin/myapp stop ``` 3. **更新应用程序**：重新运行`rebar3 release`生成新的release包，并替换旧的release包。 4. **重启应用程序**：使用`start.sh`脚本再次启动release： ```bash _build/default/rel/myapp/bin/myapp start ``` 5. **验证升级**：通过检查进程状态或其他方式验证新版本是否成功启动。 通过以上步骤，你不仅学会了如何使用rebar创建Erlang OTP项目，还掌握了如何生成release并进行热代码升级的关键技能。这对于开发和维护高可用性系统来说至关重要。