Holoscan CLI - Run 命令 - NVIDIA 文档

holoscan run - 通过减少与 docker run 相比所需的参数数量，简化了打包的 Holoscan 应用程序的运行。此外，它在启动打包的 Holoscan 应用程序时遵循 HAP 规范的指南。

警告

在 Kubernetes 或其他服务提供商上运行打包的 Holoscan 应用程序，以非 root 用户身份运行 Docker，并运行 Holoscan CLI run 命令，且登录用户的 ID 不同时，请确保指定构建应用程序包时使用的 USER ID。

例如，在使用 Argo 运行 UID=1000 的 Holoscan 打包应用程序时，包含 securityContext

复制
已复制！

            
            spec:
  securityContext:
    runAsUser: 1000
    runAsNonRoot: true

概要

holoscan run [--help|-h] [--log-level|-l {DEBUG,INFO,WARN,ERROR,CRITICAL}] [--address ADDRESS] [--driver] [--input|-i INPUT] [--output|-o OUTPUT] [--fragments|-f FRAGMENTS] [--worker] [--worker-address WORKER_ADDRESS] [--config CONFIG] [--health-check HEALTH_CHECK] [--network|-n NETWORK] [--nic NETWORK_INTERFACE] [--use-all-nics] [--render|-r] [--quiet|-q] [--shm-size][--terminal] [--device] [--gpu] [--uid UID] [--gid GID]image:[tag]

示例

运行打包的 Holoscan 应用程序

复制
已复制！

            
            holoscan run -i /path/to/my/input -o /path/to/application/generated/output my-application:1.0.1

标志

`[--driver]`

在当前计算机上运行 App Driver。可以与 [--worker] 选项一起使用，以在同一台计算机上同时运行 App Driver 和 App Worker。

`[--input|-i INPUT]`

指定应用程序要处理的输入数据的目录路径。指定后，将设置目录挂载到环境变量 HOLOSCAN_INPUT_PATH 中定义的值。

注意

确保主机上的目录可由当前用户或使用 –uid 指定的用户访问。

注意

在 Docker (DooD) 内部运行应用程序时，请使用主机系统路径。

`[--output|-o OUTPUT]`

指定用于存储应用程序生成的工件的目录路径。指定后，将设置目录挂载到环境变量 HOLOSCAN_OUTPUT_PATH 中定义的值。

注意

确保主机上的目录可由当前用户或使用 –uid 指定的用户访问。

`[--fragments|-f FRAGMENTS]`

要由 App Worker 执行的片段的逗号分隔名称。如果未指定，则只会执行一个片段（由 App Driver 选择）。all 可用于运行所有片段。

`[--worker-address WORKER_ADDRESS]`

App Worker 的地址 ([<IP 或主机名>][:<端口>])。如果未指定，App Worker 将使用默认主机地址 (0.0.0.0) 和一个在 10000 到 32767 之间随机选择且当前未使用的端口号。如果工作进程地址是本地 IP 地址，则此参数会自动设置 HOLOSCAN_UCX_SOURCE_ADDRESS 环境变量。有关详细信息，请参阅分布式应用程序的环境变量。

例如

复制
已复制！

            
            --worker-address my_app_network
--worker-address my_app_network:10000

注意

确保 IP 地址未被阻止，并且端口已根据防火墙进行配置。

例如

复制
已复制！

            
            # mount all AJA capture cards
--device ajantv*
# mount AJA capture card 0 and 1
--device ajantv0 ajantv1
# mount V4L2 video device 1 and AJAX capture card 2
--device video1 --device /dev/ajantv2

警告

使用 --device 选项时，在最后一个项目后附加 --，以避免 CLI 误解。例如

复制
已复制！

            
            holoscan run --render --device ajantv0 video1 -- my-application-image:1.0

`[--gpu]`

使用在包清单文件中定义的值或 all（如果未定义），覆盖 NVIDIA_VISIBLE_DEVICES 环境变量的值。

有关所有可用选项，请参阅 GPU 枚举页面。

注意

在具有 iGPU 和 dGPU 的系统上为 iGPU 构建 HAP 时，默认值为 nvidia.com/igpu=0，

注意

单个整数值转换为设备索引，而不是 GPU 的数量。

`[--uid UID]`

以指定的用户 ID (UID) 运行应用程序。默认为当前用户的 UID。

`[--gid GID]`

以指定的组 ID (GID) 运行应用程序。默认为当前用户的 GID。

注意

Holoscan 应用程序支持各种用于配置的环境变量。有关详细信息，请参阅分布式应用程序的环境变量。

Holoscan CLI - Run 命令

概要

示例

位置参数

`image:[tag]`

标志

`[--address ADDRESS]`

`[--driver]`

`[--input|-i INPUT]`

`[--output|-o OUTPUT]`

`[--fragments|-f FRAGMENTS]`

`[--worker]`

`[--worker-address WORKER_ADDRESS]`

`[--config CONFIG]`

`[--health-check HEALTH_CHECK]`

`[--network|-n NETWORK]`

`[--nic NETWORK_INTERFACE]`

`[--use-all-nics]`

`[--render|-r]`

`[--quiet|-q]`

`[--shm-size]`

`[--terminal]`

`[--device]`

`[--gpu]`

`[--uid UID]`

`[--gid GID]`