Distillery: Elixir 应用程序的构建与发布系统指南

Distillery: Elixir 应用程序的构建与发布系统指南

distillerySimplify deployments in Elixir with OTP releases!项目地址:https://gitcode.com/gh_mirrors/di/distillery

Distillery 是一个用于 Elixir 项目的发布工具，它简化了创建可部署的 release 包并管理应用程序环境的过程。接下来，我们将深入了解 Distillery 的核心组成部分，帮助您高效地使用这一强大的工具。

1. 项目的目录结构及介绍

在使用 Distillery 设置的项目中，关键的目录结构扩展了标准的 Elixir 项目布局：

• config: 此目录包含了所有应用级别的配置文件，包括 Distillery 专用的配置 rel/config.exs，它定义了发布设置。
• lib: 项目的主要代码库所在，但与 Distillery 直接相关的逻辑通常不在这里。
• rel: 这是 Distillery 添加的重要目录，其中最重要的文件是 release.exs，用于定义发布的基本信息，如应用名称、版本等。此外，这个目录下还会生成编译后的释放脚本和其他相关文件。
• _build: 编译后的产品存放于此，包括由 Distillery 构建的 release 目录。
• mix.exs: 项目的核心配置文件，虽然不特定于 Distillery，但它会导入 Distillery 作为依赖，并且可以指定应用的版本、依赖等。

2. 项目的启动文件介绍

在 Distillery 创建的 release 中，主要的启动脚本是位于最终发布包中的 bin 目录下的 my_app_name.sh（或对应你的应用名称）。这个脚本是运行你的 Elixir 应用程序的入口点。它负责加载环境变量，初始化 Erlang VM，然后启动你的应用程序。在生产环境中，通过执行这个脚本即可启动整个应用服务。

#!/usr/bin/env sh
...
erts-.../bin/erl ... -boot start_sasl ... -name my_app_name@localhost ...

此脚本自动处理了所有底层细节，确保应用能够在一个合适且一致的环境中被正确启动。

3. 项目的配置文件介绍

rel/config.exs

这是 Distillery 配置的核心。示例配置可能包含以下几个重要部分：

release :my_app do
  version "1.0.0"
  set include_erts: true
  set include_src: false
  set vm_args: "rel/vm.args"
  
  # 可以在这里添加自定义步骤，如预编译任务
  # 增加应用依赖
  applications [
    :logger,
    :some_dependency
  ]
end

• version: 应用发布版本。
• include_erts: 是否包含 Erlang 术语系统，这对于独立部署是必要的。
• vm_args: 指定 Erlang 虚拟机的参数文件路径。
• applications: 定义应用程序的依赖列表，除了默认的之外。

此外，还可在 config/releases.exs 或者在 config/prod.exs (如果是混合使用 Mix 配置) 中进行更细粒度的应用级配置。

通过上述模块的学习，你应该能够掌握如何有效地管理和配置你的 Elixir 应用来利用 Distillery 强大的部署能力。记得在实际操作时，参考最新的官方文档以获取最准确的信息。

distillerySimplify deployments in Elixir with OTP releases!项目地址:https://gitcode.com/gh_mirrors/di/distillery