Làm quen với Docker Compose
Bài đăng này đã không được cập nhật trong 3 năm
Compose là công cụ giúp định nghĩa và khởi chạy multi-container Docker applications. Trong Compose, chúng ta sử dụng Compose file để cấu hình application’s services. Chỉ với một câu lệnh, lập trình viên có thể dễ dàng create và start toàn bộ các services phục vụ cho việc chạy ứng dụng.
Compose là một công cụ tuyệt với không chỉ dùng cho development, testing, staging environments, mà còn ứng dụng trong CI workflows. Việc sử dụng Docker Compose được tóm lược trong 3 bước cơ bản sau:
- Khai báo app’s environment với Dockerfile.
- Khai báo các services cần thiết để chạy app trong docker-compose.yml.
- Run docker-compose up và Compose sẽ start và run app.
Dưới đây là một ví dụ về file docker-compose.yml:
version: '2'
services:
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
- logvolume01:/var/log
links:
- redis
redis:
image: redis
volumes:
logvolume01: {}
Trong bài viết này chúng ta sẽ thử xây dựng một ứng dụng web Python chạy trên Docker Compose. Ứng dụng này sử dụng Flask framework và lưu trữ hit counter trên Redis. Demo này tương đối dễ hiểu và giúp người đọc làm quen nhanh chóng với Docker compose.
Trước khi bắt tay vào thử hãy đảm bảo bạn đã cài đặt cả Docker Engine & Docker Compose trên máy tính
Step 1: Setup
1. Tạo thư mục cho project
$ mkdir composetest
$ cd composetest
2. Tạo file app.py trong thư mục project với nội dung sau
from flask import Flask
from redis import Redis
app = Flask(__name__)
redis = Redis(host='redis', port=6379)
@app.route('/')
def hello():
count = redis.incr('hits')
return 'Hello World! I have been seen {} times.\n'.format(count)
if __name__ == "__main__":
app.run(host="0.0.0.0", debug=True)
3. Tạo 1 file requirements.txt trong project directory với nội dung sau
flask
redis
Khai báo các application’s dependencies.
Step 2: Tạo Dockerfile
Trong bước này chúng ta tiến hành viết Dockerfile để build ra Docker image. Image này chứa toàn bộ các dependencies mà app Python require, bao gồm cả chính Python.
Trong thư mục project, tạo file name: Dockerfile và paste nội dung sau vào:
FROM python:3.4-alpine
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD ["python", "app.py"]
Chúng ta có thể hiểu đơn giản thành các bước sau:
- Build một image từ image Python 3.4 có sẵn trên Docker hub.
- Thêm thư mục hiện tại . vào thư mục /code bên trong image.
- Thiết lập thư mục làm việc với Docker thành /code.
- Install các Python dependencies.
- Set default command của container là
python app.py
Step 3: Khai báo các services bên trong Compose file
Create một file tên là docker-compose.yml trong thư mục project với nội dung sau:
version: '2'
services:
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
redis:
image: "redis:alpine"
Compose file khai báo 2 services, web & redis:
- Sử dụng image được build từ Dockerfile trong thư mục project.
- Forwards the exposed port 5000 của container sang port 5000 trên host machine.
- Mounts thư mục project trên host sang /code bên trong container, cho phép bạn chỉnh sửa code mà ko cần rebuild image.
Redis service thì sử dụng public Redis image trên Docker Hub registry.
Step 4: Build và run Ứng dụng với Compose
1. Start ứng dụng từ thư mục project
$ docker-compose up
Pulling image redis...
Building web...
Starting composetest_redis_1...
Starting composetest_web_1...
redis_1 | [8] 02 Jan 18:43:35.576 # Server started, Redis version 2.8.3
web_1 | * Running on http://0.0.0.0:5000/
web_1 | * Restarting with stat
Compose kéo Redis image về host và tiến hành build một image cho code, sau đó start services bạn đã khai báo.
2. Vào địa chỉ http://0.0.0.0:5000/ trên trình duyệt sẽ thấy ứng dụng đang chạy
Nếu bạn sử dụng Docker trên Linux, bạn cũng có thể thử vào bằng đường dẫn sau: http://localhost:5000.
Nếu bạn sử dụng Docker Machine trên Mac, hãy dùng lệnh docker-machine ip MACHINE_VM để lấy IP address của Docker host. Sau đó vào bằng đường dẫn sau: http://MACHINE_VM_IP:5000
Bạn sẽ thấy message sau trên trình duyệt:
Hello World! I have been seen 1 times.
3. Refresh lại web page
Số lượng view sẽ tăng lên.
Step 5: Update the application
Như đã đề cập trong step 3, application code đã được mount vào trong container volume, chính vì thế lập trình viên có thể chỉnh sửa code và thấy sự thay đổi này diễn ra tức thì mà không cần rebuild the image.
1. Sửa code file app.py và save lại
return 'Hello from Docker! I have been seen {} times.\n'.format(count)
2. Refresh lại page và mọi thứ đã được cập nhật (dance2)
Step 6: Một vài câu lệnh thông dụng trong Docker compose
Nếu bạn muộn khởi chạy các services bên trong background, hãy thêm flag -d (for “detached” mode) vào lệnh docker-compose up và sử dụng lệnh docker-compose ps để thẩy những gì đang chạy trên host:
$ docker-compose up -d
Starting composetest_redis_1...
Starting composetest_web_1...
$ docker-compose ps
Name Command State Ports
-------------------------------------------------------------------
composetest_redis_1 /usr/local/bin/run Up
composetest_web_1 /bin/sh -c python app.py Up 5000->5000/tcp
Câu lệnh docker-compose run cho phép ta chạy 1 lần nhiều câu lệnh cho các services. Ví dụ để thấy các environment variables trên web service:
$ docker-compose run web env
Dùng docker-compose --help để xem các câu lệnh có sẵn khác.
Nếu bạn started Compose với docker-compose up -d bạn có thể sẽ cần stop các services, khi đó hãy dùng lệnh:
$ docker-compose stop
Bạn có thể xóa tất cả các container. Truyền vào --volumes để remove data volume được dùng bởi Redis container:
$ docker-compose down --volumes
Tới đây, chắc hẳn là việc sử dụng Docker compose đã quá dễ dàng rồi (yaoming)
Tài liệu tham khảo
All rights reserved
