ansible-vault

Ansible 数据文件的加密/解密实用程序

概要

usage: ansible-vault [-h] [--version] [-v]
                  {create,decrypt,edit,view,encrypt,encrypt_string,rekey}
                  ...

描述

可以加密 Ansible 使用的任何结构化数据文件。这可能包括 group_vars/host_vars/ 清单变量,由 include_varsvars_files 加载的变量,或者使用 -e @file.yml-e @file.json 在 ansible-playbook 命令行上传递的变量文件。角色变量和默认值也包含在内!

因为 Ansible 任务、处理程序和其他对象都是数据,所以这些也可以使用 vault 加密。如果您不想公开正在使用的变量,可以将单个任务文件完全加密。

常用选项

--version

显示程序的版本号、配置文件位置、已配置的模块搜索路径、模块位置、可执行文件位置并退出

-h, --help

显示此帮助消息并退出

-v, --verbose

使 Ansible 打印更多调试消息。添加多个 -v 将增加详细程度,内置插件当前评估最多为 -vvvvvv。一个合理的开始级别是 -vvv,连接调试可能需要 -vvvv。此参数可以多次指定。

操作

创建

创建一个文件并在编辑器中打开,该文件将在关闭时使用提供的 vault 密钥加密

--encrypt-vault-id  <ENCRYPT_VAULT_ID>

用于加密的 vault ID(如果提供了多个 vault-id,则需要此项)

--skip-tty-check

允许在没有 tty 附加的情况下打开编辑器

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

解密

使用提供的 vault 密钥解密提供的文件

--output  <OUTPUT_FILE>

加密或解密的输出文件名;使用 - 表示标准输出

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

编辑

在编辑器中打开和解密现有的加密文件,该文件在关闭时将再次加密

--encrypt-vault-id  <ENCRYPT_VAULT_ID>

用于加密的 vault ID(如果提供了多个 vault-id,则需要此项)

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

查看

使用提供的 vault 密钥打开、解密和查看现有的加密文件,使用分页器

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

加密

使用提供的 vault 密钥加密提供的文件

--encrypt-vault-id  <ENCRYPT_VAULT_ID>

用于加密的 vault ID(如果提供了多个 vault-id,则需要此项)

--output  <OUTPUT_FILE>

加密或解密的输出文件名;使用 - 表示标准输出

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

加密字符串

使用提供的 Vault 密钥加密提供的字符串

--encrypt-vault-id  <ENCRYPT_VAULT_ID>

用于加密的 vault ID(如果提供了多个 vault-id,则需要此项)

--output  <OUTPUT_FILE>

加密或解密的输出文件名;使用 - 表示标准输出

--show-input

提示输入要加密的字符串时,不隐藏输入内容

--stdin-name  <ENCRYPT_STRING_STDIN_NAME>

指定标准输入的变量名称

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

-n, --name

指定变量名称。此参数可以多次指定。

-p, --prompt

提示输入要加密的字符串

重新加密

使用新的密钥重新加密已加密的文件,需要之前的密钥

--encrypt-vault-id  <ENCRYPT_VAULT_ID>

用于加密的 vault ID(如果提供了多个 vault-id,则需要此项)

--new-vault-id  <NEW_VAULT_ID>

重新加密时要使用的新的 Vault 标识

--new-vault-password-file  <NEW_VAULT_PASSWORD_FILE>

重新加密时使用的新的 Vault 密码文件

--vault-id

要使用的 vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

vault 密码文件

-J, --ask-vault-password, --ask-vault-pass

询问 vault 密码

环境变量

可以指定以下环境变量。

ANSIBLE_CONFIG – 覆盖默认的 Ansible 配置文件

ansible.cfg 中的大多数选项都提供了更多可用的环境变量。

文件

/etc/ansible/ansible.cfg – 配置文件,如果存在则使用

~/.ansible.cfg – 用户配置文件,如果存在则覆盖默认配置

作者

Ansible 最初由 Michael DeHaan 编写。

有关完整贡献者列表,请参阅 AUTHORS 文件。

许可证

Ansible 在 GPLv3+ 许可证的条款下发布。

另请参阅

ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-inventory(1), ansible-playbook(1), ansible-pull(1),