使用 edeliver 部署 Elixir 应用程序

发布 2017-12-11
更新 2019-11-27
阅读

本文最后更新于$day天前，文中所描述的信息可能已发生改变。

最近使用 Elixir 的 web 框架 Phoenix 开发了一个简单的应用，部署的时候踩了不少坑。做一下笔记。

elixir 1.9.x 之后部署上略有改变，更新一下。

步骤

第一步：引入 edeliver 依赖

修改 mix.exs 文件，引入 edeliver 依赖

def application, do: [
  extra_applications: [
    ...
    :edeliver
  ]
]

defp deps do
  [
    ...
    {:edeliver, ">= 1.7.0"},
    {:distillery, "~> 2.1", warn_missing: false},
  ]
end

第二步：生成配置文件

执行 mix distillery.init 生成 rel 配置文件夹，里面的配置默认即可。

Phoenix 框架做了一些变更，config/prod.secret.exs 也加入到了版本控制里，因为敏感数据都是从系统环境变量里取了。

edeliver 配置

在项目文件夹，创建 .deliver/config 文件

APP="your-erlang-app" # 应用名称

BUILD_HOST="build-system.acme.org" # 构建的主机地址
BUILD_USER="build" # 构建主机的登录用户名

BUILD_AT="/tmp/erlang/my-app/builds" # 构建主机上的构建文件夹

STAGING_HOSTS="test1.acme.org test2.acme.org" # 测试主机地址
STAGING_USER="test" # 测试主机的登录用户名
TEST_AT="/test/my-erlang-app" # 测试的构建文件夹

PRODUCTION_HOSTS="deploy1.acme.org deploy2.acme.org" # 部署主机地址
PRODUCTION_USER="production" # 部署主机的登录用户名
DELIVER_TO="/opt/my-erlang-app" # 部署的文件夹

# 下面的这一段其实不需要了，敏感数据都是从系统环境变量里取了

# pre_erlang_get_and_update_deps() {
#  local _prod_secret_path="/home/builder/prod.secret.exs"
#  if [ "$TARGET_MIX_ENV" = "prod" ]; then
#    __sync_remote "
#      ln -sfn '$_prod_secret_path' '$BUILD_AT/config/prod.secret.exs'
#   "
#  fi
#}

举个例子 🌰 我某次的配置文件

#!/usr/bin/env bash

APP="habit"

# 自动以 git revision 作为发布名称
AUTO_VERSION="revision"

BUILD_HOST="url"
BUILD_USER="web"
BUILD_AT="/tmp/edeliver/habit/builds"

# 我只有正式环境，所以没有配置 STAGING 环境
PRODUCTION_HOSTS="url"
PRODUCTION_USER="web"

DELIVER_TO="/home/web/"

# 换用了国内的源，加快依赖安装速度
HEX_MIRROR_URL="https://hexpm.upyun.com"

配置好后，执行以下命令。每次构建的压缩包，不记录到 git 记录里

echo ".deliver/releases/" >> .gitignore

提交刚才配置文件的修改，并且下载依赖编译

git add -A && git commit -m "Setting up edeliver"
mix do deps.get, compile

第三步：配置项目

config/prod.exs 部署配置添加一下内容

http: [port: 26_000],
load_from_system_env: true,
server: true

第四步：配置环境变量

前面说了，现在敏感信息都从服务器的系统变量中取，我们把以下变量配置到 ~/.profile 文件：

export SECRET_KEY_BASE='b8qq2J2a7YBNwwoL91Y2BpG/AJSaG0uOqy9JA7Cy+D1tWZKuSiLNXRblfSwNV/7e'
export PORT=26000
export POOL_SIZE=10
export DATABASE_URL='ecto://USER:PASSWORD@HOST/DATABASE'

根据自己的项目替换以上变量。

SECRET_KEY_BASE 是使用 mix phx.gen.secret 命令生成的，在本地的项目执行一下，粘贴过来即可。

创建好数据库后，就可以使用以下命令启动发布应用

第五步：配置数据库

phoenix 默认使用的 postgreSQL 数据库

切换到默认用户 postgres

sudo su - postgres

进入数据库

psql

创建用户并赋予权限

CREATE USER www WITH PASSWORD 'u867#eDgg6#2@elo098OIUh';

CREATE DATABASE habit_prod OWNER www;

alter role www login createdb;

创建数据库

现在使用以下命令创建线上数据库的数据表

mix edeliver migrate production

第六步：部署

edeliver 基本命令


其他的配置可以参考 [项目文档](https://github.com/edeliver/edeliver)

```glsl
mix edeliver update production --start-deploy # 发布应用并启动

--branch=dev 指定使用 dev 分支 默认使用的 master

--verbose 部署的时候打印详细的信息

mix edeliver ping production # 查看应用是否正在运行
mix edeliver upgrade  # 升级应用

mix edeliver version production # 查看应用的版本
mix edeliver migrate production # 运行数据库构建 执行该命令前要先部署应用
mix edeliver restart production # 或者 start 或者 stop

migrate 数据库迁移命令

🔔 注意执行以下的命令之前，要先部署应用。

mix edeliver migrate production  # 运行数据库构建
mix edeliver migrate production up # 同上面的命令
mix edeliver migrate production down # 逆向执行数据库构建 会删除所有的数据表和数据
mix edeliver show migrations production # 执行上面的 down 命令后会显示状态

其他

日志

如果不幸，发布出现问题。可以在一下目录查看日志

配置文件里的 DELIVER_TO="/home/web/" 就是我们项目的部署目录，对应的日志文件也在这里。比如我的：/home/web/habit/log

tail -f erlang.log.1

查看端口使用

lsof -i :80

netstat -tlunp

netstat -anp|grep 80

可能会用到的文章

Elixir Phoenix 1.4 Deployments with Distillery and Edeliver on Ubuntu

感谢您的阅读。 🙏 关于转载请看这里