Docker init: Cách khởi tạo dự án với Docker (Hướng dẫn từng bước)

Vì một lý do nào đó, việc thiết lập một dự án mới với Docker luôn mất nhiều thời gian hơn mức cần thiết.

Bạn lên Google tìm một mẫu, dán vào, đổi vài dòng rồi hy vọng mọi thứ ổn. Bản dựng lỗi, thế là bạn chỉnh lại và lặp lại chu trình cho đến khi chạy được. Mỗi dự án mới đều bắt đầu như nhau - với một tệp trắng và ký ức mơ hồ về thứ đã hiệu quả lần trước. Đây rõ ràng là vấn đề ở khâu thiết lập, không phải do Docker.

Tin tốt là docker init giải quyết được chuyện này. Đây là lệnh CLI tự nhận diện loại dự án của bạn và tạo ra Dockerfile, .dockerignore và tệp Compose.

Trong bài viết này, tôi sẽ hướng dẫn bạn cách docker init hoạt động, cách dùng từng bước với một dự án Python thực tế, và khi nào nó là công cụ phù hợp.

Bạn hoàn toàn mới với Docker và container hóa? Tìm hiểu vì sao đây là phần thiết yếu trong bộ công cụ của các chuyên gia dữ liệu qua khóa học Introduction to Docker của chúng tôi.

Docker init là gì

docker init là một công cụ CLI thiết lập cấu hình Docker cho dự án của bạn. Nó tạo ra các tệp bạn cần để container hóa ứng dụng. Nhờ vậy, bạn không cần dùng mẫu hay sao chép-dán nữa.

Nó tạo ba tệp:

• Dockerfile - định nghĩa cách xây dựng ảnh container của bạn
• .dockerignore - cho Docker biết những tệp nào cần loại khỏi ngữ cảnh build
• compose.yml - tùy chọn, nhưng hữu ích cho thiết lập nhiều dịch vụ

Điểm hay là khả năng tự động nhận diện dự án. docker init xem cấu trúc dự án và xác định bạn đang dùng stack nào - Python, Node.js, Go và các stack khác. Sau đó, nó tạo tệp phù hợp cho stack đó thay vì đưa ra một mẫu chung chung.

Đây không phải công cụ triển khai, và cũng không quản lý container của bạn ở môi trường production. Nó chỉ khởi tạo cấu hình để bạn tập trung vào công việc chính.

Cách Docker init hoạt động

docker init luôn đi theo quy trình bốn bước mỗi khi bạn chạy.

Trước hết, bạn chạy docker init bên trong thư mục dự án. Docker quét thư mục, nhận diện loại dự án và chọn mẫu cấu hình phù hợp. Sau đó, nó hướng dẫn bạn qua một loạt nhắc tương tác ngắn - như cổng ứng dụng chạy và lệnh khởi động. Khi bạn trả lời xong, nó sẽ tạo các tệp cấu hình.

Toàn bộ quá trình mất chưa đến một phút.

Các câu hỏi nhắc rất dễ trả lời và hiếm khi cần giải thích thêm. Bạn có thể chấp nhận giá trị mặc định bằng cách nhấn Enter, hoặc nhập giá trị của riêng bạn nếu mặc định không phù hợp. 

Đây là những gì bạn sẽ thấy khi lần đầu chạy lệnh:

Màn hình thiết lập Docker init

Tiếp theo, tôi sẽ minh họa chi tiết hơn quy trình này.

Cách sử dụng Docker init từng bước

Dưới đây là tổng quan cách chuyển từ thư mục dự án đến một container đang chạy.

Bước 1: Di chuyển đến thư mục dự án của bạn

Mở terminal và đi đến thư mục gốc của dự án - thư mục chứa mã nguồn ứng dụng của bạn.

cd /path/to/your/projectĐược hỗ trợ bởi

docker init tạo tệp theo vị trí bạn chạy lệnh, nên hãy đảm bảo bạn đang ở đúng thư mục trước khi tiếp tục.

Bước 2: Chạy Docker init

Chạy lệnh sau:

docker initĐược hỗ trợ bởi

Docker sẽ quét thư mục dự án của bạn, nhận diện stack và khởi chạy phần thiết lập tương tác.

Bước 3: Trả lời các câu hỏi nhắc

docker init sẽ hỏi bạn một vài câu:

• Nền tảng ứng dụng - ngôn ngữ hoặc framework dự án của bạn dùng (Python, Node.js, Go, v.v.)
• Cổng - cổng mà ứng dụng của bạn lắng nghe
• Lệnh khởi động - lệnh Docker nên chạy để khởi động ứng dụng

Bạn có thể chấp nhận mặc định bằng cách nhấn Enter, hoặc nhập giá trị của riêng bạn. Nếu docker init nhận diện được stack, các giá trị mặc định thường đủ tốt để bắt đầu.

Bước 4: Rà soát các tệp được tạo

Sau khi trả lời xong, docker init sẽ ghi ba tệp vào thư mục dự án của bạn:

.
├── Dockerfile
├── .dockerignore
└── compose.yamlĐược hỗ trợ bởi

Mở từng tệp và đọc qua. Các tệp được tạo có chú thích giải thích từng dòng, nên đáng để bạn dành vài phút hiểu những gì đã được tạo trước khi build.

Bước 5: Build và chạy container của bạn

Build và khởi động container với Docker Compose:

docker compose up --buildĐược hỗ trợ bởi

Cờ --build báo cho Docker build ảnh từ Dockerfile trước khi khởi động container. Khi chạy, ứng dụng của bạn sẽ truy cập được trên cổng bạn đã chỉ định ở bước 3.

Các loại dự án được hỗ trợ trong Docker init

docker init hỗ trợ các stack ứng dụng phổ biến ngay từ đầu. Dưới đây là một vài ví dụ:

• Python
• Node.js
• Go
• Java
• .NET

Nó tự động nhận diện stack. Khi bạn chạy docker init, nó quét thư mục dự án tìm các tệp đặc thù ngôn ngữ - như requirements.txt cho Python hoặc package.json cho Node.js - và chọn mẫu phù hợp dựa trên những gì tìm thấy.

Mỗi mẫu được tinh chỉnh theo stack. Dự án Python sẽ có ảnh nền tảng, lệnh cài đặt và lệnh khởi động khác với dự án Go. Bạn không nhận một Dockerfile kiểu “một cỡ cho tất cả” chỉ thay biến ngôn ngữ. Bản thân cấu trúc sẽ thay đổi tùy theo thứ bạn đang xây dựng.

Nếu docker init không nhận diện được stack, nó sẽ yêu cầu bạn chọn thủ công từ danh sách.

Các tệp do Docker init tạo ra

docker init tạo ra ba tệp, và mỗi tệp có vai trò khác nhau trong thiết lập của bạn.

Dockerfile

Dockerfile định nghĩa cách Docker build ảnh container của bạn. Nó cho Docker biết ảnh nền tảng dùng là gì, cách cài phụ thuộc, và lệnh nào chạy khi container khởi động.

Đây là ví dụ Dockerfile Python được tạo:

FROM python:3.14-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "app.py"]Được hỗ trợ bởi

Bạn nên rà soát tệp này trước khi build. Kết quả tạo ra là điểm khởi đầu tốt, nhưng có thể bạn cần tinh chỉnh - ví dụ, thêm biến môi trường hoặc điều chỉnh phiên bản ảnh nền tảng.

.dockerignore

Tệp .dockerignore cho Docker biết những tệp nào cần loại khỏi ngữ cảnh build. Đây là tập tệp Docker gửi đến engine khi tạo ảnh.

Nếu không có nó, Docker sẽ sao chép mọi thứ trong thư mục dự án vào ảnh, bao gồm cả .git, node_modules hoặc các tệp cấu hình cục bộ bạn không cần ở production. Điều đó làm tăng kích thước ảnh và có thể làm lộ các tệp bạn không muốn đưa vào.

Một .dockerignore điển hình trông như sau:

.git
.env
__pycache__
*.pyc
node_modulesĐược hỗ trợ bởi

Tệp Docker Compose

Tệp compose.yaml dùng để chạy các thiết lập đa container. Nó định nghĩa dịch vụ, cổng, volume, và cách các container kết nối với nhau.

Với ứng dụng đơn giản một container, có thể bạn không cần. Nhưng nếu dự án có cơ sở dữ liệu, bộ nhớ đệm, hoặc dịch vụ khác chạy kèm ứng dụng, Compose là nơi bạn cấu hình tất cả trong một chỗ.

Ví dụ: Dùng Docker init với dự án Python

Hãy chạy docker init trên một dự án thực. Tôi sẽ dùng một ứng dụng FastAPI tối giản với một route làm ví dụ.

Cấu trúc dự án trước khi chạy docker init như sau:

my-fastapi-app/
├── app.py
└── requirements.txtĐược hỗ trợ bởi

app.py có một route Hello World:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello, World!"}Được hỗ trợ bởi

Và requirements.txt có hai phụ thuộc sau:

fastapi
uvicornĐược hỗ trợ bởi

Chạy docker init

Bắt đầu bằng cách đi đến thư mục dự án và chạy:

docker initĐược hỗ trợ bởi

Docker init đã nhận diện dự án

docker init nhận diện Python từ requirements.txt và hỏi bạn vài câu. Dưới đây là màn hình nhắc và gợi ý trả lời:

Các câu hỏi nhắc của Docker init cho dự án Python

Những gì được tạo ra

Sau khi trả lời xong, thư mục dự án của bạn sẽ trông như sau:

Cấu trúc thư mục dự án mới

Có ba tệp mới. Hãy xem từng tệp.

Dockerfile

# syntax=docker/dockerfile:1

ARG PYTHON_VERSION=3.14
FROM python:${PYTHON_VERSION}-slim as base

ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1

WORKDIR /app

ARG UID=10001
RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "${UID}" \
    appuser

RUN --mount=type=cache,target=/root/.cache/pip \
    --mount=type=bind,source=requirements.txt,target=requirements.txt \
    python -m pip install -r requirements.txt

USER appuser

COPY . .

EXPOSE 8000

CMD uvicorn 'app:app' --host=0.0.0.0 --port=8000Được hỗ trợ bởi

Có vài điểm đáng chú ý. PYTHONDONTWRITEBYTECODE=1 ngăn Python ghi tệp .pyc xuống đĩa, và PYTHONUNBUFFERED=1 đảm bảo log hiển thị theo thời gian thực thay vì bị đệm - cả hai đều là mặc định tốt cho ứng dụng chạy trong container.

Khối adduser tạo một người dùng không đặc quyền tên appuser để chạy ứng dụng. Mặc định, container Docker chạy với quyền root, đây là rủi ro bảo mật. Chạy với người dùng không phải root sẽ hạn chế những gì kẻ tấn công có thể làm nếu họ phá vỡ được ứng dụng của bạn.

Cờ --mount=type=cache ở bước pip install báo Docker lưu đệm các gói đã tải giữa các lần build. Nghĩa là những lần build sau sẽ không phải tải lại phụ thuộc từ đầu, giúp tăng tốc.

.dockerignore

**/.DS_Store
**/__pycache__
**/.venv
**/.env
**/.git
**/.gitignore
**/node_modules
**/Dockerfile*
**/compose.y*ml
README.mdĐược hỗ trợ bởi

Tệp .dockerignore loại trừ những tệp không nên có trong ảnh của bạn. Các tệp môi trường cục bộ như .env, thư mục quản lý phiên bản như .git, và tệp cache của Python như __pycache__ đều bị bỏ qua. Bản thân Dockerfile và compose.yaml cũng bị loại trừ - Docker không cần chúng bên trong ảnh đang build.

compose.yaml

services:
  server:
    build:
      context: .
    ports:
      - 8000:8000Được hỗ trợ bởi

Tệp Compose định nghĩa ứng dụng của bạn là một dịch vụ tên server, build từ Dockerfile trong thư mục hiện tại, và ánh xạ cổng 8000 trên máy chủ sang cổng 8000 bên trong container.

Cả ba tệp được tạo đều có một số chú thích tôi đã lược bớt để nội dung gọn gàng.

Chạy docker compose up --build và ứng dụng FastAPI của bạn sẽ hoạt động tại http://localhost:8000.

Ứng dụng FastAPI chạy trong container

Docker init so với thiết lập Dockerfile thủ công

Cả hai cách đều đưa bạn đến một Dockerfile chạy được, nên vấn đề nằm ở mức độ kiểm soát bạn cần và tốc độ bạn muốn đạt được.

Docker init

docker init là lựa chọn nhanh hơn. Bạn trả lời vài câu hỏi nhắc và có ngay một cấu hình hoạt động, tương đối an toàn trong chưa đến một phút. Các tệp tạo ra tuân theo thực hành tốt nhất của Docker - người dùng không phải root, lưu đệm build, mẫu .dockerignore hợp lý - nên bạn không phải bắt đầu từ con số 0.

Phù hợp khi bạn bắt đầu dự án mới, onboarding thành viên mới, hoặc chỉ muốn một nền tảng vững để xây tiếp mà không tốn thời gian cho phần khuôn mẫu.

Nhưng cũng có câu chuyện về tính linh hoạt. Các mẫu bao phủ tốt những stack phổ biến, nhưng chúng vẫn là mẫu. Nếu dự án của bạn có cấu trúc bất thường hoặc yêu cầu build đặc thù, bạn sẽ chạm giới hạn những gì docker init có thể tạo ra.

Thiết lập thủ công

Tự viết Dockerfile cho bạn toàn quyền với từng layer, từng chỉ thị và mọi quyết định build. Bạn có thể triển khai multi-stage build để tối ưu kích thước ảnh, dùng ảnh nền tảng tùy biến, hoặc tinh chỉnh hành vi lưu đệm theo những cách docker init không lường trước được.

Nhưng bạn cần biết mình đang làm gì. Một Dockerfile viết kém có thể tạo ra ảnh quá cỡ, đưa vào rủi ro bảo mật, hoặc lỗi theo những cách khó gỡ, đặc biệt nếu bạn chưa có nhiều kinh nghiệm.

Nên dùng cách nào

Hãy nghĩ theo cách đơn giản sau:

So sánh Docker init và thiết lập thủ công

Một cách hay là bắt đầu với docker init rồi chỉnh sửa thủ công các tệp được tạo khi yêu cầu tăng lên.

Khi nào nên dùng Docker init

docker init không phải là công cụ phù hợp cho mọi tình huống. Dưới đây là khi nên dùng và khi không nên.

Hãy chọn docker init khi:

• Bạn bắt đầu dự án mới: Nó giúp cấu hình Docker khởi động trong chưa đầy một phút, để bạn tập trung viết mã thay vì thiết lập container hóa

• Bạn đang học Docker: Các tệp tạo ra có chú thích tốt và theo thực hành tốt nhất. Chúng là điểm xuất phát tốt hơn so với một đoạn mã ngẫu nhiên trên Stack Overflow

• Bạn đang thử nghiệm nhanh: Khi bạn cần môi trường container hóa nhanh và chưa quan tâm tinh chỉnh build, docker init mang lại thứ hoạt động được

• Bạn chuẩn hóa trong một nhóm: Thay vì mỗi lập trình viên tự viết Dockerfile riêng, docker init cung cấp cho mọi người cùng một điểm khởi đầu với cấu trúc và mặc định nhất quán

Tuy nhiên, bạn nên bỏ qua docker init khi:

• Bạn cần multi-stage build: Nếu bạn tối ưu kích thước ảnh bằng cách tách build thành các giai đoạn - biên dịch ở giai đoạn này, chạy ở giai đoạn khác - bạn sẽ cần tự viết. Dockerfile được tạo là đơn giai đoạn

• Bạn có yêu cầu production phức tạp: Ảnh nền tảng tùy biến, chiến lược lưu đệm nâng cao, bố cục dự án không chuẩn - đây không phải những thứ docker init có thể lường trước. Bạn sẽ tốn nhiều thời gian xoay xở với tệp tạo ra hơn là tự viết

Tóm lại, docker init là điểm khởi đầu. Hãy dùng nó để bắt đầu, rồi chỉnh sửa các tệp được tạo khi nhu cầu tăng lên.

Hạn chế của Docker init

Khi dự án lớn dần, bạn có thể gặp một số hạn chế. Dưới đây là vài điều.

Các tệp tạo ra mang tính mẫu (template). Chúng được thiết kế để bao phủ các trường hợp phổ biến nhất cho mỗi stack được hỗ trợ, nghĩa là phù hợp với dự án phổ biến và kém phù hợp với thứ nằm ngoài phạm vi đó. Nếu dự án của bạn có cấu trúc bất thường, các tệp tạo ra có thể sẽ không tính đến điều đó.

Một hạn chế thường gặp khác là gần như luôn cần chỉnh tay. Mặc định thì tốt, nhưng vẫn là mặc định. Nhiều khả năng bạn sẽ cần điều chỉnh phiên bản ảnh nền tảng, tinh chỉnh biến môi trường, hoặc sửa lệnh khởi động trước khi cấu hình phù hợp với dự án. Hãy coi các tệp tạo ra như bản nháp đầu tiên, không hơn.

docker init cũng không hỗ trợ các mẫu build nâng cao. Multi-stage build, tham số build tùy biến, logic điều kiện, và các kỹ thuật khác mà người dùng Docker có kinh nghiệm dựa vào cho ảnh production nằm ngoài phạm vi những gì công cụ này tạo ra. Nhưng nếu bạn cần những thứ đó, dù sao bạn cũng sẽ tự viết Dockerfile.

Những điều này không khiến docker init trở thành công cụ tệ. Chỉ là bạn cần kỳ vọng đúng - nó loại bỏ vấn đề “trang giấy trắng”, nhưng không thay thế nhu cầu hiểu nội dung trong Dockerfile của bạn.

Thực hành tốt sau khi dùng Docker init

Các tệp docker init tạo ra là điểm khởi đầu. Dưới đây là các bước bạn cần để biến chúng thành cấu hình sẵn sàng cho production.

• Rà soát các tệp được tạo: Đọc lần lượt Dockerfile, .dockerignore và compose.yaml. Các tệp có chú thích tốt nên sẽ không mất nhiều thời gian. Bạn cần hiểu có gì ở đó trước khi xây tiếp lên

• Tối ưu kích thước ảnh: Ảnh nền tảng mặc định là python:3.x-slim, vốn đã nhẹ. Nhưng bạn có thể tiến xa hơn bằng cách đảm bảo .dockerignore loại trừ mọi thứ cần thiết, và kiểm tra xem bạn có đang sao chép vào ảnh những tệp không cần thiết hay không

• Di chuyển bí mật và giá trị phụ thuộc môi trường sang biến môi trường: Đừng hardcode khóa API, URL cơ sở dữ liệu, hoặc cờ môi trường trong Dockerfile. Hãy dùng biến môi trường, quản lý qua tệp .env ở máy cục bộ hoặc công cụ quản lý bí mật của nền tảng triển khai ở production

• Kiểm thử cục bộ trước khi đẩy đi đâu đó: Chạy docker compose up --build và xác minh ứng dụng của bạn hoạt động trong container giống như bên ngoài. Kiểm tra log, truy cập endpoint, và xác nhận ánh xạ cổng hoạt động

• Tinh chỉnh các bước build khi dự án lớn dần: Dockerfile được tạo cài phụ thuộc trong một layer. Khi dự án trưởng thành, hãy nghĩ về thứ tự layer. Nói cách khác, đặt các bước ít thay đổi hơn lên trên để Docker có thể lưu đệm. Nếu thời gian build bắt đầu tăng, đó thường là nơi cần xem xét đầu tiên

Sự cố thường gặp và cách khắc phục

Như mọi khi trong công nghệ, một vài thứ có thể gặp trục trặc. Dưới đây là những gì cần kiểm tra và cách khắc phục.

Nhận diện dự án không chính xác

Nếu docker init chọn sai stack, nó sẽ tạo các tệp không khớp với dự án của bạn. Thường xảy ra khi thư mục dự án có nhiều ngôn ngữ lẫn lộn hoặc thiếu tệp mà docker init trông đợi - như requirements.txt cho Python hoặc package.json cho Node.js.

Khi nhắc chọn nền tảng ứng dụng, chỉ cần chọn thủ công nền tảng đúng thay vì chấp nhận mặc định được phát hiện.

Xung đột cổng

Nếu container khởi động nhưng bạn không truy cập được ứng dụng, hoặc Docker báo lỗi cổng đã được sử dụng, có thể một tiến trình khác trên máy đang chiếm cùng cổng.

Hãy tìm và dừng tiến trình xung đột, hoặc đổi cổng phía host trong compose.yaml:

ports:
  - 8001:8000  # maps host port 8001 to container port 8000Được hỗ trợ bởi

Bên trái là cổng trên máy của bạn. Bên phải phải khớp với cổng ứng dụng lắng nghe bên trong container.

Thiếu phụ thuộc

Nếu container build xong nhưng sập khi khởi động, nguyên nhân phổ biến là thiếu phụ thuộc. Kiểm tra requirements.txt (hoặc tương đương) đầy đủ và cập nhật chưa. Nếu bạn thêm gói cục bộ mà chưa cập nhật tệp đó, container sẽ không có gói đó.

Chạy docker compose logs để xem lỗi:

docker compose logsĐược hỗ trợ bởi

Thông báo lỗi thường sẽ chỉ ra chính xác gói nào bị thiếu.

Container không khởi động

Nếu container không khởi động được, vấn đề gần như luôn nằm ở dòng CMD trong Dockerfile. Kiểm tra lệnh khởi động có khớp với cách bạn thực sự chạy ứng dụng không.

Với ví dụ FastAPI, nó nên trông như sau:

CMD uvicorn 'app:app' --host=0.0.0.0 --port=8000Được hỗ trợ bởi

Nếu tệp entry point có tên khác hoặc đường dẫn module sai, container sẽ thoát. Hãy sửa CMD, build lại với docker compose up --build, và kiểm tra log lần nữa.

Kết luận

docker init sẽ không thay thế việc hiểu sâu về Docker, nhưng nó sẽ giúp bạn vượt qua vấn đề “trang giấy trắng”.

Chỉ với một lệnh, bạn có Dockerfile, .dockerignore và tệp compose.yml hoạt động - tất cả đều theo thực hành tốt nhất của Docker. Đó là nền tảng tốt cho mọi dự án mới, và là điểm xuất phát tốt hơn nhiều so với một mẫu sao chép từ Stack Overflow hay ChatGPT.

Chỉ đừng dừng lại ở đó. Các tệp tạo ra là để chỉnh sửa. Hãy rà soát, tinh chỉnh các bước build, cố định phiên bản ảnh nền tảng, và thêm biến môi trường. Dự án càng lớn, bạn càng rời xa mặc định.

Nếu bạn đã nắm cơ bản Docker, bước tiếp theo hợp lý là tìm hiểu về multi-stage build, công cụ mạng và Docker Compose - tất cả đều có trong khóa học Intermediate Docker của chúng tôi.