This document discusses various tools for deploying Elixir applications to production including Distillery, eDeliver, Conform, and Heroku. Distillery compiles and packages Elixir applications. eDeliver builds applications on remote servers and deploys to staging and production. Conform injects configuration settings into releases. The document provides instructions for using these tools and considerations for managing configuration across environments.

1. 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

2. 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?

3. 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

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

5. 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

6. ./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
...

7. ./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>

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

9. 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

10. .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"

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

12. 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

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

14. 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">>}]}]}].

15. 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">> }]}]}].

16. 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

17. <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
# …

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

19. CONFORM INJECTS SETTINGS
var/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, <<”acme.com">> },{port,{system,<<"PORT">>}}]},
{cache_static_manifest,<<"priv/static/cache_manifest.json">>},
{server,true},
{root,<<".">>},
{version,"0.0.1"},
{secret_key_base,
<<”super secret">> }]}]}].

20. 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

21. 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

22. 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