dotfiles/spacemacs.d/layers/+tools/ansible/README.org

Ansible layer

• Table of Contents
• Description
• Install
• Configuration
  • ansible-vault
    • Password
    • Automatic encryption and descryption
• Key bindings

Description

This layer adds support for Ansible-flavored YAML buffers and Jinja2 templates.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add ansible to the existing dotspacemacs-configuration-layers list in this file.

Configuration

ansible-vault

Password

To use ansible-vault you have to provide the path to a file containing the password to use somewhere in you dotspacemacs/user-config function. For instance:

(setq ansible::vault-password-file "path/to/pwd/file")

The default value is the ansible-vault default value: ~/.vault_pass.txt.

Automatic encryption and descryption

This layer comes preconfigured with automatic encryption/decryption of encrypted files using ansible-vault so it is possible to edit seamlessly any encrypted files.

If you want to disable this feature then set the layer variable ansible-auto-encrypt-descrypt to nil.

(ansible :variables ansible-auto-encrypt-descrypt t)

Key bindings

Key Binding	Description
SPC m b d	encrypt the buffer using ansible-vault
SPC m b e	decrypt the buffer using ansible-vault
SPC m h a	looks up documentation using ansible-doc