The Project | About Us | Contribute | Donations | License
HOME My courses Completed
◄ Previous
◄

Introduction to Docker Compose

Next ►
►

Docker Compose is a tool for defining and running multi-container Docker applications. With Compose, you use a YAML file to configure your application’s services. Then, with a single command, you create and start all the services from your configuration.

Key Concepts

  1. Services: A service is a definition of how a container should run. It includes the image to use, the ports to expose, environment variables, and other configurations.
  2. Networks: Networks allow containers to communicate with each other. Docker Compose automatically creates a default network for your services.
  3. Volumes: Volumes are used to persist data generated by and used by Docker containers.

Why Use Docker Compose?

  • Simplified Configuration: Define your multi-container application in a single file.
  • Easy to Use: Start your entire application with a single command.
  • Environment Management: Easily manage different environments (development, testing, production) with different configurations.
  • Scalability: Scale your services up or down with a single command.

Installing Docker Compose

Docker Compose is included in Docker Desktop for Windows and Mac. For Linux, you can install it using the following commands:

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep -Po '"tag_name": "\K.*\d')" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

Basic Docker Compose File Structure

A Docker Compose file is written in YAML and typically named docker-compose.yml. Here is a basic example:

version: '3'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
  db:
    image: postgres:latest
    environment:
      POSTGRES_PASSWORD: example

Explanation

  • version: Specifies the version of the Docker Compose file format.
  • services: Defines the services that make up your application.
    • web: A service named web using the nginx:latest image and mapping port 80 on the host to port 80 in the container.
    • db: A service named db using the postgres:latest image and setting an environment variable POSTGRES_PASSWORD.

Running Docker Compose

To start the services defined in your docker-compose.yml file, navigate to the directory containing the file and run:

docker-compose up

To run the services in the background (detached mode), use:

docker-compose up -d

To stop the services, use:

docker-compose down

Practical Example

Let's create a simple web application with a frontend and a backend using Docker Compose.

Step 1: Create the Project Directory

mkdir myapp
cd myapp

Step 2: Create the docker-compose.yml File

version: '3'
services:
  frontend:
    image: nginx:latest
    ports:
      - "8080:80"
  backend:
    image: node:latest
    command: node -e "require('http').createServer((req, res) => res.end('Hello from backend')).listen(3000)"
    ports:
      - "3000:3000"

Step 3: Run Docker Compose

docker-compose up

Step 4: Access the Application

  • Open your browser and navigate to http://localhost:8080 to see the frontend.
  • Navigate to http://localhost:3000 to see the backend.

Summary

In this section, we introduced Docker Compose, a powerful tool for managing multi-container Docker applications. We covered the basic concepts, installation, and a simple example to get you started. Docker Compose simplifies the process of defining and running complex applications, making it an essential tool for modern development workflows.

Next, we will dive deeper into defining services in Docker Compose, exploring more advanced configurations and use cases.

◄ Previous
◄
Next ►
►
The Project | About Us | Contribute | Donations | License
© Copyright 2024. All rights reserved