From 2694e7caf3070eb396c9fde0d3f49041662573f2 Mon Sep 17 00:00:00 2001
From: Marcus Grant <marcusfg@gmail.com>
Date: Mon, 13 Jan 2020 18:11:29 -0500
Subject: [PATCH] ansible-vault: add page (#3279)

---
 pages/common/ansible-vault.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/ansible-vault.md

diff --git a/pages/common/ansible-vault.md b/pages/common/ansible-vault.md
new file mode 100644
index 000000000..66c242f58
--- /dev/null
+++ b/pages/common/ansible-vault.md
@@ -0,0 +1,28 @@
+# ansible-vault
+
+> Encrypts & decrypts values, data structures and files within Ansible projects.
+> More information: <https://docs.ansible.com/ansible/latest/user_guide/vault.html#id17>.
+
+- Create a new encrypted vault file with a prompt for a password:
+
+`ansible-vault create {{vault_file}}`
+
+- Create a new encrypted vault file using a vault key file to encrypt it:
+
+`ansible-vault create --vault-password-file={{password_file}} {{vault_file}}`
+
+- Encrypt an existing file using an optional password file:
+
+`ansible-vault encrypt --vault-password-file={{password_file}} {{vault_file}}`
+
+- Encrypt a string using Ansible's encrypted string format, displaying interactive prompts:
+
+`ansible-vault encrypt_string`
+
+- View an encrypted file, using a password file to decrypt:
+
+`ansible-vault view --vault-password-file={{password_file}} {{vault_file}}`
+
+- Re-key already encrypted vault file with a new password file:
+
+`ansible-vault rekey --vault-password-file={{old_password_file}} --new-vault-password-file={{new_password_file}} {{vault_file}}`