Skip to content

Latest commit

 

History

History
63 lines (43 loc) · 2.43 KB

README.md

File metadata and controls

63 lines (43 loc) · 2.43 KB
Raw

Git Diff Ansible Vault

Build Status

Running git diff on files encrypted with ansible vault results in some pretty unhelpful output.

git-diff-ansible-vault is custom git utility that detects files encrypted with ansible vault within the diff, and safely decrypts them to reveal the true changes.

git-diff-ansible-vault animated demo

Installation

$ git clone https://github.com/tommarshall/git-diff-ansible-vault.git
$ cd git-diff-ansible-vault
$ [sudo] make install

By default, git-diff-ansible-vault is installed under /usr/local. To install it at an alternate location, specify a PREFIX when calling make. See the Makefile for details.

Usage

# diff uncommitted changes
$ git diff-ansible-vault

# specify a revision and restrict the diff to a path
$ git diff-ansible-vault -r master..some-branch -p path/to/dir

# specify a vault password file to avoid prompt (will look for .vault-pass by default)
$ git diff-ansible-vault --vault-password-file .vaultpass

# show full usage information and options
$ git diff-ansible-vault -h

Options

    -r, --revision <revision>          show diff for git revision, e.g. master..some-branch
    -p, --path <path>                  restrict diff to path, e.g. support/config.yml
        --cached, --staged             show diff for staged changes
        --no-pager                     do not pipe output into a pager
        --vault-password-file <path>   vault password file path, defaults to .vault-pass
        --vault-only                   restrict diff to vault files only
        --color, --colour              turn on coloured output
        --no-color, --no-colour        turn off coloured diff
        --verbose                      display verbose output
    -v, --version                      output program version
    -h, --help                         output help information

Dependencies

Ansible 1.8 or newer, as the scritpt relies on ansible-vault view.

You'll need colordiff if you want colored output.

brew install colordiff on OS X, apt-get install colordiff on Debian/Ubuntu.

Credits