belvedere

This project exists as an example for continuous integration of Elixir on CircleCI.
It also works as a bit of a boilerplate project.

Features:

• Builds your project as a docker container, and automatically pushes it to dockerhub if tests pass
• Runs Dialyzer on your project
• Caches build environment and container layers for quick build times.

HowTo

Getting this going in your project:

• Copy the scripts/ci folder, circle.yml & Dockerfile to your project.
• add {:earmark, "~> 0.1", only: :dev}, {:ex_doc, "~> 0.7", only: :dev} to mix.exs deps
• Update the Erlang and Elixir versions to the latest in the Dockerfile
• Set CIRCLE_PROJECT_REPONAME in the Dockerfile to your project's name
• Make changes to the Docker File as appropriate for your project
• Specify the deps and apps you care about for dialyzer in your mix file. (see our example)
• Add credentials for the Docker.com repo to your CircleCI account (optional for deployment) https://circleci.com/docs/docker
• Add the repo to CircleCI so that the webhook is installed

###Deploying to Docker Hub

This example also deploys the built image to Docker Hub after successfully building and testing. See the deployment section of circle.yml for details on how this is done. Note that three environment variables need to be set on CircleCI for the deployment to work:

• DOCKER_EMAIL - The email address associated with the user with push access to the Docker Hub repository
• DOCKER_USER - Docker Hub username
• DOCKER_PASS - Docker Hub password (these are all stored encrypted on CircleCI, and you can create a deployment user with limited permission on Docker Hub if you like)

Also note that the Docker Hub repository name and Docker registry endpoint are hard-coded into circle.yml and .dockercfg.template respectively and would need to be changed to deploy to a different repository or registry.

###Publish to Hex

• Pull your docker image and run it in a container. e.g. docker pull nirvana/belvedere docker run -i -t CONTAINER_ID
• Authorize your hex user with mix hex.user auth
• Publish the package with mix hex.publish
• Publish the docs with mix hex.docs

##See also

• CircleCI Home
• The CircleCI Docker docs
• The Docker userguide
• Docker Hub
• Hex.docs
• ExDoc
• Hex.publish