ansible-packages¶

Ansible role to install packages on a host

Requirements¶

Ansible version¶

Minimum required ansible version is 2.0.

Description¶

Ansible role to

configure yum or dnf repository
install default packages
configure repositories ( currently only dnf//yum repos )
disable selinux on rhel
add mounts in the fstree

Add a mount to fstab¶

# List of mounts to add to fstab.
mounts:
  - dev: '/dev/mapper/data_vg-home_lv'
    path: '/media/home_lv'
    state: mounted
    fstype: ext4
    opts: 'defaults,acl'
    group: users
    passno: X # defaults to 2
    dump: Y # defaults to 1

Role Variables¶

Variables conditionally loaded¶

Those variables from vars/*.{yml,json} are loaded dynamically during task runtime using the include_vars module.

Variables loaded from vars/CentOS.yml.

# List of packages to install by default on any CentOS family system
common_pkgs:
  - tmux
  - urlview
  - sudo
  - git
  - tree
  - openssh-server
  - gdisk
  - rsync
  - lvm2
  - ncurses-devel
  - ncurses
  - nmap
  - vim-common
  - vim-X11
  - zsh
  - curl
  - wget
  - libselinux-python
  - man

  # requires epel-release packages on CentOS
  # - htop
  # - python34
  # - sshpass

Variables loaded from vars/OpenWrt.yml.

# List of packages to install by default on any openwrt system
common_pkgs:
  - 6rd
  - zsh
  - vim
  - tmux
  - git
  - tcpdump
  - nmap
  - mtr
  - rsync
  - shadow
  - sudo
  - bind-dig
  - python
  - block-mount
  - kmod-usb-storage
  - kmod-fs-ext4
  - curl
  - wget
  - wol
  - etherwake
  - less
  - zsh
  - openssh-client
  - openssh-server
  - openssh-keygen
  - openssh-sftp-server
  - openssh-client-utils
  - ca-certificates
  - python-openssl

# cobbler requirements
    # createrepo
    # httpd (apache2 for Debian/Ubuntu)
    # mkisofs
    # mod_wsgi (libapache2-mod-wsgi for Debian/Ubuntu)
    # mod_ssl (libapache2-mod-ssl)
    # python-cheetah
    # python-netaddr
    # python-simplejson
    # python-urlgrabber
    # PyYAML (python-yaml for Debian/Ubuntu)
    # rsync
    # syslinux
    # tftp-server (atftpd for Debian/Ubuntu, though others may work)
    # yum-utils

Variables loaded from vars/Debian.yml.

# List of packages to install by default on any debian family system.
common_pkgs:
  - tmux
  - urlview
  - mosh
  - git
  - vim-gtk3
  - vim
  - python3
  - htop
  - fakeroot
  - tree
  - openssh-server
  - gdisk
  - rsync
  - lvm2
  - libncurses5-dev
  - libncurses5
  - nmap
  - linux-kernel-headers
  - zsh
  - ssh-askpass
  - sshpass
  - curl
  - wget
  - python-selinux
  - python3-venv
  # - ntopng

Variables loaded from vars/RedHat.yml.

# List of packages to install by default on any rhel family system.
common_pkgs:
  - tmux
  - urlview
  - mosh
  - sudo
  - git
  - python3
  - htop
  - tree
  - openssh-server
  - gdisk
  - rsync
  - lvm2
  - ncurses-devel
  - ncurses
  - nmap
  - vim-common
  - vim-X11
  - zsh
  - sshpass
  - curl
  - wget
  - libselinux-python

Default vars¶

Defaults from defaults/main.yml.

common_pkg_state: latest

selinux_state: disabled

# Default repos to configure on a target host.
RedHat_repodest: "/etc/yum.repos.d"
RedHat_repolist: []

Debian_repodest: '/etc/apt/sources.list.d'
Debian_repolist: []

Installation¶

Install with Ansible Galaxy¶

ansible-galaxy install archf.packages

Basic usage is:

- hosts: all
  roles:
    - role: archf.packages

Install with git¶

If you do not want a global installation, clone it into your roles_path.

git clone git@github.com:archf/ansible-packages.git /path/to/roles_path

But I often add it as a submdule in a given playbook_dir repository.

git submodule add git@github.com:archf/ansible-packages.git <playbook_dir>/roles/packages

As the role is not managed by Ansible Galaxy, you do not have to specify the github user account.

Basic usage is:

- hosts: all
  roles:
  - role: packages

Ansible role dependencies¶

None.

Todo¶

legacy package removal?

License¶

MIT.

Author Information¶

Felix Archambault.

Role stack¶

This role was carefully selected to be part an ultimate deck of roles to manage your infrastructure.

All roles’ documentation is wrapped in this convenient guide.

This README was generated using ansidoc. This tool is available on pypi!

pip3 install ansidoc

# validate by running a dry-run (will output result to stdout)
ansidoc --dry-run <rolepath>

# generate you role readme file
ansidoc <rolepath>

You can even use it programatically from sphinx. Check it out.