如何在 Docker 中執行 Aspose.Slides
概觀
Aspose.Slides for Python via .NET 在 Linux 容器中執行,但此套件是包裹在 .NET Core 3.1 執行時的 Python 包裝器。該執行時需要三個原生程式庫,而精簡版 Python 映像檔並未提供,且對版本有特定要求。本文提供可用的 Dockerfile,說明每個相依性的來源,並示範如何加入字型與授權。
可工作的 Dockerfile
FROM python:3.11-slim-bullseye
RUN apt-get update && apt-get install -y --no-install-recommends \
libgdiplus \
libicu67 \
libfontconfig1 \
fonts-dejavu-core \
&& rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir aspose.slides
WORKDIR /app
COPY app.py .
CMD ["python", "app.py"]
app.py:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 400, 100)
shape.text_frame.text = "Created inside a Docker container"
presentation.save("output.pptx", slides.export.SaveFormat.PPTX)
presentation.save("output.pdf", slides.export.SaveFormat.PDF)
建置與執行:
docker build -t aspose-slides-python .
docker run --rm aspose-slides-python
為何基礎映像是 Debian 11
aspose.slides 的 wheel 內含 .NET Core 3.1 執行時,而該執行時早於目前 Debian 版本所提供的函式庫版本。於 Debian 12 與 13 中容器能成功建置,卻在首次呼叫 Presentation() 時失敗:
Process terminated. Couldn't find a valid ICU package installed on the system.
訊息具有誤導性——ICU 確實已安裝於這些映像,但版本為 ICU 72 或 76,而 .NET Core 3.1 只識別較舊的主版本。Debian 12 另有 OpenSSL 3,導致第二個失敗:
No usable version of libssl was found
python:3.11-slim-bullseye 為 Debian 11,提供了捆綁執行時所需的兩個版本:
| 套件 | Debian 11 上的版本 | 為何需要 |
|---|---|---|
libgdiplus |
6.0.4 | 用於呈現圖形、文字與影像的 GDI+ 實作 |
libicu67 |
67.1 | 全球化資料。較新主版本不被 .NET Core 3.1 辨識 |
libssl1.1 |
1.1.1w | 加密功能。預先安裝於 Debian 11;Debian 12 以上不存在 |
libfontconfig1 |
— | 字型偵測 |
libssl1.1 已在基礎映像中存在,故不需在 apt-get install 中列出。
若必須使用較新的基礎映像,可設定 DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 以繞過 ICU 要求。此設定會停用文化特定格式化,但 不會 解決 OpenSSL 的問題,因此 Debian 11 仍是較簡單的選擇。
字型
精簡映像根本不包括任何字型。若未安裝至少一種字型,文字會在 PDF、影像與 HTML 輸出中呈現為空白方框。fonts-dejavu-core 是一個小型、通用的起點。
若要符合投影片的預期外觀,請將投影片使用的字型複製到映像中,並指向 Aspose.Slides:
COPY fonts/ /usr/share/fonts/truetype/custom/
RUN fc-cache -f
import aspose.slides as slides
slides.FontsLoader.load_external_fonts(["/usr/share/fonts/truetype/custom/"])
容器內的授權
不要將授權檔案建入映像——任何拉取映像的人都會取得授權。應在執行時掛載:
docker run --rm -v /path/on/host:/license aspose-slides-python
import aspose.slides as slides
license = slides.License()
license.set_license("/license/Aspose.Slides.Python.NET.lic")
若未提供授權,函式庫會以評估模式執行,會加上浮水印並限制可處理的投影片數量。詳情請參閱Licensing。
記憶體
將內容渲染為 PDF 或影像比讀取檔案更耗記憶體。記憶體限制嚴格的容器可能在轉換過程中被 OOM killer 終止,通常會表現在程式未出現 Python 堆疊追蹤而直接結束。若發生此情況,請先提升容器的記憶體限制,再進一步檢查程式碼。