ANSIBLE.APT_KEY(3)              ANSIBLE MODULES             ANSIBLE.APT_KEY(3)



NAME
       apt_key - Add or remove an apt key

DESCRIPTION
       Add or remove an apt key, optionally downloading it

OPTIONS
       data   keyfile contents (default: none)

       file   keyfile path (default: none)

       id     identifier of key (default: none)

       keyring
              path to specific keyring file in /etc/apt/trusted.gpg.d
              (default: none)(Added in Ansible version 1.3.)


       state  used to specify if key is being added or revoked Choices:
              absent,present. (default: present)

       url    url to retrieve key from. (default: none).

NOTES
       doesn't download the key unless it really needs it

       as a sanity check, downloaded key id must match the one specified

       best practice is to specify the key id and the url

EXAMPLES
       # Add an Apt signing key, uses whichever key is at the URL
       - apt_key: url=https://ftp-master.debian.org/keys/archive-key-6.0.asc state=present

       # Add an Apt signing key, will not download if present
       - apt_key: id=473041FA url=https://ftp-master.debian.org/keys/archive-key-6.0.asc state=present

       # Remove an Apt signing key, uses whichever key is at the URL
       - apt_key: url=https://ftp-master.debian.org/keys/archive-key-6.0.asc state=absent

       # Remove a Apt specific signing key, leading 0x is valid
       - apt_key: id=0x473041FA state=absent

       # Add a key from a file on the Ansible server
       - apt_key: data="{{ lookup('file', 'apt.gpg') }}" state=present

       # Add an Apt signing key to a specific keyring file
       - apt_key: id=473041FA url=https://ftp-master.debian.org/keys/archive-key-6.0.asc keyring=/etc/apt/trusted.gpg.d/debian.gpg state=present



AUTHOR
       Jayson Vantuyl & others

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#apt-key



1.4.5                             2014-02-12                ANSIBLE.APT_KEY(3)
