remote default

设置或取消默认的 dvc remote。

概要

usage: dvc remote default [-h]
                          [--global | --system | --project | --local]
                          [-q | -v] [-u]
                          [name]

positional arguments:
  name           Name of the remote.

描述

您可以使用本命令的选项查询、设置、替换或取消默认远程存储。如果未提供远程的 name 且未指定 --unset，则此命令将返回默认远程的名称。

$ dvc remote default myremote

此命令会在 DVC 配置文件的 core 部分中设置默认远程。

[core]
remote = myremote

当省略 -r/--remote 选项时，接受该选项的命令（dvc pull、dvc push、dvc status、dvc gc、dvc fetch）会默认使用此设置。

您也可以使用 dvc config、dvc remote add 或 dvc remote modify 命令来设置、取消或修改默认远程。

如果设置了默认远程，则 dvc remote list 命令的输出会明确标识它，参见下方示例。

远程配置按以下顺序从系统、全局、项目和本地配置文件中读取。

选项

• -u, --unset - 从配置文件中取消当前默认远程。

• --system - 将远程配置保存到或仅从系统配置文件（例如 /etc/xdg/dvc/config）读取，而非 .dvc/config。

• --global - 将远程配置保存到或仅从全局配置文件（例如 ~/.config/dvc/config）读取，而非 .dvc/config。

• --project - 将远程配置保存到或仅从项目的配置文件（.dvc/config）读取（默认行为）。

• --local - 将远程配置保存到或仅从 Git 忽略的本地配置文件（位于 .dvc/config.local）读取，而非 .dvc/config。此选项适用于保存您不希望被 Git 跟踪或共享的私有远程配置。

• -h, --help - 打印使用说明/帮助信息并退出。

• -q, --quiet - 不向标准输出写入任何内容。如果没有问题则以 0 退出，否则以 1 退出。

• -v, --verbose - 显示详细的跟踪信息。

示例

将 myremote 设置为默认远程：

$ dvc remote default myremote

获取默认远程：

$ dvc remote default

myremote

通过列出所有远程来查看默认远程（如果已设置）：

$ dvc remote list
myremote    /path/to/remote    (default)
otherremote    /path/to/other/remote

更改默认远程值：

$ dvc remote default mynewremote

在 DVC 配置文件中，更新后的默认远程值可在 core 部分找到（运行 cat .dvc/config）：

[core]
remote = mynewremote

清除/取消默认远程值：

$ dvc remote default -u