Convert the SSL hello world example to a release

examples/ssl_hello_world/Makefile

@@ -0,0 +1,14 @@
+PROJECT = ssl_hello_world
+
+DEPS = cowboy
+dep_cowboy = pkg://cowboy master
+
+.PHONY: release clean-release
+
+release: clean-release all
+	relx
+
+clean-release:
+	rm -rf _rel
+
+include ../../erlang.mk

examples/ssl_hello_world/README.md

@@ -1,23 +1,27 @@
-Cowboy Hello World
-==================
+Hello world example
+===================
 
-To compile this example you need rebar in your PATH.
+To try this example, you need GNU `make`, `git` and
+[relx](https://github.com/erlware/relx) in your PATH.
 
-Type the following command:
-```
-$ rebar get-deps compile
+To build the example, run the following command:
+
+``` bash
+$ make
 ```
 
-You can then start the Erlang node with the following command:
-```
-./start.sh
+To start the release in the foreground:
+
+``` bash
+$ ./_rel/bin/ssl_hello_world_example console
 ```
 
-Then point your browser to the indicated URL. You will need to temporarily
-trust the root certificate authority in `priv/ssl/cowboy-ca.crt`.
+Then point your browser at [http://localhost:8443](http://localhost:8443).
+You will need to temporarily trust the root certificate authority,
+which can also be found in `priv/ssl/cowboy-ca.crt`.
 
-Example
--------
+Example output
+--------------
 
 ``` bash
 $ curl --cacert priv/ssl/cowboy-ca.crt -i https://localhost:8443

examples/ssl_hello_world/rebar.config

@@ -1,4 +0,0 @@
-{deps, [
-	{cowboy, ".*",
-		{git, "git://github.com/extend/cowboy.git", "master"}}
-]}.

examples/ssl_hello_world/relx.config

@@ -0,0 +1,2 @@
+{release, {ssl_hello_world_example, "1"}, [ssl_hello_world]}.
+{extended_start_script, true}.

examples/ssl_hello_world/src/ssl_hello_world.app.src

@@ -8,7 +8,8 @@
 	{applications, [
 		kernel,
 		stdlib,
-		cowboy
+		cowboy,
+		ssl
 	]},
 	{mod, {ssl_hello_world_app, []}},
 	{env, []}

examples/ssl_hello_world/src/ssl_hello_world.erl

@@ -1,15 +0,0 @@
-%% Feel free to use, reuse and abuse the code in this file.
-
--module(ssl_hello_world).
-
-%% API.
--export([start/0]).
-
-%% API.
-
-start() ->
-	ok = application:start(crypto),
-	ok = application:start(cowlib),
-	ok = application:start(ranch),
-	ok = application:start(cowboy),
-	ok = application:start(ssl_hello_world).

examples/ssl_hello_world/src/ssl_hello_world_app.erl

@@ -16,11 +16,12 @@ start(_Type, _Args) ->
 			{"/", toppage_handler, []}
 		]}
 	]),
+	PrivDir = code:priv_dir(ssl_hello_world),
 	{ok, _} = cowboy:start_https(https, 100, [
 		{port, 8443},
-		{cacertfile, "priv/ssl/cowboy-ca.crt"},
-		{certfile, "priv/ssl/server.crt"},
-		{keyfile, "priv/ssl/server.key"}
+		{cacertfile, PrivDir ++ "/ssl/cowboy-ca.crt"},
+		{certfile, PrivDir ++ "/ssl/server.crt"},
+		{keyfile, PrivDir ++ "/ssl/server.key"}
 	], [{env, [{dispatch, Dispatch}]}]),
 	ssl_hello_world_sup:start_link().
 

examples/ssl_hello_world/src/toppage_handler.erl

@@ -11,7 +11,9 @@ init(_Transport, Req, []) ->
 	{ok, Req, undefined}.
 
 handle(Req, State) ->
-	{ok, Req2} = cowboy_req:reply(200, [], <<"Hello world!">>, Req),
+	{ok, Req2} = cowboy_req:reply(200, [
+		{<<"content-type">>, <<"text/plain">>}
+	], <<"Hello world!">>, Req),
 	{ok, Req2, State}.
 
 terminate(_Reason, _Req, _State) ->

examples/ssl_hello_world/start.sh

@@ -1,3 +0,0 @@
-#!/bin/sh
-erl -pa ebin deps/*/ebin -s ssl_hello_world \
-	-eval "io:format(\"Point your browser at https://localhost:8443~n\")."