简介
玲珑ll-cli 是玲珑应用的命令行工具，用于搜索、安装、运行、升级、卸载玲珑应用，以及管理运行实例、运行时和远程仓库。
安装
当前系统默认已安装此工具，对应软件包名：linglong-bin。
查看工具版本：
ll-cli --versionlinyaps CLI version 1.12.2使用
ll-cli 支持以下一级子命令：run、ps、enter、kill、prune、install、uninstall、upgrade、list、info、content、search、repo。
$ ll-cli --help
linyaps CLI
A CLI program to run application and manage application and runtime
Usage: ll-cli [OPTIONS] [SUBCOMMAND]
Options:
-h,--help Print this help message and exit
--help-all Expand all help
--version Show version
--json Use json format to output result
-v,--verbose Show debug info (verbose logs)
--no-progress Don't output progress information1.子命令
| 子命令 | 描述 | 说明 |
| run | 运行应用 | 启动玲珑应用，也可在沙箱中执行指定命令 |
| ps | 查看实例 | 列出当前正在运行的应用实例 |
| enter | 进入容器 | 进入指定运行实例所在的命名空间执行命令 |
| kill | 停止实例 | 停止正在运行的应用实例 |
| prune | 清理环境 | 清理未使用的base 或 runtime |
| install | 安装应用 | 安装应用、运行时，或从.layer、.uab 文件安装 |
| uninstall | 卸载应用 | 卸载已安装的应用或运行时 |
| upgrade | 升级应用 | 升级指定应用，或升级全部已安装应用及依赖 |
| list | 查询已安装内容 | 列出本地已安装的应用、base、runtime |
| info | 查看详情 | 查看本地已安装应用或运行时的详细信息 |
| content | 查看导出内容 | 查看应用导出的文件内容 |
| search | 搜索应用 | 从远程仓库搜索应用、base 或 runtime |
| repo | 仓库管理 | 查看、添加、修改、切换远程仓库配置 |
2.Flags
| Flags | 说明 | 备注 |
| -h, --help | 显示命令帮助 | 所有命令及其子命令均支持 |
| --help-all | 展开完整帮助 | 用于查看更完整的参数说明 |
| --version | 显示版本信息 | 用于确认当前ll-cli 版本 |
| --json | 以JSON 格式输出结果 | 便于脚本调用和结果解析 |
| -v, --verbose | 输出调试日志 | 排查安装、运行问题时常用 |
| --no-progress | 不显示进度信息 | 适合自动化脚本或非交互环境 |
3.应用运行管理
使用说明
$ ll-cli run --helpRun an applicationUsage: ll-cli run [OPTIONS] APP [COMMAND...]命令介绍
| 功能 | 命令 | 说明 |
| 启动应用 | ll-cli run org.deepin.demo | 按应用ID 启动已安装应用 |
| 在容器内执行命令 | ll-cli run org.deepin.demo -- bash | 不启动图形界面，直接在沙箱内执行命令 |
| 传入文件 | ll-cli run org.deepin.demo --file /path/to/file | 启动应用并向应用传递文件 |
| 传入URL | ll-cli run org.deepin.demo --url https://example.com | 启动应用并向应用传递URL |
| 指定环境变量 | ll-cli run org.deepin.demo --env KEY=VALUE | 为应用运行时追加环境变量 |
| 指定工作目录 | ll-cli run org.deepin.demo --workdir /tmp | 指定应用运行目录 |
| 查看运行实例 | ll-cli ps | 列出当前运行中的实例 |
| 进入运行实例 | ll-cli enter <appid> /bin/bash | 进入指定实例执行命令 |
| 停止运行实例 | ll-cli kill <instance-id> | 停止指定运行中的实例 |
| 发送指定信号停止实例 | ll-cli kill <instance-id> --signal SIGKILL | 按指定信号终止实例 |
| 清理未使用运行环境 | ll-cli prune | 删除未使用的base 或 runtime |
示例
启动应用：
ll-cli run org.deepin.demo在容器内执行shell：
ll-cli run org.deepin.demo -- bash查看运行中的实例：
ll-cli ps进入运行实例：
ll-cli enter <instance-id> /bin/bash4.应用安装与维护
使用说明
$ ll-cli install --helpInstalling an application or runtimeUsage: ll-cli install [OPTIONS] APP命令介绍
| 功能 | 命令 | 说明 |
| 安装应用 | ll-cli install org.deepin.demo | 从默认仓库安装应用 |
| 安装指定版本 | ll-cli install org.deepin.demo/0.0.0.1 | 安装指定版本应用 |
| 安装指定模块 | ll-cli install org.deepin.demo --module=binary | 安装应用指定模块 |
| 从.layer 安装 | ll-cli install demo_0.0.0.1_x86_64_binary.layer | 从本地layer 包安装 |
| 从.uab 安装 | ll-cli install demo_x86_64_0.0.0.1_main.uab | 从本地UAB 包安装 |
| 指定仓库安装 | ll-cli install org.deepin.demo --repo stable | 从指定仓库安装应用 |
| 强制安装 | ll-cli install org.deepin.demo --force | 强制覆盖安装 |
| 自动确认 | ll-cli install org.deepin.demo -y | 自动回答yes，适合脚本场景 |
| 卸载应用 | ll-cli uninstall org.deepin.demo | 卸载已安装应用 |
| 卸载指定模块 | ll-cli uninstall org.deepin.demo --module=binary | 卸载应用指定模块 |
| 升级指定应用 | ll-cli upgrade org.deepin.demo | 升级单个应用 |
| 升级全部应用 | ll-cli upgrade | 升级所有已安装应用及运行依赖 |
| 仅升级依赖 | ll-cli upgrade org.deepin.demo --deps-only | 仅升级依赖，不升级应用本体 |
| 仅升级应用本体 | ll-cli upgrade org.deepin.demo --app-only | 仅升级应用本体 |
| 查看已安装内容 | ll-cli list | 列出本地全部应用、base、runtime |
| 仅查看base | ll-cli list --type=base | 仅查看已安装base |
| 仅查看runtime | ll-cli list --type=runtime | 仅查看已安装runtime |
| 查看可升级内容 | ll-cli list --upgradable | 查看当前可升级的应用和运行环境 |
| 查看应用详情 | ll-cli info org.deepin.demo | 查看应用详细信息 |
| 查看导出内容 | ll-cli content org.deepin.demo | 查看应用导出的文件 |
示例
安装应用：
ll-cli install org.deepin.demo安装本地UAB：
ll-cli install demo_x86_64_0.0.0.1_main.uab升级全部已安装应用：
ll-cli upgrade查看已安装runtime：
ll-cli list --type=runtime5.远程仓库管理
使用说明
$ ll-cli repo --helpDisplay or modify information of the repository currently usingUsage: ll-cli repo SUBCOMMAND [OPTIONS]repo 支持以下子命令：add、remove、update、set-default、show、set-priority、enable-mirror、disable-mirror。
命令介绍
| 功能 | 命令 | 说明 |
| 查看仓库信息 | ll-cli repo show | 查看当前仓库配置 |
| 添加仓库 | ll-cli repo add <name> <url> | 添加新的远程仓库 |
| 添加仓库别名 | ll-cli repo add <name> <url> --alias <alias> | 给仓库设置别名 |
| 删除仓库 | ll-cli repo remove <alias> | 删除指定仓库 |
| 更新仓库地址 | ll-cli repo update <alias> <url> | 更新仓库URL |
| 设置默认仓库 | ll-cli repo set-default <alias> | 切换默认使用的仓库 |
| 设置仓库优先级 | ll-cli repo set-priority <alias> <priority> | 设置仓库优先级 |
| 启用镜像 | ll-cli repo enable-mirror <alias> | 启用仓库镜像 |
| 禁用镜像 | ll-cli repo disable-mirror <alias> | 禁用仓库镜像 |
示例
查看仓库配置：
ll-cli repo show添加仓库：
ll-cli repo add myrepo https://example.com/repo设置默认仓库：
ll-cli repo set-default myrepo6.应用搜索
使用说明
$ ll-cli search --helpSearch the applications/runtimes containing the specified text from the remote repositoryUsage: ll-cli search [OPTIONS] KEYWORDS命令介绍
| 功能 | 命令 | 说明 |
| 搜索应用 | ll-cli search org.deepin.demo | 按关键字搜索远程应用 |
| 搜索全部条目 | ll-cli search . | 查询远程仓库中的全部内容 |
| 仅搜索base | ll-cli search . --type=base | 仅显示base |
| 仅搜索runtime | ll-cli search . --type=runtime | 仅显示runtime |
| 指定仓库搜索 | ll-cli search org.deepin.demo --repo stable | 从指定仓库搜索 |
| 包含develop 结果 | ll-cli search org.deepin.demo --dev | 显示develop 应用 |
| 显示全部版本 | ll-cli search org.deepin.demo --show-all-version | 显示匹配项的全部版本 |
示例
搜索应用：
ll-cli search org.deepin.demo查看远程仓库中的全部runtime：
ll-cli search . --type=runtime7.常用场景
1. 搜索并安装应用
ll-cli search org.deepin.demoll-cli install org.deepin.demo2. 运行应用并查看实例
ll-cli run org.deepin.demoll-cli ps3. 进入运行中的容器排查问题
ll-cli enter <instance-id> /bin/bash4. 查看本地应用详情和导出内容
ll-cli info org.deepin.demoll-cli content org.deepin.demo5. 升级并清理无用运行环境
ll-cli upgradell-cli prune©统信软件技术有限公司。访问者可将本网站提供的内容或服务用于个人学习、研究或欣赏，以及其他非商业性或非盈利性用途，但同时应遵守著作权法及其他相关法律的规定，不得侵犯本网站及相关权利人的合法权利。除此以外，将本网站任何内容或服务进行转载，须备注：该文档出自【faq.uniontech.com】统信软件知识分享平台。否则统信软件将追究相关版权责任。
