在Azure环境Alpine基础Docker镜像中安装软件包报错如何解决？

报错根因说明 #

• 错误码127：你使用的基础镜像是Alpine系列，默认包管理器为apk，不存在apt命令，命令无法找到返回127错误码。
• 错误码2：libfreetype6是Debian/Ubuntu发行版的包名，Alpine源中对应的依赖包名为freetype，包名不匹配导致安装失败返回2错误码。

正确解决方案 #

基础安装命令 #

直接在Dockerfile中使用如下指令安装对应依赖：
RUN apk add --no-cache fontconfig freetype

Azure环境网络优化方案 #

如果Azure构建环境访问官方Alpine源速度慢或连接失败，可先替换为国内镜像源再安装，同时执行字体缓存刷新避免后续Java加载字体失败：

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories \
    && apk add --no-cache fontconfig freetype \
    && fc-cache --force

后续Java运行配置 #

依赖安装完成后，启动Java应用时添加如下JVM参数开启无头模式，彻底避免X11相关组件调用报错：
-Djava.awt.headless=true

内容的提问来源于stack exchange，提问作者Sam。