# 将 Qualcomm IM SDK 部署为容器
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html)
在 Docker 容器内构建 Qualcomm IM SDK 并准备可以部署至支持 Qualcomm Linux 的 Edge 设备中的最终的设备 Docker 镜像。您可以使用 AI 工作流的微服务和 Qualcomm IM SDK 构建各种类型的 AI pipeline。
Figure : 容器内的 Qualcomm IM SDK - 架构
该表列出了从源代码构建 Qualcomm IM SDK docker 容器所需的组件：
Table : Qualcomm IM SDK docker 容器组件
| 组件 | 说明 |
| :--- | :--- |
| Platform eSDK |
- 提供 Qualcomm IM SDK 的平台依赖项。
- 包含平台库和头文件。
|
| QualcommIM SDK 源代码 | 包含插件和配方文件的源代码，用于构建和定义编译时依赖项。 |
| solutions-microservices | 提供微服务所需的 AI pipeline。 |
| sdk-tools |
- 提供 docker 文件和一组帮助程序脚本来生成 Qualcomm IM SDK 设备 docker 容器。
- 为参考 docker 提供run命令，以及用于运行 docker 容器的 YAML 组合文件。
- 映射所有必需的平台设备和库，以在 docker 容器内提供硬件加速。
|
## 编译 Qualcomm IM SDK docker 镜像
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html)
### Procedure
1. 创建根工作空间：
mkdir /iot-solutionsCopy to clipboard
root 工作区包含以下内容：
- 已提取的 Platform eSDK
- meta-qti-gst
- gst-plugins-qti-oss
- solutions-microservices
- sdk-tools
- le-services
2. 获取 Platform eSDK。
Platform eSDK 提供以下内容：
- 针对特定环境的一组平台库。
- 为基于 Yocto 的 Qualcomm Linux 发布版本量身定制的交叉开发工具链和库。
您可以使用预编译的 Platform eSDK 或生成自己的 Platform eSDK。该表将指导用户完成这两项操作的具体说明：
| 使用 Platform eSDK | 说明 |
| :--- | :--- |
| 预编译的 Platform eSDK | [下载并安装 Platform
eSDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-51/install-sdk.html) |
| 生成您自己的 Platform eSDK | [生成 eSDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#generate-an-esdk) |
3. 克隆以下项目：
1. Qualcomm IM SDK 项目：
# Clone QIM SDK plugins source
cd /iot-solutions
git clone https://git.codelinaro.org/clo/le/platform/vendor/qcom-opensource/gst-plugins-qti-oss.git -b imsdk.lnx.2.0.0.r2-rel
cd gst-plugins-qti-oss
git fetch origin imsdk.lnx.2.0.0.r2-rel
git checkout FETCH_HEAD
# Clone QIM SDK recipes
cd /iot-solutions
git clone https://git.codelinaro.org/clo/le/meta-qti-gst.git -b imsdk.lnx.2.0.0.r2-rel
cd meta-qti-gst
git fetch origin imsdk.lnx.2.0.0.r2-rel
git checkout FETCH_HEADCopy to clipboard
2. Solutions-Microservices 项目：
cd /iot-solutions
git clone https://git.codelinaro.org/clo/le/solutions-microservices.git -b iot-solutions.lnx.1.0
cd solutions-microservices
git fetch origin iot-solutions.lnx.1.0
git checkout FETCH_HEADCopy to clipboard
3. SDK-tools 项目：
cd /iot-solutions
git clone https://git.codelinaro.org/clo/le/sdk-tools.git -b imsdk-tools.lnx.1.0
cd sdk-tools
git fetch origin imsdk-tools.lnx.1.0
git checkout FETCH_HEADCopy to clipboard
4. Linux 嵌入式 (LE) 服务项目：
cd /iot-solutions
git clone https://git.codelinaro.org/clo/le/platform/vendor/qcom-opensource/le-services.git --single-branch -b le-services.lnx.1.0.r1-rel
cd le-services
git fetch origin le-services.lnx.1.0.r1-rel
git checkout FETCH_HEADCopy to clipboard
4. 配置构建：
Note: 如果您是第一次构建 Qualcomm IM SDK docker，[请在机器上搭建 docker](https://git.codelinaro.org/clo/le/sdk-tools/-/blob/imsdk-tools.lnx.1.0/qimsdk/README.md#Prerequisites)。
为目标设备更新 JSON 配置文件。进入 targets 目录。
cd /iot-solutions/sdk-tools/qimsdk/targetsCopy to clipboard
下图显示了 config.json 文件中的字段：
下表列出了 config.json 文件的字段说明：
| 字段 | 必填/可选 | 说明 |
| :--- | :--- | :--- |
| `"Additional_tag_container"` | 选填 | 将此字符串附加到 docker 镜像名称中。 |
| `"Additional_tag_image"` | 选填 | docker 镜像标记。 |
| `"Docker_image_path"` | 必选 | 导出 docker 镜像和 docker 运行脚本的目录。 |
| `"Target_device_ID"` | 选填 | 设备 ID。如果设备未连接到计算机，则该字段可以为空。 |
| `"IM_SDK_Source_Dir"` | 必选 | 包含 Qualcomm IM SDK GSt 插件源代码的目录。 |
| `"IM_SDK_Meta_Dir"` | 必选 | 包含 Qualcomm IM SDK GSt 插件 BitBake 配方文件夹的目录。 |
| `"Solution_Microservices_Dir"` | 必选 | solutions-microservices 目录，其中包含所有 Qualcomm IM SDK 微服务 Shell 脚本。 |
| `"LE_Services_Source_Dir"` | 必选 | LE-services 目录，其中包含所有 LE 源文件。 |
| ` "Path_to_eSDK_dir"` | 必选 | 提取 Platform eSDK 的目录。 |
5. 编译并导出 docker 镜像：
1. 搭建环境：
cd /sdk-tools/qimsdkCopy to clipboard
source scripts/docker_env_setup.shCopy to clipboard
2. 编译 docker 镜像：
qimsdk-docker-build-image targets/config.jsonCopy to clipboard
3. 将 docker 镜像和 docker 运行脚本导出至 Docker\_image\_path 目录。
qimsdk-docker-device-save-image targets/config.jsonCopy to clipboard
## 加载并运行 docker
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html)
### Procedure
1. 在设备上安装 docker 镜像：
ssh root@Copy to clipboard
密码是 `oelinux123`。
2. 将 docker 镜像从 Linux 主机复制至目标设备：
scp /* root@:/opt/dockerCopy to clipboard
`` 是安装 docker 镜像 TAR 文件和脚本的目录。
3. 验证 docker 目录配置是否成功：
docker info | grep StorageCopy to clipboard
4. 加载 docker 镜像并在设备 shell 中运行 docker：
cd /opt/dockerCopy to clipboard
docker load -i /opt/docker/Copy to clipboard
mv docker-compose-qcs6490.yml docker-compose.ymlCopy to clipboard
chmod 777 docker_run_qcs6490.shCopy to clipboard
`` 是包含 Qualcomm IM SDK docker 镜像的文件的名称。例如， qimsdk.tar。
5. 在设备 shell 中创建 docker 目录：
mkdir -p /opt/dockerCopy to clipboard
chmod -R 777 /opt/dockerCopy to clipboard
## 运行docker 镜像来执行多媒体/AI 用例
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html)
Note: 以下步骤适用于 QCS6490、QCS9075 和 QCS8275。例如，这些命令中使用了 QCS6490。
### 前提条件
1. [编译 Qualcomm IM SDK docker 镜像](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html#build-and-run-qualcomm-im-sdk-docker-image)。
2. [加载并运行 docker](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html#load-and-run-docker)。
### 步骤
shell 脚本中提供了 docker 运行命令。
使用以下命令运行 Qualcomm IM SDK docker 镜像：
- 1. 在设备 shell 中，运行 docker 脚本：
sh /opt/docker/docker_run_qcs6490.shCopy to clipboard
2. 列出所有正在运行的容器：
docker ps -aCopy to clipboard
3. 进入Qualcomm IM SDK 容器
docker exec -it bashCopy to clipboard
### 使用 docker compose 命令（可选）
您可以使用 docker compose 命令在不同的控制台中运行多个 Docker 容器。
要运行 docker compose 命令，请执行以下操作：
- 1. 在设备 shell 中，转到 docker 目录：
cd /opt/dockerCopy to clipboard
2. 运行 docker-compose bash 脚本：
docker-compose run bashCopy to clipboard
| 字段 | 说明 |
| :--- | :--- |
| <qimsdk-docker-image-name> | Qualcomm IM SDK docker 镜像的名称。 |
| qimsdk | 默认的 Docker 镜像。 |
要检查操作名称，请运行 `docker
images` 命令。
## 运行摄像头容器用例
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/application-deployment-within-container-api-gstd.html)
1. 启用显示屏：
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1Copy to clipboard
2. 例如，运行来自实时源的单个 1080p YUV 视频流的用例：
gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! waylandsink fullscreen=true sync=falseCopy to clipboard
如需了解更多用例，请参阅 [运行多媒体用例](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multimedia-use-cases.html)。
### 已知问题
- 在 docker 中未启用对以下内容的支持：
- GStd。
- NV12 UBWC 压缩流。
- 示例应用程序依赖于 NV12 UBWC。
- 在 docker 内不支持 [gst-ai-usb-camera-app](https://docs.qualcomm.com/doc/80-70018-50SC/topic/ai-usb-camera.html) 应用程序。
- [gst-ai-multi-input-output-object-detection](https://docs.qualcomm.com/doc/80-70018-50SC/topic/gst-ai-multi-input-output-object-detection.html) 应用程序不支持 RTSP 接收。
- 在 docker 内的 [gst-ai-parallel-inference](https://docs.qualcomm.com/doc/80-70018-50SC/topic/gst-ai-parallel-inference.html) 应用程序中，观察到有轻微的丢帧现象。
- 在 docker 内的 [gst-ai-daisychain-detection-pose](https://docs.qualcomm.com/doc/80-70018-50SC/topic/daisy-chain-detection-and-pose-detection.html) 应用程序不支持编码。
- 在 docker 内不支持 [gst-ai-face-detection](https://docs.qualcomm.com/doc/80-70018-50SC/topic/gst-ai-face-detection.html) 和 [gst-ai-face-recognition](https://docs.qualcomm.com/doc/80-70018-50SC/topic/gst-ai-face-recognition.html) 示例应用程序。
Last Published: Nov 12, 2025
[Previous Topic
自定义 Python 示例应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/customize-a-python-sample-application.md) [Next Topic
GStreamer 命令行用例](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/gstreamer-application-use-cases.md)