Amazon Linux 2 上 Docker 目标架构选择指南：解决 TARGETARCH 错误

在 Amazon Linux 2 上运行 Docker 时选择目标架构：终极指南

问题陈述

在 Amazon Linux 2 EC2 实例上使用 docker build 时，你可能遇到 TARGETARCH 参数不被识别的错误。这篇文章将深入探讨这个问题，并提供详细的解决方案。

幕后原理

在 Amazon Linux 2 中运行 Docker 时，需要指定目标架构。这是因为 Docker 需要知道正在构建的映像的目标环境。如果不指定目标架构，Docker 会默认为 linux/amd64。

要解决 TARGETARCH 参数不被识别的错误，你需要启用 BuildKit 并使用 --platform 选项指定目标架构。

解决方案

1. 启用 BuildKit

使用以下命令启用 BuildKit：

export DOCKER_BUILDKIT=1

2. 指定目标架构

在 docker build 命令中使用 --platform 选项指定目标架构：

docker build --platform <目标架构> -t <映像名称> .

其中 <目标架构> 可以是 linux/amd64、linux/arm64 或其他受支持的架构。

示例

以下是使用 BuildKit 和 --platform 选项在 Amazon Linux 2 上构建 Docker 映像的示例：

export DOCKER_BUILDKIT=1
docker build --platform linux/amd64 -t my-image .

注意事项

• 确保 Docker BuildKit 已安装。
• 目标架构必须与基础映像的架构兼容。
• 可以在 Dockerfile 中使用 ARG 指令设置 TARGETARCH 参数，然后在 docker build 命令中传递该参数。

常见问题解答

1. 我如何检查我的目标架构？

使用 uname -m 命令检查你的目标架构。

2. 我可以使用 --target 选项吗？

不，在 Amazon Linux 2 中 --target 选项已弃用。请使用 --platform 选项。

3. 我收到了 "不支持平台" 错误。怎么办？

确保目标架构受支持且与基础映像的架构兼容。

4. 我可以构建多架构映像吗？

是的，可以使用 BuildKit 的 "buildx" 命令构建多架构映像。

5. 为什么指定目标架构很重要？

指定目标架构可确保 Docker 使用正确设置来构建映像，以优化目标环境的性能。

结论

通过启用 BuildKit 并使用 --platform 选项，你现在可以在 Amazon Linux 2 上运行 Docker 时指定目标架构。这将确保 Docker 构建过程使用正确设置，从而优化目标环境的性能。