运行 Docker 容器

Qualcomm Linux 支持 Docker 容器。要使用 Docker 容器，请确保 Qualcomm 板级支持包（BSP）已启用虚拟化功能。在您的工作区中启用 meta-virtualization 层，以便在 Qualcomm Linux 设备上使用容器。

​

验证 Docker 守护进程的状态

qcom-multimedia-image 已启用 Docker。 对于 qcom-multimedia-image 镜像配方，packagegroup-container 通过 meta-qcom-distro/recipes-products/images/qcom-multimedia-image.bb 被包含。packagegroup-container 在 meta-virtualization 层的 recipes-core/packagegroups/packagegroup-container.bb 中定义。镜像构建并烧写后，Docker 及其所有先决条件和依赖项都将在设备上可用。 要验证 Docker 守护进程的状态，请运行以下命令并验证输出：

命令	说明	输出
systemctl status docker	如果开机后至少运行过一次 Docker 命令	Active（running）
	如果设备在开机后未运行过任何 Docker 命令	Inactive（stopped）

从 Docker 仓库拉取的适用于 linux/arm64 平台且经过测试可在设备上成功运行的镜像如下：

• busybox
• python
• alpine
• ubuntu
• postgres
• mongo
• nginx
• redis

在启用 Docker 的情况下，以下用例已通过验证：

• 使用 Docker load 工具从 tar 文件加载 Docker 镜像。
• 从 Docker 文件构建 Docker 镜像。
• 将拉取/构建的 Docker 镜像保存为 .tar 文件。
• 加载保存为 .tar 文件的 Docker 镜像。
• 运行多个拉取/构建镜像的多个容器实例。
• 验证设备上已加载的 Docker 镜像列表。
• 验证设备上活跃容器和全部容器的列表。
• 使用 Docker inspect 工具检查 Docker 镜像。
• 使用 Docker logs 工具获取容器的日志。
• 使用 Docker stop 和 Docker kill 工具停止和终止容器。
• 从设备中移除容器和 Docker 镜像。

​

从 Docker 访问硬件节点

在 Docker 容器内运行的应用程序可能需要访问设备上的设备节点和文件（因为设备是 Docker 容器的宿主机）。以下是两种方法：

1. 将相应的设备节点作为选项与 run 命令一起传递给 Docker 来执行此任务：
   docker run -it --rm --device=<device-1> --device=<device-2> <docker-image-name>
   
   传递位于设备上 /dev 目录中的设备节点。根据用例，例如在图形场景中，使用 --device=/dev/kgsl-3d0 将 /dev/kgsl-3d0 传递给 Docker。 在 Docker 容器内运行的应用程序可能还需要访问设备（目标宿主机）上的存储。要以绑定挂载的方式公开文件和目录，请运行以下命令：
   docker run -it --rm --mount type=bind,source=<source-path-on-device>,target=<destination-path-inside-container> <docker-image-name>
   
   使用以下命令运行 docker 容器，向容器公开多个目录、文件和设备节点：
   docker run -it --rm --device=<device-1> --device=<device-2> --mount type=bind,source=<source-path-on-device-1>,target=<destination-path-inside-container-1>  --mount type=bind,source=<source-path-on-device-2>,target=<destination-path-inside-container-2> <docker-image-name>
   
2. 使用容器设备接口（CDI）创建 CDI JSON/YAML 文件并将其放置在以下位置：
   /etc/cdi/ (persistent)
   /var/run/cdi/ (dynamic, auto-generated)
   
   使用以下命令运行带有 CDI 设备的容器：
   docker run -it --device <vendor.com/device-kind>=<cdi-device-name> <image> <command>
   

​

在 Qualcomm Linux 设备上运行 Docker Compose

Docker Compose 是一款用于定义和运行多容器应用程序的工具。它通过在一个易于理解的 YAML 配置文件中定义服务、网络和卷，简化了应用程序堆栈的管理。默认情况下，Qualcomm Linux 版本在 qcom-multimedia-image 中包含 Docker Compose。 docker-compose 软件包在 meta-qcom-distro 元数据层中被添加到 qcom-multimedia-image。 要了解有关 Docker Compose 的更多信息，请参阅 Docker Compose 概述。 要在设备上运行 Docker Compose：

1. 在设备上的可写路径（例如 /var，比如 /var/docker-compose-yaml）下创建或复制 Docker Compose YAML 文件，以便在设备上与 Docker Compose 一起使用。
2. 确保 Docker Compose YAML 文件中列出的 Docker 镜像在设备上可用。如果不可用，设备应连接到有效的互联网以拉取 docker 镜像。
3. 要为多个 YAML 文件运行 Docker Compose，请运行以下命令：
   docker compose -f <docker-compose-file-1>.yml -f <docker-compose-file-2>.yml up
   
   Docker Compose 会按照 Docker Compose YAML 文件中的配置运行并启动 Docker 容器。
4. Docker Compose 命令返回后，运行 docker ps -a 和 docker logs <container-id>，以验证 docker 容器是否按预期运行。

​

后续步骤

• 有关 Kubernetes 的启用，请参阅使用 Qualcomm Linux 设置 Kubernetes。
• 有关虚拟机设置，请参阅创建辅助虚拟机。
• 有关 OTA 更新，请参阅使用 capsule 和 OSTree 机制更新 Qualcomm Linux 上的固件和操作系统。