Docker 配置檔案 for Python App

Revisão a8889772118c5171aa70b66a2af9e044336e0ba5

.dockerignore · 117 B · Text Bruto

1	.git
2	__pycache__/
3	*.pyc
4	*.pyo
5	*.pyd
6	*.swp
7	.env
8	.venv
9	.uv/
10	dist/
11	build/
12	.eggs/
13	.coverage
14	.pytest_cache/
15	node_modules/
16

Dockerfile · 2.0 KiB · Docker Bruto

# syntax=docker/dockerfile:1.7 ############################## # 1) Base: Python 3.12 on Debian 12 (bookworm), slim 版 ############################## FROM python:3.12-slim-bookworm AS base # 取得套件清單、升級現有套件，並清理快取檔，縮小映像檔 RUN --mount=type=cache,target=/var/cache/apt \ apt-get update \ && apt-get -y upgrade \ && apt-get install -y --no-install-recommends ca-certificates curl \ && rm -rf /var/lib/apt/lists/* ############################## # 2) Tool stage: 從 uv 官方映像抓可執行檔 ############################## FROM ghcr.io/astral-sh/uv:latest AS uvbin ############################## # 3) Runtime: 把 uv 複製進來 + 建置專案 ############################## FROM base AS runtime # 複製 uv 執行檔 COPY --from=uvbin /uv /usr/local/bin/uv # 設定工作目錄 WORKDIR /app # --- 快取關鍵：先複製相依檔，再安裝 --- # 若你用 pyproject/uv.lock COPY pyproject.toml uv.lock* ./ # 若你是 requirements.txt 流程，也一起複製（可選） COPY requirements.txt* ./ # 安裝相依（優先使用 uv 的鎖定檔） # 1) 有 pyproject.toml/uv.lock：同步相依，但先不安裝專案本身（no-install-project） # 2) 否則退回 requirements.txt（若不存在此檔，指令會忽略） RUN set -eux; \ if [ -f "pyproject.toml" ]; then \ uv sync --frozen --no-dev --no-install-project; \ fi; \ if [ -f "requirements.txt" ]; then \ uv pip install -r requirements.txt; \ fi # 最後才複製所有程式碼（讓上面相依可以被 Docker layer 快取） COPY . . # 設 PYTHONPATH，讓程式能找到專案根目錄的模組 ENV PYTHONPATH=/app # 建立非 root 使用者，並給予 /app 權限 RUN useradd -m -u 10001 app \ && chown -R app:app /app USER app # 預設用 uv 的虛擬環境執行 Python（更安全、可重現） # 依你的專案啟動方式擇一： # - 若有 app 套件並可 python -m app 啟動 CMD ["uv", "run", "python", "-m", "app"] # - 或改為執行 main.py： # CMD ["uv", "run", "python", "main.py"]

1	# syntax=docker/dockerfile:1.7
2
3	##############################
4	# 1) Base: Python 3.12 on Debian 12 (bookworm), slim 版
5	##############################
6	FROM python:3.12-slim-bookworm AS base
7
8	# 取得套件清單、升級現有套件，並清理快取檔，縮小映像檔
9	RUN --mount=type=cache,target=/var/cache/apt \
10	apt-get update \
11	&& apt-get -y upgrade \
12	&& apt-get install -y --no-install-recommends ca-certificates curl \
13	&& rm -rf /var/lib/apt/lists/*
14
15	##############################
16	# 2) Tool stage: 從 uv 官方映像抓可執行檔
17	##############################
18	FROM ghcr.io/astral-sh/uv:latest AS uvbin
19
20	##############################
21	# 3) Runtime: 把 uv 複製進來 + 建置專案
22	##############################
23	FROM base AS runtime
24
25	# 複製 uv 執行檔
26	COPY --from=uvbin /uv /usr/local/bin/uv
27
28	# 設定工作目錄
29	WORKDIR /app
30
31	# --- 快取關鍵：先複製相依檔，再安裝 ---
32	# 若你用 pyproject/uv.lock
33	COPY pyproject.toml uv.lock* ./
34	# 若你是 requirements.txt 流程，也一起複製（可選）
35	COPY requirements.txt* ./
36
37	# 安裝相依（優先使用 uv 的鎖定檔）
38	# 1) 有 pyproject.toml/uv.lock：同步相依，但先不安裝專案本身（no-install-project）
39	# 2) 否則退回 requirements.txt（若不存在此檔，指令會忽略）
40	RUN set -eux; \
41	if [ -f "pyproject.toml" ]; then \
42	uv sync --frozen --no-dev --no-install-project; \
43	fi; \
44	if [ -f "requirements.txt" ]; then \
45	uv pip install -r requirements.txt; \
46	fi
47
48	# 最後才複製所有程式碼（讓上面相依可以被 Docker layer 快取）
49	COPY . .
50
51	# 設 PYTHONPATH，讓程式能找到專案根目錄的模組
52	ENV PYTHONPATH=/app
53
54	# 建立非 root 使用者，並給予 /app 權限
55	RUN useradd -m -u 10001 app \
56	&& chown -R app:app /app
57	USER app
58
59	# 預設用 uv 的虛擬環境執行 Python（更安全、可重現）
60	# 依你的專案啟動方式擇一：
61	# - 若有 app 套件並可 python -m app 啟動
62	CMD ["uv", "run", "python", "-m", "app"]
63	# - 或改為執行 main.py：
64	# CMD ["uv", "run", "python", "main.py"]
65