yadm - 云端在线

程序：

您的姓名

yadm - 另一个点文件管理器

概要

亚德姆 命令 [选项]

亚德姆 git 命令或别名 [选项]

亚德姆 在里面 [-f[-w 目录]

亚德姆 克隆 网址 [-f[-w 目录]

亚德姆 配置 姓名 [折扣值]

亚德姆 配置 [-e]

亚德姆 列表 [-a]

亚德姆 加密

亚德姆 解密 [-l]

亚德姆 ALT

亚德姆 烫发

商品描述

亚德姆 是一种跨多台计算机管理文件集合的工具，使用
共享 Git 存储库。 此外， 亚德姆 提供选择替代版本的功能
基于操作系统或主机名的文件。 最后， 亚德姆 提供能力
管理安全文件的子集，这些文件在被包含在
库。

指令

git 命令 or git别名
任何不在内部处理的命令 亚德姆 被传递到 混帐(1). 吉特
命令或别名使用 亚德姆 托管存储库。 工作的
git 命令的目录将是配置好的 工作树 （通常 $ HOME).

点文件使用标准管理 混帐 命令； 加, 承诺, 推, 拉等等。

这个 配置 命令不直接通过。 而是使用 配置文件
命令（见下文）。

ALT 为匹配中描述的命名规则的任何托管文件创建符号链接
替代部分。 通常没有必要运行这个命令，因为 亚德姆
默认情况下自动处理交替。 这种自动行为可以是
通过设置配置禁用 yadm.auto-alt 为“假”。

克隆 网址
克隆一个用于跟踪点文件的远程存储库。 遥控后的内容
已获取存储库，“合并” 起源/主人 被尝试。 如果有
冲突文件已经存在于 工作树，此合并将失败并且
取而代之的是“重置” 起源/主人 将会完成。 由用户自行解决
这些冲突，但如果所需的操作是将内容放在
存储库覆盖现有文件，然后“硬重置”应该完成
说：

yadm 重置 --hard origin/master

存储库存储在 $HOME/.yadm/repo.git。 默认， $ HOME 将会被使用
作为 工作树，但这可以用 -w 选项。 亚德姆 可
通过提供强制覆盖现有存储库 -f 选项。

配置 此命令管理以下配置 亚德姆. 这个命令完全按照他们的方式工作
混帐配置(1) 确实。 有关更多详细信息，请参阅配置部分。

解码
解密存储在的所有文件 $HOME/.yadm/files.gpg. 解密的文件将是
相对于配置 工作树 （通常 $ HOME）。 使用 -l 选项将
列出存储的文件而不提取它们。

加密
加密与 中找到的模式匹配的所有文件 $HOME/.yadm/加密。 请参阅
加密部分了解更多详情。

配置文件
将选项传递给 混帐 配置 命令。 自从 亚德姆 已经使用 配置 命令
为了管理自己的配置，提供此命令作为更改的一种方式
由管理的存储库的配置 亚德姆. 一个有用的案例可能是
配置存储库，以便在状态命令中显示未跟踪的文件。 亚德姆
最初配置其存储库，以便不显示未跟踪的文件。 如果你
希望使用默认的 git 行为（以显示未跟踪的文件和目录），您
可以去掉这个配置。

yadm gitconfig --unset status.showUntrackedFiles

帮助 打印摘要 亚德姆 命令。

初始化 初始化一个新的空存储库以跟踪点文件。 存储库已存储
in $HOME/.yadm/repo.git。 默认， $ HOME 将用作 工作树， 但是这个
可以用 -w 选项。 亚德姆 可以强制覆盖现有的
存储库通过提供 -f 选项。

名单 打印由管理的文件列表 亚德姆。 该 -a 选项将导致所有托管文件
被列出。 否则，该列表将只包括当前的文件
目录或以下。

烫发 如 PERMISSIONS 部分所述更新权限。 通常是
没有必要运行这个命令，因为 亚德姆 自动处理权限
默认。 可以通过设置配置来禁用此自动行为
yadm.auto-烫发 为“假”。

版本
打印版本 亚德姆.

配置

亚德姆 使用名为的配置文件 $HOME/.yadm/配置. 此文件使用相同的格式
as 混帐配置(1). 此外，您可以通过控制配置文件的内容
亚德姆 配置 命令（它的工作原理与 混帐配置）。 例如，要禁用
或者你可以运行命令：

yadm 配置 yadm.auto-alt false

以下是支持的配置的完整列表：

yadm.auto-alt
禁用替代部分中描述的自动链接。 如果禁用，
你可能还在跑 亚德姆 ALT 手动创建备用链接。 这个功能是
默认启用。

yadm.auto-烫发
禁用权限部分中描述的自动权限更改。 如果
已禁用，您仍然可以运行 亚德姆 烫发 手动更新权限。 这个
默认情况下启用功能。

yadm.ssh 权限
禁用权限更改 $HOME/.ssh/*. 此功能由
默认。

yadm.gpg-烫发
禁用权限更改 $HOME/.gnupg/*. 此功能由
默认。

候补

在跨不同系统管理一组文件时，拥有一个
为不同的操作系统选择文件的替代版本的自动化方式，
主机或用户。 亚德姆 实现自动创建符号链接的功能
到文件的适当版本，只要您遵循特定的命名约定。
亚德姆 可以检测名称以以下结尾的文件：

## or ##操作系统 or ##OS.HO​​STNAME or ##OS.HO​​STNAME.USER

如果有任何文件管理 亚德姆与此命名约定匹配的存储库，
将为最合适的版本创建符号链接。 这可能是最好的
举例说明。 假设以下文件由 亚德姆的存储库：

- $HOME/path/example.txt##
- $HOME/path/example.txt##达尔文
- $HOME/path/example.txt##Darwin.host1
- $HOME/path/example.txt##Darwin.host2
- $HOME/path/example.txt##Linux
- $HOME/path/example.txt##Linux.host1
- $HOME/path/example.txt##Linux.host2

如果在名为“host2”的 Macbook 上运行， 亚德姆 将创建一个符号链接，看起来像
这个：

$HOME/路径/example.txt -> $HOME/path/example.txt##Darwin.host2

然而，在另一台名为“host3”的 Macbook 上， 亚德姆 将创建一个符号链接，看起来
喜欢这个：

$HOME/路径/example.txt -> $HOME/path/example.txt##达尔文

由于主机名与任何托管文件都不匹配，因此更通用的版本是
选择。

如果在名为“host4”的 Linux 服务器上运行，链接将是：

$HOME/路径/example.txt -> $HOME/path/example.txt##Linux

如果在 Solaris 服务器上运行，则链接使用默认的“##”版本：

$HOME/路径/example.txt -> $HOME/路径/example.txt##

如果不存在“##”版本并且没有文件与当前 OS/HOSTNAME/USER 匹配，则没有链接
将被创建。

操作系统由运行决定 UNAME -s, HOSTNAME 通过运行 主机 -s, 和 USER 通过运行
id -u -n. 亚德姆 默认情况下将自动创建这些链接。 这个可以禁用
使用 yadm.auto-alt 配置。 即使禁用，也可以手动创建链接
运行 亚德姆 ALT.

加密

跨多个管理机密文件（如 SSH 或 GPG 密钥）很有用
系统。 但是，这样做会将纯文本数据放入 Git 存储库中，通常
驻留在公共系统上。 亚德姆 实现了一个可以轻松加密的功能
并解密一组文件，以便可以在 Git 中维护加密版本
存储库。 此功能仅在以下情况下有效 GPG(1) 命令可用。

要使用此功能，必须创建一个模式列表并将其保存为 $HOME/.yadm/加密.
这个模式列表应该是相对于配置的 工作树 （通常 $ HOME）。 对于
例：

.ssh/*.key
.gnupg/*.gpg

这个 亚德姆 加密 命令将查找所有匹配模式的文件，并提示输入
密码。 确认密码后，匹配的文件将被加密并保存为
$HOME/.yadm/files.gpg. 模式和 files.gpg 应该添加到 亚德姆 知识库
因此它们可以跨多个系统使用。

稍后解密这些文件，或在另一个系统上运行 亚德姆 解码 并提供
正确的密码。 文件解密后，权限自动更新为
权限部分中描述。

注意：建议您在保存机密文件时使用私有存储库，
即使它们是加密的。

PERMISSIONS

当文件从 Git 存储库中检出时，它们的初始权限是相关的
在用户的 umask 上。 这可能会导致机密文件的权限松懈。

为了防止这种情况， 亚德姆 会自动更新机密文件的权限。
“组”和“其他”权限将从以下文件中删除：

- $HOME/.yadm/files.gpg

- 匹配模式的所有文件 $HOME/.yadm/加密

- SSH 目录和文件， .ssh/*

- GPG 目录和文件， .gnupg/*

亚德姆 默认情况下会自动更新权限。 这可以禁用使用
yadm.auto-烫发 配置。 即使禁用，也可以手动更新权限
运行 亚德姆 烫发. 可以使用以下命令禁用 SSH 目录处理 yadm.ssh 权限
组态。

使用 onworks.net 服务在线使用 yadm