adersberger/intellij-docker-tutorial: Tutorial on how to use Docker within intelliJ -

= intelliJ ♥ Docker Tutorial :imagesdir: ./img

A short tutorial on how to use Docker within intelliJ and with a little help from Gradle.

== Prerequisites

install intelliJ Docker plugin
install Docker Machine (https://docs.docker.com/machine/get-started)
check that there is a default Docker Machine: docker-machine ps. If there is no default machine create one: docker-machine create --driver virtualbox default.
start the default Docker Machine: docker-machine start default.
bind the env vars to the shell: eval "$(docker-machine env default)"
check if everything is correct: docker ps

== Using Docker with intelliJ

image::pic-1.png[Setup Docker Cloud Provider]

TIP: You can get the API URL by executing docker-machine ls and using the shown IP & port for the default machine.

image::pic-2.png[Check connection in "Docker" tab]

Create new project from version control using github (https://github.com/adersberger/intellij-docker-tutorial.git)
Create a new run configuration to deploy application to Docker as shown on the following screenshots:

image::pic-4.png[First tab]

TIP: Be sure not to forget to add the Gradle tasks as a "before launch" action as shown at the very bottom of the screenshot.

image::pic-5.png[First tab]

TIP: The same is also possible for Docker Compose files. Just point the "Deployment" dropdown to the Docker Compose file.

Run the configuration and inspect the Docker container. A browser will open automagically and point to the REST endpoint. Within intelliJ you can access the containers console output, environment variables, port bindings etc.

image::pic-3.png[First tab]

== Sources

Docker intelliJ Help: https://www.jetbrains.com/help/idea/2016.1/docker.html
Docker intelliJ Plugin: https://plugins.jetbrains.com/plugin/7724
Blog post on Docker intelliJ: https://blog.jetbrains.com/idea/2015/03/docker-support-in-intellij-idea-14-1

intellij-docker-tutorial
intellij-docker-tutorial copied to clipboard