Better documenting release process.

Author: GUI

Makefile

@@ -13,7 +13,8 @@ RUNTIME_DEPENDENCIES:=bash curl cut date diff grep mktemp openssl sed
 	install \
 	install-test-deps \
 	lint \
-	test
+	test \
+	release
 
 all: \
 	check-dependencies \
@@ -108,3 +109,18 @@ test:
 	luarocks --tree=/tmp/resty-auto-ssl-server-luarocks make ./lua-resty-auto-ssl-git-1.rockspec
 	luarocks --tree=/tmp/resty-auto-ssl-server-luarocks install dkjson 2.5-2
 	busted ./spec
+
+release:
+	# Ensure the rockspec has been renamed and updated.
+	grep -q -F 'version = "${VERSION}-1"' "lua-resty-auto-ssl-${VERSION}-1.rockspec"
+	grep -q -F 'tag = "v${VERSION}"' "lua-resty-auto-ssl-${VERSION}-1.rockspec"
+	# Ensure the CHANGELOG has been updated.
+	grep -q -F '## ${VERSION} -' CHANGELOG.md
+	# Make sure tests pass.
+	docker-compose run --rm -v "${PWD}:/app" app make test
+	# Check for remote tag.
+	git ls-remote -t | grep -F "refs/tags/v${VERSION}^{}"
+	# Verify LuaRock can be built locally.
+	docker-compose run --rm -v "${PWD}:/app" app luarocks pack "lua-resty-auto-ssl-${VERSION}-1.rockspec"
+	# Upload to LuaRocks
+	docker-compose run --rm -v "${HOME}/.luarocks/upload_config.lua:/root/.luarocks/upload_config.lua" -v "${PWD}:/app" app luarocks upload "lua-resty-auto-ssl-${VERSION}-1.rockspec"

README.md

@@ -370,6 +370,15 @@ $ docker-compose run --rm app make test
 
 The test suite is implemented using nginx' [`Test::Nginx`](https://metacpan.org/pod/Test::Nginx::Socket) cpan module.
 
+### Release Process
+
+To release a new version to LuaRocks:
+
+- Ensure `CHANGELOG.md` is up to date.
+- Move the rockspec file to the new version number (`git mv lua-resty-auto-ssl-X.X.X-1.rockspec lua-resty-auto-ssl-X.X.X-1.rockspec`), and update the `version` and `tag` variables in the rockspec file.
+- Commit and tag the release (`git tag -a vX.X.X -m "Tagging vX.X.X" && git push origin vX.X.X`).
+- Run `make release VERSION=X.X.X`.
+
 ## Credits
 
 **[dehydrated](https://github.com/lukas2511/dehydrated)** is the client used internally that does all the heavy lifting with Let's Encrypt.