Multiple Compose files (override) in Docker - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the purpose of using multiple Docker Compose files with overrides?

Using multiple Compose files allows you to customize or extend your base configuration without changing the original file. Overrides can add, change, or remove settings for different environments like development or production.

beginner

How do you apply an override Compose file when running Docker Compose commands?

You use the -f option multiple times, for example: docker compose -f docker-compose.yml -f docker-compose.override.yml up. The later files override or add to the settings in the earlier files.

intermediate

What happens if the same service property is defined in both the base and override Compose files?

The property in the override file replaces or merges with the base file's property depending on the type. For example, environment variables are merged, but ports or image names are replaced.

beginner

True or False: Docker Compose automatically uses docker-compose.override.yml if it exists.

True. If you run docker compose up without specifying files, Docker Compose automatically looks for docker-compose.override.yml and applies it on top of docker-compose.yml.

beginner

Why is using multiple Compose files with overrides helpful in real projects?

It helps keep your base configuration clean and reusable. You can add environment-specific settings like debug mode or different volumes without changing the main file, making it easier to manage and share.

Which command correctly applies an override Compose file named docker-compose.dev.yml?

A docker compose -override docker-compose.dev.yml up

B docker compose -f docker-compose.yml -f docker-compose.dev.yml up

C docker compose override docker-compose.dev.yml up

D docker compose up -f docker-compose.dev.yml

Use multiple -f options to specify base and override files in order.

If both base and override Compose files define environment variables for a service, what happens?

A Only the base file's environment variables are used

B An error occurs due to conflict

C Only the override file's environment variables are used

D Environment variables from both files are merged

Environment variables are merged, with override values replacing duplicates.

What is the default override file name Docker Compose looks for automatically?

A docker-compose.extra.yml

B docker-compose.dev.yml

C docker-compose.override.yml

D docker-compose.prod.yml

Docker Compose automatically applies docker-compose.override.yml if it exists.

Why might you want to use multiple Compose files instead of one big file?

A To separate environment-specific settings cleanly

B Because Docker Compose requires multiple files

C To confuse team members

D To avoid using volumes

Multiple files help keep environment-specific settings separate and manageable.

If a port is defined in both base and override Compose files, which one is used?

A Only the override file's port is used

B Only the base file's port is used

C Both ports are used

D Ports are combined automatically

Scalar properties like ports are replaced by the override file's value.

Explain how Docker Compose uses multiple Compose files to override settings. Include how to run commands with overrides.

Think about how you can layer configurations like adding clothes for different weather.

Describe the benefits of using multiple Compose files with overrides in a project.

Consider how you organize your wardrobe for different occasions.

Practice

1. What is the main purpose of using multiple Docker Compose files with the -f option?

easy

A. To override or extend settings without changing the original compose file

B. To run multiple containers simultaneously

C. To create multiple Docker images at once

D. To speed up Docker container startup time

Solution

1. Step 1: Understand the role of multiple Compose files

   Multiple Compose files allow you to customize or override configurations without editing the original file.

2. Step 2: Recognize the use of the -f option

   The -f option lets you specify multiple files, where later files override earlier ones.

3. Final Answer:

   To override or extend settings without changing the original compose file -> Option A

4. Quick Check:

   Multiple Compose files = override settings [OK]

Hint: Multiple files with -f override earlier settings [OK]

Common Mistakes:

• Thinking multiple files run containers simultaneously
• Confusing Compose files with Docker images
• Assuming it speeds up container startup

2. Which of the following is the correct syntax to use two Docker Compose files named docker-compose.yml and docker-compose.override.yml together?

easy

A. docker-compose up -f docker-compose.yml -f docker-compose.override.yml

B. docker-compose -f docker-compose.yml -f docker-compose.override.yml up

C. docker-compose up docker-compose.yml docker-compose.override.yml

D. docker-compose -f up docker-compose.yml docker-compose.override.yml

Solution

1. Step 1: Recall the correct order of options

   The -f option must come before the command and can be repeated for multiple files.

2. Step 2: Verify the syntax correctness

   docker-compose -f docker-compose.yml -f docker-compose.override.yml up correctly places -f flags before the up command and lists both files.

3. Final Answer:

   docker-compose -f docker-compose.yml -f docker-compose.override.yml up -> Option B

4. Quick Check:

   Correct order: docker-compose -f file1 -f file2 up [OK]

Hint: Place all -f options before the command [OK]

Common Mistakes:

• Putting -f after the command
• Listing files without -f
• Mixing command and file order

3. Given these two Compose files:

docker-compose.yml:
services:
  web:
    image: nginx:1.19
    ports:
      - "80:80"

docker-compose.override.yml:
services:
  web:
    image: nginx:1.21
    environment:
      - DEBUG=true

What image version will the web service use when running docker-compose -f docker-compose.yml -f docker-compose.override.yml up?

medium

A. nginx:1.19

B. nginx:latest

C. It will cause an error due to conflicting images

D. nginx:1.21

Solution

1. Step 1: Understand override behavior

   The second file overrides matching keys from the first file, including the image version.

2. Step 2: Identify the image in the override file

   The override file sets image: nginx:1.21, which replaces nginx:1.19.

3. Final Answer:

   nginx:1.21 -> Option D

4. Quick Check:

   Override file image replaces base image [OK]

Hint: Later files override earlier image settings [OK]

Common Mistakes:

• Assuming base file image stays unchanged
• Thinking it defaults to latest
• Expecting an error from override

4. You run docker-compose -f base.yml -f override.yml up but get an error: ERROR: Service 'app' has both 'build' and 'image' specified. What is the likely cause?

medium

A. Both files define 'app' service with conflicting 'build' and 'image' keys

B. You forgot to specify the -d flag

C. The override file is missing the 'app' service definition

D. Docker Compose does not support multiple files

Solution

1. Step 1: Understand the error message

   The error says the 'app' service has both 'build' and 'image' keys, which Docker Compose disallows.

2. Step 2: Identify conflict from multiple files

   When combining files, if one file sets 'build' and another sets 'image' for the same service, this conflict occurs.

3. Final Answer:

   Both files define 'app' service with conflicting 'build' and 'image' keys -> Option A

4. Quick Check:

   Conflicting keys in combined files cause this error [OK]

Hint: Check for conflicting keys in combined service definitions [OK]

Common Mistakes:

• Thinking -d flag fixes this error
• Assuming missing service causes error
• Believing multiple files are unsupported

5. You have a base Compose file docker-compose.yml and an override docker-compose.prod.yml that changes the web service's environment variables and ports. You want to run the production setup but keep the base file unchanged. Which command correctly applies the override and ensures the web service uses the production settings?

hard

A. docker-compose up -f docker-compose.yml -f docker-compose.prod.yml -d

B. docker-compose -f docker-compose.prod.yml -f docker-compose.yml up -d

C. docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

D. docker-compose up -d -f docker-compose.yml -f docker-compose.prod.yml

Solution

1. Step 1: Recall override order

   The last file listed with -f overrides earlier files.

2. Step 2: Check command syntax and order

   docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d correctly lists base file first, then production override, followed by the up -d command.

3. Final Answer:

   docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d -> Option C

4. Quick Check:

   Last -f file overrides earlier ones [OK]

Hint: List base file first, override file second with -f [OK]

Common Mistakes:

• Reversing file order so base overrides override
• Placing -f after the command
• Omitting -d for detached mode