树莓派3部署Fiware Orion Sensor Agent Docker配置失败求助

当前使用的docker-compose.yml配置如下：

version: "3.3"
services:
   tutorial: 
    image: fiware/tutorials.context-provider
    hostname: iot-sensors
    container_name: fiware-tutorial
    networks:
        - default
    expose:
        - "3000"
        - "3001"
    ports:
        - "3000:3000"
        - "3001:3001"
    environment:
        - "DEBUG=tutorial:*"
        - "PORT=3000"
        - "IOTA_HTTP_HOST=iot-agent"
        - "IOTA_HTTP_PORT=7896"
        - "DUMMY_DEVICES_PORT=3001"
        - "DUMMY_DEVICES_API_KEY=4jggokgpepnvsb2uv4s40d59ov"

部署环境为运行Debian 11 Bullseye系统的树莓派3，部署Fiware相关组件时无法正常运行。

• 架构不兼容：树莓派3为ARM架构（32位Debian 11对应armv7/armhf，64位对应arm64），默认拉取的fiware/tutorials.context-provider官方镜像仅提供x86_64架构构建版本，直接运行会触发exec format error，容器启动即退出，这是ARM设备运行x86专属镜像的典型报错。
• 依赖服务缺失：当前配置仅定义了模拟传感器的tutorial服务，环境变量中指定的iot-agent服务、以及Fiware运行必备的MongoDB数据库、Orion上下文代理服务均未定义，tutorial服务启动后无法连接到依赖组件，就算镜像架构匹配也会持续报连接拒绝错误。
• 系统配置适配问题：Debian 11 Bullseye默认启用cgroup v2，部分旧版本Fiware相关镜像未做cgroup v2适配，会出现权限异常、资源参数读取失败的问题，导致容器无法正常启动。

1. 解决架构适配问题
   先执行docker manifest inspect fiware/tutorials.context-provider查看镜像支持的架构列表，如果没有对应ARM架构的构建层，直接拉取Fiware官方仓库的tutorial.context-provider源码，在树莓派本地执行docker build -t fiware/tutorials.context-provider .构建ARM原生镜像即可。其余Fiware官方组件（Orion、IoT Agent、Mongo）均已提供ARM架构镜像，无需额外编译。
2. 补全全栈服务配置
   不要单独启动tutorial服务，将所有依赖的核心服务加入同一个compose配置中，参考如下完整配置：

   version: "3.3"
   services:
     mongo-db:
       image: mongo:4.4
       volumes:
         - mongo-data:/data/db
       restart: always
   
     orion:
       image: fiware/orion:3.10.1
       depends_on:
         - mongo-db
       command: -dbhost mongo-db -logLevel INFO
       ports:
         - "1026:1026"
       restart: always
   
     iot-agent:
       image: fiware/iotagent-http:2.4.0
       depends_on:
         - mongo-db
         - orion
       environment:
         - IOTA_CB_HOST=orion
         - IOTA_CB_PORT=1026
         - IOTA_NORTH_PORT=7896
         - IOTA_MONGO_HOST=mongo-db
         - IOTA_MONGO_DB=iotagentjson
       expose:
         - "7896"
       restart: always
   
     tutorial: 
       image: fiware/tutorials.context-provider
       hostname: iot-sensors
       container_name: fiware-tutorial
       depends_on:
         - iot-agent
         - orion
       expose:
         - "3000"
         - "3001"
       ports:
         - "3000:3000"
         - "3001:3001"
       environment:
         - "DEBUG=tutorial:*"
         - "PORT=3000"
         - "IOTA_HTTP_HOST=iot-agent"
         - "IOTA_HTTP_PORT=7896"
         - "DUMMY_DEVICES_PORT=3001"
         - "DUMMY_DEVICES_API_KEY=4jggokgpepnvsb2uv4s40d59ov"
         - "CB_HOST=orion"
         - "CB_PORT=1026"
       restart: always
   
   volumes:
     mongo-data:
   

3. 适配cgroup配置
   如果启动时出现cgroup相关权限报错，编辑/boot/firmware/cmdline.txt，在现有行末尾追加cgroup_enable=cpuset cgroup_memory=1 cgroup_enable=memory，保存后重启树莓派即可。如果仍有cgroup兼容问题，执行apt install cgroupfs-mount && update-grub后重启，切换回cgroup v1即可兼容旧版本镜像。
4. 排查验证
   配置修改完成后执行docker compose up -d启动全栈服务，若仍有异常，执行docker logs fiware-tutorial查看具体报错：如果是exec格式错误就是镜像架构不匹配，如果是连接拒绝就检查对应服务是否正常启动、同网络下是否能正常解析服务名。

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