remote

一组用于设置和管理远程存储的命令： add、default、list、modify、remove 和 rename。

概要

usage: dvc remote [-h] [-q | -v] {add,default,remove,modify,list} ...

positional arguments:
  COMMAND
    add                 Add remote.
    default             Set/unset default remote.
    remove              Remove remote.
    modify              Modify remote.
    list                List available remotes.

描述

DVC 远程（remotes）是用于存放数据集和机器学习模型的分布式存储位置（类似于 Git 远程仓库，但针对的是缓存资产）。这个可选功能通常用于共享或备份全部或部分数据。支持多种类型：Amazon S3、Google Drive、SSH、HTTP、本地文件系统，以及其他类型。

了解更多关于远程存储的信息。

dvc remote 子命令用于读取或修改 DVC 配置文件（默认为 .dvc/config）。此外，也可以手动编辑这些配置文件。

选项

-h, --help - 打印使用说明/帮助信息，然后退出。
-q, --quiet - 不向标准输出写入任何内容。如果没有问题则以 0 退出，否则以 1 退出。
-v, --verbose - 显示详细的跟踪信息。

示例：添加一个默认的本地远程

了解更多关于本地远程的信息。

我们在此使用 dvc remote add 的 -d（--default）选项：

$ dvc remote add -d myremote /path/to/remote

项目的配置文件现在应如下所示：

['remote "myremote"']
    url = /path/to/remote
[core]
    remote = myremote

示例：列出项目中的所有远程

$ dvc remote list
myremote    /path/to/remote    (default)
newremote    s3://mybucket/path

示例：自定义一个额外的 S3 远程

💡 在添加 S3 远程之前，请确保已创建存储桶。

$ dvc remote add newremote s3://mybucket/path
$ dvc remote modify newremote endpointurl https://object-storage.example.com

项目的配置文件现在应该类似于这样：

['remote "myremote"']
    url = /path/to/remote
[core]
    remote = myremote
['remote "newremote"']
    url = s3://mybucket/path
    endpointurl = https://object-storage.example.com

示例：更改远程的名称

dvc remote modify 无法更改 DVC 远程的名称，但有一个专门的子命令用于此操作：

$ dvc remote rename oldremote newremote

示例：移除一个远程

$ dvc remote remove oldremote