[](https://hackmd.io/Frex49gZRTi3LSUcYL8RLA)
## 解決 .NET Docker 容器中缺少字型檔的問題

之前公司的維運同事說我的 CI/CD 和環境相關能力需要加強。
我仔細想想也是，天分有限，再繼續研究 .NET 的進步空間也不大。
結果最近在研究 WSL，卻因為權限問題被卡住，搞了快一個月也沒寫出一篇筆記。
反而在空閒時間又寫了幾篇 .NET 的筆記。
但後來仔細想想，好像之前有處理一個 Docker 的問題，可以勉強掰出一篇筆記，證明我有在研究 XD。

## Docker 容器中的字型問題
在 Linux 系統中，字型檔案通常位於「/usr/share/fonts」路徑底下，如下圖所示，可以看到裡面有一個「truetype」資料夾，存放著字型檔案。

使用 Dockerfile 建立的 Linux 容器（Container)中，可能會發現「/usr/share/」路徑下缺少「fonts」資料夾。例如，使用 Visual Studio 建立專案所產生的 Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base

WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["TestFont6/TestFont6.csproj", "TestFont6/"]
RUN dotnet restore "./TestFont6/TestFont6.csproj"
COPY . .
WORKDIR "/src/TestFont6"
RUN dotnet build "./TestFont6.csproj" -c $BUILD_CONFIGURATION -o /app/build

FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./TestFont6.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "TestFont6.dll"]

容器執行起來，可以看到缺少「fonts」資料夾。

這應該是`mcr.microsoft.com/dotnet/aspnet:6.0` 使用了較精簡的 Linux 基礎映像檔（如 Debian、Alpine 等），這些映像檔（Image)通常僅包含最基本的系統套件，為了減少大小，不會預裝許多常見的字型套件。

為了解決這個問題，可以對 Dockerfile 進行以下調整：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base

# 使用 sed 命令編輯 /etc/apt/sources.list 文件，在每一行的結尾增加 contrib，以啟用 contrib 套件來源，並備份原檔案為 .bak
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
# 更新套件清單並安裝 ttf-mscorefonts-installer 和 fontconfig 這兩個套件
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
# 使用 fc-cache 命令刷新字型快取，優化字型加載速度
# -f 強制刷新快取
# -v 顯示詳細信息
RUN fc-cache -f -v

WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["TestFont6/TestFont6.csproj", "TestFont6/"]
RUN dotnet restore "./TestFont6/TestFont6.csproj"
COPY . .
WORKDIR "/src/TestFont6"
RUN dotnet build "./TestFont6.csproj" -c $BUILD_CONFIGURATION -o /app/build

FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./TestFont6.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "TestFont6.dll"]

這樣一來，「/usr/share/fonts」路徑底下就會有「truetype」資料夾。

## 處理 .NET 8 Dockerfile 的問題
在使用 .NET 8 的 Dockerfile 時，以上方法會遇到以下錯誤：

#5 ERROR: process "/bin/sh -c sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list" did not complete successfully: exit code: 21

根據錯誤訊息檢查「/etc/apt/」路徑底下，發現只有「sources.list.d」資料夾，而沒有「sources.list」檔案。

根據文章「[Sources.list file is missing in debian12](https://unix.stackexchange.com/questions/763646/sources-list-file-is-missing-in-debian12-docker-image)」來看，`mcr.microsoft.com/dotnet/sdk:6.0` 這個映像檔使用的 Linux 發行版本是 Debian 11，而 `mcr.microsoft.com/dotnet/sdk:8.0` 改為使用 Debian 12。
而在 Debian 12 使用，套件管理改為使用「/etc/apt/sources.list.d/debian.sources」的檔案。

以下是針對 .NET 8 的 Dockerfile 進行調整：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base

# 在 /etc/apt/sources.list.d/debian.sources 文件中尋找符合 Components: main 的行，並在該行的末尾增加 contrib。
RUN sed -i 's/^Components: main$/& contrib/' /etc/apt/sources.list.d/debian.sources
# 更新套件清單並安裝 ttf-mscorefonts-installer 和 fontconfig 這兩個套件
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
# 使用 fc-cache 命令刷新字型快取，優化字型加載速度
# -f 強制刷新快取
# -v 顯示詳細信息
RUN fc-cache -f -v

USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["TestFont/TestFont.csproj", "TestFont/"]
RUN dotnet restore "./TestFont/TestFont.csproj"
COPY . .
WORKDIR "/src/TestFont"
RUN dotnet build "./TestFont.csproj" -c $BUILD_CONFIGURATION -o /app/build

FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./TestFont.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "TestFont.dll"]

這樣一來，在「/usr/share/fonts」的路徑底下也可以看到「truetype」資料夾。

:::warning
Dockerfile 的註解是問 ChatGPT 來的，雖然我有 Google 去驗證，但由於我環境指令很不熟，無法 100% 確認正確。
:::

###### tags: `.NET` `.NET Core & .NET 5+` `Docker`