Docker compose example project with proxy support

README.md

How to use

Requirements

1. Docker v20.10.17+
2. Docker Compose v2.6.0

Proxy setup

If you're behind a Proxy, make sure you add your proxy settings in your own ~/.docker/config.json file using the example described here: https://docs.docker.com/network/proxy/#configure-the-docker-client

Build and Run

You can now use these simple commands to build and run your docker-compose project (with or without proxy):

# Builds containers with `build` sections defined
$ make

# Starts the stack
$ make start

# Get logs from the stack
$ make logs

# Stops the stack
$ make stop

# Restarts the stack
$ make restart

# Cleanup everything ( useful for fresh starts )
$ make clean

docker-compose.yaml

version: "3.8"

services:

  example:
    # It is important to define this one so the container is seen as "one" between build and start/restart/stop
    image: example:latest
    # Build a local container
    build:
      context: .
      dockerfile: Dockerfile
      # Use this network to ensure custom domains are resolved using your own DNS and not Google DNS
      network: host
    # Run the container within a custom network
    networks:
      - example

networks:
  example:

Dockerfile

FROM alpine:latest

Makefile

###############################################################################
# ENVIRONMENT CONFIGURATION
###############################################################################
MAKEFLAGS += --no-print-directory
SHELL=/bin/bash

# Use default as default goal when running 'make'
.PHONY: default
.DEFAULT_GOAL := default

###############################################################################
# GOALS ( safe defaults )
###############################################################################

# 'docker buildx bake' approach is required since it is able to inherit
# proxy configuration unlike 'docker-compose build/up'
default:
	@docker buildx bake -f docker-compose.yml

start:
	@docker-compose up --detach

restart:
	@docker-compose restart

stop:
	@docker-compose stop

logs:
	@docker-compose logs -f

clean:
	@docker-compose down --rmi all --remove-orphans --volumes