#!/usr/bin/python # -*- coding: utf-8 -*- # (c) 2012, Matt Wright # # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see . # # Example: # - name: add nginx repo # action: apt_repository repo=ppa:nginx/stable state=present # DOCUMENTATION = ''' --- module: apt_repository short_description: Manages apt repositores (such as for Debian/Ubuntu). description: - Manages apt repositores (such as for Debian/Ubuntu). version_added: "0.7" options: repo: description: - The repository name/value required: true default: null state: description: - The repository state required: false default: present choices: [ "present", "absent" ] notes: - This module require 'apt-add-repository' wwill be available on destination server. To ensure this package is available use 'apt' module and install 'python-software-properties' package before use this module. - This module work only on Ubuntu and unstable Debian, see U(https://github.com/ansible/ansible/pull/1082, this issue) - A bug in 'apt-add-repository' always add 'deb' and 'deb-src' type for repo (see the U(https://bugs.launchpad.net/ubuntu/+source/software-properties/+bug/987264, issue on lunchpad)), if some repo don't have source (eg: MongoDB repo from 10gen) the system fail on update repositories. author: Matt Wright ''' EXAMPLES = [ """ - code: apt_repository repo=ppa://nginx/stable description: Add nginx stable repository from PPA """, """ - code: apt_repository repo='deb http://archive.canonical.com/ubuntu hardy partner' description: Add specified repository into sources. """ ] import platform APT = "/usr/bin/apt-get" ADD_APT_REPO = 'add-apt-repository' def _run(cmd): if platform.dist()[0] == 'debian' or float(platform.dist()[1]) >= 11.10: cmd = cmd + ' -y' # returns (rc, stdout, stderr) from shell command process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True) stdout, stderr = process.communicate() return (process.returncode, stdout, stderr) def main(): add_apt_repository = None arg_spec = dict( repo=dict(required=True), state=dict(default='present', choices=['present', 'absent']) ) module = AnsibleModule(argument_spec=arg_spec) add_apt_repository = module.get_bin_path(ADD_APT_REPO, True) repo = module.params['repo'] state = module.params['state'] rc, out, err = _run('%s "%s" --remove' % (add_apt_repository, repo)) existed = 'Error' not in out if state == 'absent': if not existed: module.exit_json(changed=False, repo=repo, state=state) else: module.exit_json(changed=True, repo=repo, state=state) cmd = '%s "%s"' % (add_apt_repository, repo) rc, out, err = _run(cmd) changed = rc == 0 and not existed if rc != 0: module.fail_json(msg=err) if changed: rc, out, err = _run('%s update' % APT) module.exit_json(changed=changed, repo=repo, state=state) # this is magic, see lib/ansible/module_common.py #<> main()