如何将Python脚本Docker化并部署到ARM架构树莓派4？

我有一个需要在树莓派4上运行的Python脚本，计划将其Docker化。最初的Dockerfile配置如下：

FROM python:3

WORKDIR /usr/src/app

copy main.py .
copy requirements.txt .

run pip install --no-cache-dir -r requirements.txt

CMD ["python", "./main.py"]

但由于树莓派采用ARM架构，FROM python:3无法适用。随后我尝试了FROM arm32v7/python:3、FROM python:3-slim-stretch-arm32v7、FROM arm32v7/python:3.7-slim-buster等ARM架构镜像，但构建时均出现报错，报错信息如下：

> 2023/07/03 13:25:05 http2: server: error reading preface from client
> //./pipe/docker_engine: file has already been closed [+] Building 0.8s
> (3/3) FINISHED                                                        
> docker:default  => [internal] load build definition from Dockerfile   
> 0.0s  => => transferring dockerfile: 326B                                                                                                                    0.0s   => [internal] load .dockerignore                                                                                                                       0.0s   => => transferring context: 2B                                                                                                                         0.0s   => ERROR [internal] load metadata for docker.io/library/python:3-slim-stretch-arm32v7                       
> 0.7s 
> ------
>  > [internal] load metadata for docker.io/library/python:3-slim-stretch-arm32v7:
> ------ Dockerfile:1
> --------------------    1 | >>> FROM python:3-slim-stretch-arm32v7    2 |    3 |     WORKDIR /usr/src/app
> -------------------- ERROR: failed to solve: python:3-slim-stretch-arm32v7:
> docker.io/library/python:3-slim-stretch-arm32v7: not found

我已找到arm32v7/python镜像，但仍无法正常使用，请问如何正确将Python脚本Docker化并在树莓派4上运行？

1. 修正镜像标签格式 #

树莓派4兼容ARMv7架构，使用官方arm32v7/python镜像时，要注意标签的正确格式：

• 错误写法：python:3-slim-stretch-arm32v7（把架构后缀加在版本后，官方无此标签）
• 正确写法：arm32v7/python:3 或指定具体稳定版本如arm32v7/python:3.9-slim-buster，确保标签在官方镜像仓库存在。

2. 树莓派本地构建（优先推荐） #

直接在树莓派4上执行构建命令，避免跨架构适配问题：

docker build -t my-python-app .

若存在缓存导致的异常，强制重新构建：

docker build --no-cache -t my-python-app .

3. 跨架构构建（x86机器上构建ARM镜像） #

如果需要在x86架构电脑上构建树莓派用的镜像，开启Docker buildx功能：

• 创建并启用跨架构构建器：

docker buildx create --use

• 构建ARM架构镜像：

docker buildx build --platform linux/arm/v7 -t my-python-app .

4. 规范Dockerfile示例 #

修正后的标准Dockerfile：

# 使用正确的ARMv7 Python镜像
FROM arm32v7/python:3.9-slim

WORKDIR /usr/src/app

# 先复制依赖文件，利用Docker缓存优化构建速度
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制脚本文件
COPY main.py .

CMD ["python", "./main.py"]

注意：Dockerfile指令为大小写敏感，规范写法是大写COPY/RUN，而非小写。

5. 验证镜像架构 #

构建完成后，确认镜像适配ARM架构：

docker inspect my-python-app | grep Architecture

输出应显示"Architecture": "arm"或"Architecture": "armv7"

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