In order to do something useful with containers, they need to be organized as a part of a project, usually referred to as an application. There are multiple ways of orchestrating a Docker application, but Docker Compose is perhaps the most human-friendly. It is a tool for defining and running multi-container Docker applications. It allows users to launch, execute, communicate and shut containers with one coordinated command.
It makes it easier for users to orchestrate the processes of Docker containers, including starting up, shutting down, and setting up intra-container linking and volumes.
In this blog, I’ve covered
- What is Docker Compose
- Why Docker Compose
- Features
- Common use cases
- Install Docker Compose
- Containerise Application using Docker Compose
- Docker-compose file
- Dockerfile vs docker-compose
What is Docker Compose?
Compose is a tool for defining and running multi-container Docker applications. With Compose, you utilize a YAML file to configure your application’s services. Then, with one command, you create and begin all the services from your configuration. Compose works in all environments: production, staging, development, testing, as well as CI workflows.
Using Compose is basically a three-step process:
- Define your app’s environment with a Dockerfile so it can be reproduced anywhere.
- Define the services that make up your app in docker-compose.yml so they can be run together in an isolated environment.
- Run docker-compose up and Compose starts and runs your entire app.
Why Docker Compose?
Docker has made it easier to set up a local development environment. However, if you want to create more than one container for your application, you have to create several Docker files. This adds to a load of maintaining them and is also quite time-consuming.
It solves this problem by allowing you to use a YAML file to operate multi-container applications at once. You can set the desired amount of containers counts, their builds, and storage designs, and then with a single set of commands, you can build, run, and configure all the containers.
Features
The features of Compose that make it effective are:
- Multiple isolated environments on one host.
- Preserve volume data once containers are created.
- Only recreate containers that have modified.
- Variables and moving a composition between the environment.
Common use cases
Compose can be used in many different ways. Some common use cases are outlined below.
Development environments
When you’re developing software, the ability to run an application in an isolated environment and interact with it’s crucial. The Compose command-line tool can be used to create the environment and interact with it.
Automated testing environments
An important part of any Continuous Deployment or Continuous Integration method is the automated test suite. Automated end-to-end testing requires an environment in which to run tests. Compose provides a convenient way to create and destroy isolated testing environments for your test suite.
Compose file, you can create and destroy these environments in just a few commands:
$ docker-compose up -d $ ./run_tests $ docker-compose down
Install Docker Compose
Follow the steps below to install the version from its official GitHub repository. You’ll be able to install it from the Ubuntu repository by running sudo apt install docker-compose. However, this option doesn’t guarantee you’re downloading the recent version.
Step 1: Upgrade and Update
Start by updating the default repository to ensure you download the latest Docker Compose:
sudo apt update
Then, upgrade the system to ensure all local packages and programs are up to date:
sudo apt upgrade
Step 2: Install curl
To download the binary package using an URL, you need curl. You can check whether you have this command-line utility by typing in the terminal window:
curl
If the output displays try 'curl --help' or 'curl --manual' for more information
, move on to the next step. This message means curl is installed.
However, if the terminal says command not found
, you need to install curl with:
sudo apt install curl
Step 3: Download the Latest Docker Version
Use the following command:
sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
The command instructs the system to save the file in the /usr/local/bin/ directory, under the name docker-compose.
Wait for the download to complete.
Step 4: Change File Permission
Make the downloaded file executable by changing the file permission with:
sudo chmod +x /usr/local/bin/docker-compose
Step 5: Check the Version
To verify the installation, check the Docker Compose version by running:
docker–compose –version
If the output shows the release downloaded in Step 3, you have successfully installed the package.
Containerize Application using Docker Compose
Convert an application deployment into a stack using a file named docker-compose.yml
Step 1: Start with installing docker-compose
$ sudo apt-get update -y $ sudo apt install docker-compose -y
Step 2: Create a directory for the project
$ mkdir stackdemo $ cd stackdemo
Step 3: Create a file called app.py in the project directory and the below code
$ vim app.py
Then, add the following code in it:
import time import redis from flask import Flask app = Flask(__name__) cache = redis.Redis(host='redis', port=6379) def get_hit_count(): retries = 5 while True: try: support@k21academy.com 40 return cache.incr('hits') except redis.exceptions.ConnectionError as exc: if retries == 0: raise exc retries -= 1 time.sleep(0.5) @app.route('/') def hello(): count = get_hit_count() return 'Hello World! I have been seen {} times.\n'.format(count)
Step 4: Create a file called requirements.txt
Add the following text in it:
flask redis
Step 5: Create a file called Dockerfile
$ vim Dockerfile
Add the following code in it:
FROM python:3.7-alpine WORKDIR /code ENV FLASK_APP app.py ENV FLASK_RUN_HOST 0.0.0.0 RUN apk add --no-cache gcc musl-dev linux-headers COPY requirements.txt requirements.txt RUN pip install -r requirements.txt COPY . . CMD ["flask", "run"]
Note: when you copy this file from here Please retype the [“ ”] again manually otherwise in later steps you will get the error. When you copy this from here the double quotes need to type again in the file.
Step 6: Create a file named docker-compose.yml
$ vim docker-compose.yml
Add the following code in it:
version: '3' services: web: build: . ports: - "5000:5000" redis: image: "redis:alpine"
Step 7: Build and run the application
$ docker-compose up -d
Step 8: Verify the application running
Enter http://hostip:5000/ in a browser to see the application running
Step 9: List the application running as part of the stack using compose commands.
$ docker-compose ps
$ docker ps
Step 10: Edit the Compose file to add a bind mount
Edit docker-compose.yml in to add a bind mount for the web service:
Note: Know more about Docker Storage
Step 11: Re-build and run the app with Compose
Step12: Update the application without having to re-build it
Because the application code is now mounted into the container using a volume, we can make changes to its code and see the changes instantly, without having to rebuild the image.
Open a new terminal and change the greeting in app.py and save it. For example, change the Hello World! message to Hello from Docker Container!:
Step13: Verify the application running is updated on the fly
Enter http://hostip:5000/ in a browser to see the application running
Step 14: Bring the application down
$ docker-compose down
Docker Compose.yml file
To configure the orchestration, Docker Compose uses a docker-compose.yml
file. It specifies what images are required, what ports they need to expose, whether or not they have access to the host filesystem, what commands should be run when they start up, and so on. A docker-compose.yml file which uses Dockerfile, but also adds a database to the stack. This docker-compose.yml file looks like:
version: '3' services: web: build: . ports: - "8080:80" db: image: mysql ports: - "3306:3306" environment: - MYSQL_ROOT_PASSWORD=password - MYSQL_USER=user - MYSQL_PASSWORD=password - MYSQL_DATABASE=demodb
With docker-compose.yml file, you’ll write once and use it often. So craft a Dockerfile for an element of the stack and re-use it for multiple stacks, by way of docker-compose.yml. Remember, docker-compose.yml files are used for defining and running multi-container Docker applications, whereas Dockerfiles are simple text files that contain the commands to assemble an image which will be used to deploy containers.
So the workflow looks like this:
- Create Dockerfiles to build images.
- Define complex stacks (comprising of individual containers) based on those Dockerfile images from within docker-compose.yml.
- Deploy the entire stack with the docker-compose command.
Dockerfile vs Docker-Compose
A Dockerfile is a text document that contains all the commands/Instructions a user could call on the command line to assemble an image. Using docker build command we can build an image from a Dockerfile.
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. By default, it expects the name of the Compose file as docker-compose.yml or docker-compose.yaml. If the compose file has a different name we can specify it with -f flag.
Related/References
- Visit our YouTube channel on “Docker & Kubernetes”
- Docker Architecture, Docker Engine Components, Container Lifecycle
- Docker Images: A Complete Guide For Beginners
- Docker Networking | Introduction to Docker Network
- Kubernetes vs Docker – Understand the Difference
- Certified Kubernetes Administrator (CKA) Certification Exam
Join FREE Masterclass
To know about what is the Roles and Responsibilities of Kubernetes administrator, why you should learn Docker and Kubernetes, Job opportunities for Kubernetes administrator in the market, and what to study Including Hands-On labs you must perform to clear Certified Kubernetes Administrator (CKA) certification exam by registering for our FREE Masterclass.
The post Docker Compose : Installation & Multicontainer Application Deployment appeared first on Cloud Training Program.