- Cho AI biết đủ: phiên bản Python, cách chạy ứng dụng, cổng, thư viện hệ thống cần cài, biến môi trường nào là bí mật.
- Ghim phiên bản ảnh gốc thay vì dùng latest, để bản build hôm nay và tháng sau giống nhau.
- Không để khóa API trong ENV hay ARG: tài liệu Docker nói chúng nằm lại trong ảnh. Truyền lúc chạy, hoặc dùng secret khi build.
- Có tệp .dockerignore trước khi chép cả thư mục, và chạy ứng dụng bằng một người dùng không phải root.
Bài dùng Python thuần cho phần soát; không cần cài Docker để chạy code mẫu. Các nguồn là bốn trang trong tài liệu chính thức của Docker: Building best practices, Build secrets, Build context và Dockerfile reference, đọc ngày 11/11/2026.
Hỏi AI viết Dockerfile thế nào
Một câu "viết Dockerfile cho dự án Python" cho ra một bản chung chung, vì mô hình phải đoán mọi thứ. Hãy đưa những gì nó không tự biết được. Phiên bản Python dự án đang dùng. Lệnh chạy ứng dụng, ví dụ chạy dịch vụ FastAPI bằng uvicorn như bài FastAPI cho ứng dụng AI. Cổng ứng dụng lắng nghe. Tệp khai báo thư viện, và có thư viện nào cần gói hệ thống đi kèm không. Biến môi trường nào là bí mật. Ảnh dùng để phát triển hay để chạy thật.
Kèm theo đó, nói rõ yêu cầu chất lượng: ghim phiên bản ảnh gốc, không để bí mật trong ảnh, chạy bằng người dùng không phải root, sắp xếp lệnh để tận dụng bộ nhớ đệm khi build. Mô hình làm theo khá tốt khi được dặn; điều đáng lo là những lần bạn quên dặn. Vì vậy, sau khi nhận bản nháp, hãy soát lại theo danh sách dưới đây, bằng mắt hoặc bằng code.
Những gì cần soát
Ghim phiên bản ảnh gốc. Trang Building best practices khuyên ghim phiên bản ảnh gốc, và giải thích thêm: muốn chắc chắn tuyệt đối thì ghim theo mã băm (digest), vì khi đó dù bên phát hành thay ảnh dưới cùng một nhãn, bản build của bạn vẫn dùng đúng ảnh cũ. Nhãn latest thì ngược lại: hôm nay là một phiên bản Python, vài tháng sau có thể là phiên bản khác, và thư viện của bạn có thể không chạy được.
Không để bí mật trong ảnh. Trang Build secrets viết rằng tham số build và biến môi trường không phù hợp để truyền bí mật vào quá trình build, vì chúng nằm lại trong ảnh cuối cùng. Ai có ảnh đều đọc được. Với khóa API mà ứng dụng cần lúc chạy, hãy truyền vào khi chạy container; với bí mật cần lúc build, như mã truy cập kho thư viện riêng, dùng tùy chọn mount kiểu secret mà tài liệu mô tả. Cách quản lý khóa nói chung có trong bài giữ khóa API an toàn.
Có .dockerignore. Lệnh chép cả thư mục dự án vào ảnh sẽ chép mọi thứ trong ngữ cảnh build, gồm cả tệp .env chứa khóa, thư mục .git, thư mục môi trường ảo. Trang Build context mô tả tệp .dockerignore là danh sách mẫu tên tệp cần loại ra, viết giống mẫu tên tệp của Unix shell.
Cài gói hệ thống đúng cách. Trang Building best practices đưa ví dụ ghép apt-get update và apt-get install trong cùng một lệnh RUN, rồi xóa thư mục /var/lib/apt/lists ở cuối, để ảnh nhỏ hơn và không dùng danh sách gói cũ từ bộ nhớ đệm.
Không chạy bằng root. Tài liệu khuyên: nếu dịch vụ chạy được mà không cần đặc quyền, dùng lệnh USER để chuyển sang một người dùng thường, tạo người dùng và nhóm ngay trong Dockerfile. Một lỗ hổng trong ứng dụng chạy bằng root nguy hiểm hơn nhiều so với cùng lỗ hổng đó khi chạy bằng người dùng thường.
Ví dụ: soát bằng Python
Chương trình mẫu đọc một Dockerfile, gộp các dòng nối bằng dấu gạch chéo ngược, bỏ chú thích, rồi kiểm từng lệnh theo năm quy tắc trên. Dockerfile "AI viết" trong code là bản giả lập do bài tự viết theo kiểu hay gặp. Tệp Dockerfile đi kèm là bản đã sửa, dùng cho một dịch vụ FastAPI nhỏ.
"""Soát Dockerfile do AI viết theo các khuyến nghị trong tài liệu Docker (Building best practices, Build secrets).
Quy tắc kiểm (thô, đọc từng lệnh; không thay được việc build và chạy thử):
- FROM không ghi phiên bản hoặc dùng :latest -> nên ghim phiên bản ảnh gốc (bỏ qua cờ đứng trước như --platform=...).
- ENV/ARG có tên kiểu KEY, TOKEN, SECRET, PASSWORD -> bí mật nằm lại trong ảnh; truyền lúc chạy, hoặc --mount=type=secret khi build.
Xét mọi tên trong lệnh (ENV PORT=8000 API_KEY=abc), không chỉ tên đầu.
- COPY cả thư mục mà dự án không có .dockerignore -> dễ chép cả .env, .git vào ảnh (kể cả khi có cờ --chown=...;
COPY --from=... chép từ giai đoạn build khác nên không tính).
- RUN apt-get install không cùng lệnh với apt-get update, hoặc không xóa /var/lib/apt/lists.
- Không có USER, hoặc USER cuối cùng là root -> ứng dụng chạy bằng quyền root.
DOCKERFILE_AI là bản GIẢ LẬP do bài tự viết theo kiểu AI hay đưa ra; bản đã sửa nằm ở tệp Dockerfile cạnh đây.
"""
import re
import shlex
import sys
from pathlib import Path
TU_BI_MAT = re.compile(r"(KEY|TOKEN|SECRET|PASSWORD|PASSWD)", re.I)
DOCKERFILE_AI = """FROM python:latest
WORKDIR /app
ENV ANTHROPIC_API_KEY=sk-ant-thu-nghiem
COPY . .
RUN apt-get install -y curl
RUN pip install -r requirements.txt
CMD uvicorn dich_vu:app --host 0.0.0.0
"""
def doc_lenh(van_ban):
"""Gộp các dòng nối bằng dấu \\ và bỏ chú thích; trả về danh sách (lệnh, phần còn lại)."""
lenh, gop = [], ""
for dong in van_ban.splitlines():
s = dong.strip()
if not s or s.startswith("#"):
continue
if s.endswith("\\"):
gop += s[:-1] + " "
continue
s = gop + s
gop = ""
ten, _, con = s.partition(" ")
lenh.append((ten.upper(), con.strip()))
return lenh
def _tach_co(con):
"""Tách các cờ --ten=gia_tri đứng đầu lệnh (FROM --platform=..., COPY --chown=... --from=...) khỏi phần còn lại."""
tu = con.split()
i = 0
while i < len(tu) and tu[i].startswith("--"):
i += 1
return tu[:i], tu[i:]
def _ten_bien(ten, con):
"""Mọi tên biến trong một lệnh ENV/ARG: ENV A=1 B=2, ARG A B=1; kiểu cũ ENV A giá trị thì chỉ A là tên."""
try:
tu = shlex.split(con)
except ValueError: # dấu nháy chưa đóng
tu = con.split()
if ten == "ENV" and tu and "=" not in tu[0]:
return tu[:1]
return [t.split("=")[0] for t in tu]
def soat(van_ban, co_dockerignore):
loi, nguoi_dung = [], None
for ten, con in doc_lenh(van_ban):
if ten == "FROM":
_, phan = _tach_co(con)
anh = phan[0] if phan else ""
if "@sha256:" not in anh and (":" not in anh.split("/")[-1] or anh.endswith(":latest")):
loi.append(f"FROM {anh}: chưa ghim phiên bản ảnh gốc")
elif ten in ("ENV", "ARG"):
for bien in _ten_bien(ten, con):
if TU_BI_MAT.search(bien):
loi.append(f"{ten} {bien}: bí mật sẽ nằm lại trong ảnh; "
"truyền lúc chạy hoặc dùng --mount=type=secret khi build")
elif ten == "COPY" and not co_dockerignore:
co, phan = _tach_co(con)
if not any(c.startswith("--from") for c in co) and any(p in (".", "./") for p in phan[:-1]):
loi.append("COPY . : dự án chưa có .dockerignore, dễ chép cả .env, .git vào ảnh")
elif ten == "RUN" and "apt-get install" in con:
if "apt-get update" not in con:
loi.append("RUN apt-get install: không cùng lệnh với apt-get update")
if "/var/lib/apt/lists" not in con:
loi.append("RUN apt-get install: chưa xóa /var/lib/apt/lists sau khi cài")
elif ten == "USER":
nguoi_dung = con.split(":")[0]
if nguoi_dung in (None, "root", "0"):
loi.append("không có USER khác root: ứng dụng sẽ chạy bằng quyền root")
return loi
def chay_thu():
dong = [f"Bản AI viết: {len(soat(DOCKERFILE_AI, co_dockerignore=False))} vấn đề"]
dong += [f" - {l}" for l in soat(DOCKERFILE_AI, co_dockerignore=False)]
da_sua = (Path(__file__).parent / "Dockerfile").read_text(encoding="utf-8")
dong.append(f"Bản đã sửa (có .dockerignore): {soat(da_sua, co_dockerignore=True) or 'không còn vấn đề nào'}")
print("\n".join(dong))
return dong
if __name__ == "__main__":
if len(sys.argv) > 1:
p = Path(sys.argv[1])
print("\n".join(soat(p.read_text(encoding="utf-8"), (p.parent / ".dockerignore").exists())) or "Không thấy vấn đề")
else:
chay_thu()
# syntax=docker/dockerfile:1
# Bản đã sửa cho một dịch vụ FastAPI nhỏ (dich_vu.py). Ghim phiên bản ảnh gốc theo nhu cầu dự án của bạn.
FROM python:3.13-slim
WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
curl \
&& rm -rf /var/lib/apt/lists/*
# Cài thư viện trước khi chép code để tận dụng bộ nhớ đệm khi chỉ sửa code
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
RUN groupadd -r ungdung && useradd --no-log-init -r -g ungdung ungdung
USER ungdung
# Khóa API truyền lúc chạy: docker run -e ANTHROPIC_API_KEY ... , không ghi vào ảnh
CMD ["uvicorn", "dich_vu:app", "--host", "0.0.0.0", "--port", "8000"]
Bản giả lập bị báo sáu vấn đề: dùng python:latest; đặt khóa API bằng ENV; chép cả thư mục khi dự án chưa có .dockerignore; cài curl mà không chạy apt-get update cùng lệnh, cũng không xóa danh sách gói; và không có lệnh USER nên ứng dụng chạy bằng root. Bản đã sửa không còn vấn đề nào. Trong bản đó, tệp khai báo thư viện được chép và cài trước khi chép code, nên khi chỉ sửa code, Docker dùng lại lớp đã cài thư viện từ bộ nhớ đệm và build nhanh hơn; khóa API không xuất hiện trong tệp mà được truyền lúc chạy container.
Muốn soát Dockerfile của chính dự án, chạy chương trình với đường dẫn tới tệp đó; chương trình tự xem cạnh tệp có .dockerignore không. Đây là bộ soát thô: nó không hiểu build nhiều giai đoạn, không kiểm được ảnh gốc có lỗ hổng không. Sau khi soát, vẫn phải build và chạy thử, và đọc kỹ những gì được chép vào ảnh.
Tệp .dockerignore và build nhiều giai đoạn
Một tệp .dockerignore tối thiểu cho dự án Python thường gồm: thư mục .git, tệp .env và mọi tệp chứa biến môi trường, thư mục môi trường ảo như .venv, thư mục bộ nhớ đệm pycache, thư mục chứa dữ liệu thử lớn, và các tệp cấu hình riêng của trình soạn thảo. Nhờ AI viết tệp này cũng được, nhưng hãy liệt kê cho nó cấu trúc thư mục thật của dự án, rồi đọc lại xem có tệp nào cần cho ứng dụng bị loại nhầm không. Sau khi build, chạy thử một container và liệt kê thư mục ứng dụng bên trong để chắc không có tệp bí mật nào lọt vào.
Khi dự án cần công cụ biên dịch lúc cài thư viện nhưng không cần chúng lúc chạy, hãy nhờ AI viết bản build nhiều giai đoạn. Trang Building best practices giải thích rằng cách này tách phần dựng ảnh khỏi kết quả cuối, nên ảnh cuối nhỏ hơn: giai đoạn đầu cài đủ công cụ để dựng, giai đoạn sau chỉ chép sang những gì cần để chạy. Với một dịch vụ nhỏ như ví dụ trong bài, một giai đoạn là đủ; đừng để AI làm Dockerfile phức tạp hơn mức dự án cần, vì mỗi giai đoạn thêm vào là thêm chỗ có thể sai.
Cuối cùng, tài liệu khuyên build lại ảnh thường xuyên để nhận bản vá bảo mật mới của ảnh gốc và thư viện. Ghim phiên bản không có nghĩa là đứng yên mãi ở một phiên bản: hãy đặt lịch cập nhật, sửa con số phiên bản trong Dockerfile, build lại và chạy lại toàn bộ bước kiểm.
Đưa vào quy trình làm việc
Trang Building best practices khuyên build và kiểm thử ảnh trong hệ thống tích hợp liên tục. Bạn có thể chạy bộ soát trong bài như một bước kiểm trước khi build, cùng các công cụ kiểm Dockerfile chuyên dụng, trong GitHub Actions như bài GitHub Actions cho dự án AI trình bày. Mỗi lần AI đề xuất sửa Dockerfile, bộ soát chạy lại và báo nếu một lỗi cũ quay lại.
Khi nhờ AI giải thích lỗi build, hãy dán nguyên thông báo lỗi kèm Dockerfile và cấu trúc thư mục dự án, nhưng xóa mọi giá trị bí mật trước khi dán. Nếu AI gợi ý thêm một ảnh gốc hay một gói lạ, tra trên trang chính thức trước khi dùng, vì tên ảnh và tên gói cũng có thể bị bịa.
- Dùng nhãn latest cho ảnh gốc.
- Đặt khóa API trong ENV hoặc ARG của Dockerfile.
- Chép cả thư mục dự án khi chưa có .dockerignore.
- Để ứng dụng chạy bằng root khi không cần.
- Dán Dockerfile có giá trị bí mật vào công cụ AI.
Câu hỏi thường gặp
Có cần ghim theo mã băm không?
Không bắt buộc. Ghim phiên bản là mức tối thiểu; mã băm chắc hơn nhưng phải tự cập nhật.
Ảnh slim có thiếu thư viện không?
Có thể. Nếu thư viện cần gói hệ thống, cài thêm bằng apt-get theo đúng cách trong bài.
Truyền khóa API lúc chạy thế nào?
Dùng biến môi trường khi chạy container hoặc tệp biến môi trường không đưa vào git.
AI có tự build thử Dockerfile được không?
Một số công cụ lập trình có AI chạy được lệnh trên máy bạn; vẫn phải tự xem kết quả build.
Học tiếp
- Dịch vụ sẽ được đóng gói: FastAPI cho ứng dụng AI.
- Quản lý khóa ngoài ảnh: giữ khóa API an toàn.
- Chạy bộ soát tự động mỗi lần đẩy code: GitHub Actions cho dự án AI.
Nếu bạn muốn học Python và AI bài bản cùng giảng viên, tham khảo khóa học AI của Big-O Coding.
Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.


