Elixir Deployment Tools

Elixir Deployment Tools
A A R O N R E N N E R
@ b a y f i e l d c o d e r

Use heroku?
HOW DO I RUN IN PRODUCTION?
Just run: MIX_ENV=prod mix phx.server
https://oscar.ofm.co.za/img/fr_201691716455.jpg
What’s in the Elixir ecosystem? OTP Releases?

DISTILLERY
• Compiles and packages your
application with the erlang vm so it
can be deployed to clean machine
https://openclipart.org/detail/26101/cardboard-box-package

SETTING UP
• Install in mix.exs
• mix deps.get
• mix release.init
• Follow Use Distillery with Phoenix Guide

MIX_ENV=prod mix release
• Creates a folder in _build/prod/rel/my_app
my_app master % ls
bin erts-9.0 lib releases var

./bin/<app_name>
Usage: my_app <task>
Service Control
=======================
start # start my_app as a daemon
start_boot <file> # start my_app as a daemon, but supply a
custom .boot file
foreground # start my_app in the foreground
console # start my_app with a console attached
console_clean # start a console with code paths set but
no apps loaded/started
...

./bin/<app_name>
Usage: my_app <task>
start # start my_app as a daemon
stop # stop the my_app daemon
remote_console # remote shell to my_app's console
ping # checks if my_app is running
upgrade <version> # upgrade my_app to <version>

HOW DO WE SHIP IT?
my_app master % ls
bin erts-9.0 lib releases var

EDELIVER
• Builds your application on a remote
build server and then deploys it to
staging/production servers
http://clipartix.com/wp-content/uploads/2016/04/Airplane-clipart-no-background-free-clipart-images.jpg

.deliver/config
#!/usr/bin/env bash
APP=”my_app”
BUILD_HOST="build-system.acme.org”
BUILD_USER="build
BUILD_AT="/tmp/my_app/builds
DELIVER_TO="/srv/my_app"
STAGING_HOSTS=”staging1.acme.org staging2.acme.org”
STAGING_USER=”staging”
PRODUCTION_HOSTS=”app1.acme.org app2.acme.org"
PRODUCTION_USER="production"

BUILD AND DEPLOY
• mix edeliver build release
• mix edeliver deploy release to [staging | production]
• mix edeliver start [staging | production]
• mix edeliver ping [staging | production]

ONE BUILD TO MULTIPLE ENVIRONMENTS
v0.0.1
http://i.istockimg.com/file_thumbview_approve/17278421/3/stock-illustration-17278421-glowing-green-box.jpg
staging1 prod3prod2prod1

WHERE CONFIG IS COMPILED
config/config.exs releases/<vsn>/sys.config

MANAGING CONFIG
releases/<version>/sys.config
[{sasl,[{errlog_type,error}]},
{logger,
[{console,
[{format,<<"$time $metadata[$level] $messagen">>},
{metadata,[request_id]}]},
{level,info}]},
{distillery_example,
[{'Elixir.DistilleryExampleWeb.Endpoint',
[{render_errors,
[{view,'Elixir.DistilleryExampleWeb.ErrorView'},
{accepts,[<<"html">>,<<"json">>]}]},
{pubsub,
[{name,'Elixir.DistilleryExample.PubSub'},
{adapter,'Elixir.Phoenix.PubSub.PG2'}]},
{load_from_system_env,true},
{url,[{host,<<"example.com">>},{port,{system,<<"PORT">>}}]},
{cache_static_manifest,<<"priv/static/cache_manifest.json">>},
{server,true},
{root,<<".">>},
{version,"0.0.1"},
{secret_key_base,
<<"qhKyagfd2eswVGdgQMIZzfbO4Hi6Vr8J0Y3GR67SHvG7EPNODK6z+d0haLkx7HYy">>}]}]}].

MANAGING CONFIG
{logger,
[{console,
{level,info}]},
[{render_errors,
{accepts,[<<"html">>,<<"json">>]}]},
{pubsub,
{url,[{host, <<"example.com">> },{port,{system,<<"PORT">>}}]},
{server,true},
{root,<<".">>},
{version,"0.0.1"},
{secret_key_base,
<<"qhKyagfd2eswVGdgQMIZzfbO4Hi6Vr8J0Y3GR67SHvG7EPNODK6z+d0haLkx7HYy">> }]}]}].

CONFORM
• Injects settings into the sys.config
when your application is starting up
http://www.clker.com/cliparts/W/F/s/r/d/6/gear-md.png

<deploy_dir>/<app_name>.conf
# Secret key base for sessions. Needs to be the same across app servers
my_app.secret_key_base = “super secret”
# Hostname to use when generating urls
my_app.url.host = “acme.com”
# More custom settings
# …

CONFORM
<app_name>.conf
var/sys.config
+
=

CONFORM INJECTS SETTINGS
var/sys.config
{logger,
[{console,
{level,info}]},
[{render_errors,
• {accepts,[<<"html">>,<<"json">>]}]},
{pubsub,
{url,[{host, <<”acme.com">> },{port,{system,<<"PORT">>}}]},
{server,true},
{root,<<".">>},
{version,"0.0.1"},
{secret_key_base,
<<”super secret">> }]}]}].

THINGS TO KEEP IN MIND
@api_key Application.get_env(:my_app, :api_key)
DON’T: compile settings into module attributes
DO: Create functions for easier access
def api_key do
Application.get_env(:my_app, :api_key)
end

TOOL CHAIN
BITWALKER/CONFORM
http://www.clker.com/cliparts/W/F/s/r/d/6/gear-md.png
Inject settings into
sys.config
EDELIVER/EDELIVER
Remote Builds and
Deployment
BITWALKER/DISTILLERY
Package
Application

THANK YOU!
WE’RE HIRING
A A R O N R E N N E R
@ b a y f i e l d c o d e r

Elixir Deployment Tools

More Related Content

What's hot (20)

Similar to Elixir Deployment Tools (20)

Recently uploaded (20)

Elixir Deployment Tools