Getting started with Docker

Great news!! Since v0.10 release aah provides Docker Image on Docker Hub and aah CLI command to generate Dockerfile config.

aah has automated build process for Docker Image creation. Supported Docker tags are -

• aahframework/aah:latest - Latest production release.
• aahframework/aah:{version} - Specific release version, for e.g.: aahframework/aah:v0.9.
• aahframework/aah:edge - Latest development edge version.

Table of Contents

• Pull aah Docker Image
• Handy generate Command
• Using Dockerfile.*
• Compile aah application inside the Docker container

Pull aah Docker Image

Pull docker image from Docker Hub.

# Pull latest production release
docker pull aahframework/aah:latest

# Pull edge version
docker pull aahframework/aah:edge

# Pull specific version
docker pull aahframework/aah:v0.9

Handy generate Command

aah CLI includes generate command to help developers in their application development path. This command generates two docker files -

• Dockerfile.dev - For development usage with aah docker image.
• Dockerfile.prod - Using Multistage-build to create very small docker image for production purpose. More info, refer to https://docs.docker.com/develop/develop-images/multistage-build/.

Example

# run from anywhere
aah generate script --name docker --importpath github.com/user/appname

# OR if you're in app directory or path
aah generate script --name docker

# OR short form
aah g s -n docker

Using Dockerfile.*

To Build Docker Image

# Using Dockerfile.dev
docker build --no-cache -t "yourapp:dev" -f Dockerfile.dev .

# Using Dockerfile.prod
docker build --no-cache -t "yourapp:latest" -f Dockerfile.prod .

Running built Docker Image

# To run Dockerfile.dev image
# To stop press Ctrl + C
docker run -it -p 8080:8080 "yourapp:dev" aah run

# To run Dockerfile.prod image
# To stop, do it via container stop
docker run -p 8080:8080 "yourapp:latest"

Compile aah application inside the Docker container

There might a occasions you would like to build your application inside the container and get the build artifact. You can write something like:

docker run --rm -v "$PWD":/go/src/github.com/user/appname -w /go/src/github.com/user/appname aahframework/aah:latest aah build