Ansible Role: Apt

This role will add third party sources to the package manager by:

• Adding source URL as new repository
• Adding secure key specified
• Managing packages preferences files (aka. pinning)
• Installing packages

It's part of the ELAO Ansible stack but can be used as a stand alone component.

Requirements

None.

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install elao.apt,2.0

Using ansible galaxy requirements file:

- src:     elao.apt
  version: 2.0

Ansible 1 (no longer maintained)

Using ansible galaxy cli:

ansible-galaxy install elao.apt,1.0

Using ansible galaxy requirements file:

- src:     elao.apt
  version: 1.0

Role Handlers

None

Role Variables

Definition

Name	Default	Type	Description
elao_apt_update	False	Bool	Update
elao_apt_upgrade	False	Bool	Upgrade
elao_apt_components	['main']	Array	Collection of components
elao_apt_sources_list	[]	Array	Collection of sources
elao_apt_repositories	[]	Array	Collection of repositories
elao_apt_preferences	[]	Array	Collection of preferences
elao_apt_packages	[]	Array	Collection of packages
elao_apt_update_valid_time	180	Int	Permitted age of apt cache, in seconds

Example

- hosts: all
  vars:
    elao_apt_update: true
    elao_apt_repositories:
      - contrib
    elao_apt_preferences:
      - git@backports
      - ~@dotdeb:100
      - php@dotdeb_php56
      - nginx@nginx
    elao_apt_packages:
      - ttf-mscorefonts-installer
  roles:
    - role: elao.apt

Update

Update packages

elao_apt_update: true

Upgrade

Upgrade packages

elao_apt_upgrade: true

Components

Specify apt components

elao_apt_components: ['main', 'contrib', 'non-free']

Sources list

Define manually each sources

elao_apt_sources_list:
  - deb: http://httpredir.debian.org/debian wheezy main
  - deb http://httpredir.debian.org/debian wheezy contrib

Or use predefined templates

elao_apt_sources_list_template: sources_list/debian.list.j2

Or combine both

elao_apt_sources_list_template: sources_list/debian_src.list.j2
elao_apt_sources_list:
  - deb-src: http://httpredir.debian.org/debian wheezy main
  - deb-src http://httpredir.debian.org/debian wheezy contrib

Repositories

Concise, pattern based

elao_apt_repositories:
  - debian_security
  - debian_security_src
  - debian_updates
  - debian_updates_src
  - debian_backports
  - ubuntu_security
  - ubuntu_updates
  - ubuntu_partner
  - ubuntu_backports
  - dotdeb
  - dotdeb_php54
  - dotdeb_php55
  - dotdeb_php56
  - nginx
  - bearstech
  - nodesource_0_10
  - nodesource_0_12
  - nodesource_4
  - postgresql
  - mongodb_3_0
  - mongodb_3_1
  - varnish_4_0
  - jenkins
  - sensu
  - rabbitmq
  - proxmox
  - proxmox_enterprise
  - logentries
  - galera
  - grafana
  - elasticsearch_1_5
  - elasticsearch_1_6
  - elasticsearch_1_7
  - ppa_ansible
  - blackfire

Verbose, pattern based

elao_apt_repositories:
  - pattern: backports
    state:   absent

Verbose

elao_apt_repositories:
  - source: deb http://pkg.jenkins-ci.org/debian binary/
    key:
      url: http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key
      id:  D50582E6
  - source: deb https://enterprise.proxmox.com/debian {{ ansible_distribution_release }} pve-enterprise
    state:  absent

Exclusivity (all repositories non defined by role will be deleted)

elao_apt_repositories_exclusive: true

Preferences

Concise, pattern based

Format: [preference pattern]@[repository pattern]:[pin priority]

Note that referenced repositories will automatically be include as present using "elao_apt_repositories" process.

elao_apt_preferences:
  - git@backports # git* from backports reposotiry, high priority
  - ~@dotdeb:100  # * from dotdeb repository, low priority
  - php@dotdeb    # php* from backports reposotiry, high priority
  - redis@dotdeb  # redis* from backports reposotiry, high priority

Verbose

elao_apt_preferences:
  - file: dotdeb
    config:
      - Package:      '*'
      - Pin:          origin packages.dotdeb.org
      - Pin-Priority: 100
  - file: php
    config:
      - Package:       php*
      - Pin:           origin packages.dotdeb.org
      - Pin-Priority:  900

Packages

Concise

elao_apt_packages:
  - vim # Name of package

Verbose

elao_apt_packages:
  - name:  bzip2  # Name of package, required
    state: absent # State of package, optionnal, default 'present'
    force: true   # Force installation, optionnal

Licence

MIT

Author information

ELAO (http://www.elao.com/)