version
显示 DVC 版本以及环境和项目信息。
概要
描述
dvc version
输出有关系统/环境的以下信息:
行 | 详细信息 |
---|---|
DVC 版本 | DVC 的版本,以及用于安装 DVC 的二进制文件或包管理器名称(如 pip 、conda 等),如果是开发版本,则还会包含 Git 提交哈希 |
平台 | DVC 所在环境中 Python 的版本,以及操作系统相关信息 |
支持的功能 | 当前 DVC 配置所支持的 远程存储 类型(其所需的依赖项已安装) |
缓存类型 | 支持的 链接类型(工作区 workspace 与缓存 cache 之间) |
缓存目录 | 缓存 cache 目录所在磁盘的文件系统类型(例如 ext4、FAT 等)和驱动器信息 |
远程配置 | 仓库中配置的远程 位置类型(例如 SSH、S3、Google Drive 等) |
工作区目录 | 工作区 workspace 所在磁盘的文件系统类型(例如 ext4、FAT 等)和驱动器信息 |
仓库 | 显示当前是否处于 DVC 仓库和/或 Git 仓库中 |
如果在 DVC 项目之外使用
dvc version
,则不会打印有关Cache
或Workspace directory
的信息。
请注意,如果你使用
pip
安装 DVC,则需要手动运行pip install psutil
安装psutil
,才能使dvc version
显示文件系统信息。更多信息请参见 GitHub 上的原始 issue。
DVC 版本组成
DVC 版本的具体信息取决于 DVC 的安装方式。
-
正式发布版:DVC 的稳定版本(例如
1.10.0
),可通过 安装存储在 Python Packaging Authority 中的官方包或使用二进制文件进行安装。这些版本在 DVC 仓库中有对应标签(参见 changelog 查看发布历史)。如果官方构建版本报告了问题,可以使用官方版本号进行追踪。
-
开发版本:包含 DVC 仓库
master
分支在最新正式发布之后的所有更改。可以通过克隆 DVC 仓库后进行 安装。由于该版本可能包含尚未准备发布的更改,因此使用时可能会遇到问题。使用开发版本报告的任何错误,都可以通过
dvc version
输出中的 Git 提交哈希进行追踪,例如:1.10.0+292cab.mod
。加号+
前的部分是官方版本号,之后的部分是master
分支顶端的提交哈希。.mod
这个可选后缀表示代码已被修改。 -
二进制文件或包管理器:显示 DVC 是如何下载并 安装 的。
DVC 可以通过以下二进制发行版之一进行安装:
- Debian 包(
.deb
)——用于在多个 Linux 发行版(如 Ubuntu)中安装软件包的文件 - Red Hat 包(
.rpm
)——用于在某些基于 Linux 的发行版(如 Fedora、CentOS 等)中安装软件包的文件 - PKG 文件(
.pkg
)——用于在 macOS 上安装应用程序的文件 - Windows 可执行文件(
.exe
)——用于在 Windows 上安装应用程序的文件
这些下载资源可从我们的主页获取。它们最终包含一个二进制包,即软件应用程序的可执行文件,这意味着它将在特定平台(Linux、Windows、macOS)上原生运行。
我们使用PyInstaller将源代码打包成二进制程序包。
DVC 也可以通过包管理器进行下载和安装:
- DVC 的 GitHub 仓库 - 核心源代码的托管位置
- Python 包索引 (PyPI) - 源代码以 Python 包的形式存储
- Homebrew 包管理器(适用于 macOS 系统)- 源代码以 Python 包形式存储
这种安装方式需要先下载 DVC 的源代码,并按照一定的设置说明(参见开发指南)构建应用程序后才能使用。
- Debian 包(
选项
-
-h
,--help
- 打印使用说明/帮助信息,然后退出。 -
-q
,--quiet
- 不向标准输出写入任何内容。如果没有问题则以 0 退出,否则以 1 退出。 -
-v
,--verbose
- 显示详细的跟踪信息。
示例
获取 DVC 版本和环境信息:
在 DVC 项目内部:
$ dvc version
DVC version: 1.10.0 (pip)
---------------------------------
Platform: Python 3.8.3 on Linux-5.4.0-47-generic-x86_64-with-debian-buster-sid
Supports: gs, hdfs, http, https, s3
Cache types: hardlink, symlink
Cache directory: ext4 on /dev/sda1
Caches: local
Remotes: https, s3, ssh
Workspace directory: ext4 on /dev/sda1
Repo: dvc, git
在 DVC 项目外部:
$ dvc version
DVC version: 1.10.0 (pip)
---------------------------------
Platform: Python 3.8.3 on Linux-5.4.0-47-generic-x86_64-with-debian-buster-sid
Supports: All remotes