ansible-vault
утилита шифрования/расшифровки файлов данных Ansible
Краткое описание
usage: ansible-vault [-h] [--version] [-v]
{create,decrypt,edit,view,encrypt,encrypt_string,rekey} ...
Описание
может шифровать любые структурированные файлы данных, используемые Ansible. К ним могут относиться переменные инвентаризации из group_vars/ или host_vars/, переменные, загружаемые с помощью include_vars или vars_files, а также файлы переменных, передаваемые в командной строке ansible-playbook с помощью -e @file.yml или -e @file.json. Сюда также входят переменные ролей и значения по умолчанию!
Поскольку задачи Ansible, обработчики и другие объекты являются данными, их тоже можно зашифровать с помощью vault. Если вы не хотите раскрывать, какие переменные используете, можно зашифровать целиком отдельный файл задач.
Общие параметры
-
--version -
показать номер версии программы, расположение файла конфигурации, настроенный путь поиска модулей, расположение модуля и исполняемого файла, затем завершить работу
-
-h, --help -
показать эту справку и завершить работу
-
-v, --verbose -
Заставить Ansible выводить больше отладочных сообщений. Добавление нескольких -v повышает подробность вывода; встроенные плагины поддерживают уровень до -vvvvvv. Рекомендуется начать с -vvv; для отладки соединения может понадобиться -vvvv. Этот аргумент можно указывать несколько раз.
Действия
create
создать и открыть файл в редакторе; после закрытия файл будет зашифрован с использованием указанного секрета vault
-
--encrypt-vault-id <ENCRYPT_VAULT_ID> -
идентификатор vault, используемый для шифрования (обязателен, если указано более одного идентификатора vault)
-
--skip-tty-check -
разрешить открывать редактор, если терминал tty не подключен
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
decrypt
расшифровать указанный файл с использованием предоставленного секрета vault
-
--output <OUTPUT_FILE> -
имя выходного файла для шифрования или расшифровки; используйте - для вывода в stdout
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
edit
открыть и расшифровать существующий зашифрованный файл в редакторе; после закрытия он будет зашифрован повторно
-
--encrypt-vault-id <ENCRYPT_VAULT_ID> -
идентификатор vault, используемый для шифрования (обязателен, если указано более одного идентификатора vault)
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
view
открыть, расшифровать и просмотреть существующий зашифрованный файл с помощью программы постраничного просмотра, используя предоставленный секрет vault
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
encrypt
зашифровать указанный файл с использованием предоставленного секрета vault
-
--encrypt-vault-id <ENCRYPT_VAULT_ID> -
идентификатор vault, используемый для шифрования (обязателен, если указано более одного идентификатора vault)
-
--output <OUTPUT_FILE> -
имя выходного файла для шифрования или расшифровки; используйте - для вывода в stdout
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
encrypt_string
зашифровать указанную строку с использованием предоставленного секрета vault
-
--encrypt-vault-id <ENCRYPT_VAULT_ID> -
идентификатор vault, используемый для шифрования (обязателен, если указано более одного идентификатора vault)
-
--output <OUTPUT_FILE> -
имя выходного файла для шифрования или расшифровки; используйте - для вывода в stdout
-
--show-input -
Не скрывать ввод при запросе строки для шифрования
-
--stdin-name <ENCRYPT_STRING_STDIN_NAME> -
Указать имя переменной для stdin
-
--vault-id -
идентификатор vault, который следует использовать. Этот аргумент можно указывать несколько раз.
-
--vault-password-file, --vault-pass-file -
файл с паролем vault
-
-J, --ask-vault-password, --ask-vault-pass -
запросить пароль vault
-
-n, --name -
Указать имя переменной. Этот аргумент можно указывать несколько раз.
-
-p, --prompt -
Запросить строку для шифрования
rekey
повторно зашифровать зашифрованный файл новым секретом; для этого требуется прежний секрет
-
--encrypt-vault-id <ENCRYPT_VAULT_ID> -
идентификатор vault, используемый для шифрования (обязателен, если указано более одного идентификатора vault)
-
--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 распространяется на условиях лицензии GPLv3+.
См. также
ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-inventory(1), ansible-playbook(1), ansible-pull(1),
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/cli/ansible-vault.html
