跳转到内容
安装

volant shims

把 ansible-core 的程序名链接到 volant,并删除这些链接。

volant shims 把 ansible-core 的程序名链接到 volant,这样 ansible-vault 等命令启动的就是 Volant。除非你运行它,否则不会创建这些链接。它适用于 Linux 和 macOS。

终端窗口
volant shims install [--dir DIR] [--force] [NAME...]
volant shims remove [--dir DIR] [NAME...]

NAME 是 ansible、ansible-config、ansible-console、ansible-doc、ansible-galaxy、ansible-inventory、ansible-playbook、ansible-pull 和 ansible-vault 之一。不给出时,命令处理全部九个。

放置链接的目录。默认:$VOLANT_BIN_DIR,然后是 ~/.local/bin。目录不存在是错误:ERROR! DIR is not a directory,退出码为 1。

替换同名但不是 Volant 链接的文件或链接。

shim 是符号链接。当 DIR 里有一个名为 volant 的条目时,它的目标是相对名字 volant,所以升级那个链接时 shim 会跟着更新。否则目标是正在运行的二进制文件的绝对路径。

install 为每个名字打印一行:

行 含义
ansible-vault: installed 已创建链接。
ansible-vault: already installed 链接已存在并指向 volant。没有任何改动。
ansible-vault: replaced --force 替换了另一个文件或链接。
ansible-vault: not replaced, DIR/ansible-vault exists and is not a Volant link 没有创建任何东西,退出码为 1。

当 PATH 中还有同名的其他可执行文件时,创建了链接的那一行会再加一句:note: /usr/bin/ansible-vault is hidden by this link, DIR comes first in PATH,或 note: /usr/bin/ansible-vault still runs first, DIR comes later in PATH。如果 DIR 根本不在 PATH 中,则以 DIR is not in PATH 结尾。

remove 只删除目标是名为 volant 的文件的符号链接,并打印 ansible-vault: removed、ansible-vault: not installed 或 ansible-vault: not a Volant link, left alone。最后一种会使退出码为 1。