README.md

   1 # Alex' Ansible Roles Repository
   2
   3 This repository contains Ansible roles that are targeted for Debian
   4 GNU/Linux version 7 (Wheezy) systems.
   5
   6
   7 ## Available Roles
   8
   9
  10 ### ansible-base
  11
  12 Configure the target system to be managed by Ansible, update *logcheck(8)*
  13 configuration, for example.
  14
  15
  16 ### apache2
  17
  18 Default Apache 2.x setup.
  19
  20 #### Depends on / Pulls in
  21
  22  - os-base
  23
  24 #### Installed Packages
  25
  26  - apache2-mpm-prefork
  27  - apache2-utils
  28  - apachetop
  29
  30
  31 ### apache2-php5
  32
  33 Default Apache 2.x setup with PHP 5.x.
  34
  35 #### Depends on / Pulls in
  36
  37  - apache2
  38
  39 #### Installed Packages
  40
  41  - libapache2-mod-php5
  42  - php5
  43  - php5-apcu | php-apc
  44  - php5-cli
  45  - php5-mysql
  46
  47
  48 ### apt-base
  49
  50 Generic configuration for APT-based Linux systems.
  51
  52
  53 ### autofs
  54
  55 NFS "automounter" (autofs) setup including `/net/hostname` pseudo
  56 directory hierarchy.
  57
  58 #### Depends on / Pulls in
  59
  60  - os-base
  61  - xinetd
  62
  63 #### Installed Packages
  64
  65  - autofs
  66
  67
  68 ### check-mk-agent
  69
  70 #### Depends on / Pulls in
  71
  72  - os-base
  73
  74 #### Installed Packages
  75
  76  - check-mk-agent
  77  - check-mk-agent-logwatch
  78  - nagios-plugins-basic
  79
  80
  81 ### debian-base
  82
  83 Basic Debian setup, including APT and Debconf configuration as well as a
  84 set of standard packages.
  85
  86 #### Installed Packages
  87
  88  - bash-completion
  89  - ca-certificates
  90  - curl
  91  - debconf-utils
  92  - etckeeper
  93  - git
  94  - htop
  95  - less
  96  - lsb-base
  97  - lsb-release
  98  - psmisc
  99  - net-tools
 100  - screen
 101  - sudo
 102  - telnet-ssl
 103  - vim
 104
 105
 106 ### docker-engine
 107
 108 #### Depends on / Pulls in
 109
 110  - os-base
 111
 112 #### Installed Packages
 113
 114  - apt-transport-https
 115  - ca-certificates
 116  - docker-engine
 117
 118 #### Variables
 119
 120  - `docker_apt_repository`
 121
 122
 123 ### git-backup-script
 124
 125 Local "BackupScript" installation from the GIT repository of Alex
 126 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=backup-script.git).
 127
 128 #### Depends on / Pulls in
 129
 130  - os-base
 131
 132 #### Installed Packages
 133
 134  - rsync
 135
 136
 137 ### git-configscripts
 138
 139 Local "ConfigScripts" installation from the GIT repository of Alex
 140 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ConfigScripts.git).
 141
 142 #### Depends on / Pulls in
 143
 144  - os-base
 145
 146 #### Variables
 147
 148  - `git_configscripts_users`: List of existing users to update.
 149
 150
 151 ### git-nagcollect
 152
 153 Local "NagCollect" client installation from the GIT repository of Alex
 154 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=nagcollect.git).
 155
 156 #### Depends on / Pulls in
 157
 158  - os-base
 159
 160 #### Variables
 161
 162  - `nagcollect_server_url`: Server URL.
 163  - `nagcollect_client_key`: Client key ("password").
 164  - `nagcollect_client_id`: Client (host) identifier.
 165
 166
 167 ### lcmc-cluster-node
 168
 169 Setup for Linux clusters running DRBD, Pacemaker, and Corosync using the
 170 "Linux Cluster Management Console" (LCMC, see http://lcmc.sourceforge.net).
 171
 172 #### Depends on / Pulls in
 173
 174  - os-base
 175  - sshd
 176  - ntpd
 177
 178 #### Installed Packages
 179
 180  - drbd8-utils
 181  - pacemaker
 182  - corosync
 183
 184
 185 ### linux-zfs
 186
 187 #### Depends on / Pulls in
 188
 189  - os-base
 190
 191 #### Installed Packages
 192
 193  - zfsutils
 194
 195
 196 ### mysql-server
 197
 198 MySQL Server setup, including a separate LVM data partition, if desired.
 199
 200 #### Depends on / Pulls in
 201
 202  - os-base
 203
 204 #### Variables
 205
 206  - `mysql_server_vg`: LVM volume group name.
 207  - `mysql_server_ansible_user`: MySQL management user. Default "ansible".
 208  - `mysql_server_ansible_password`: Password of management user. Default "ansible".
 209  - `mysql_server_root_host`: Hostname for MySQL "root" user. Default "localhost".
 210  - `mysql_server_root_password`: Password for the MySQL "root" user.
 211
 212 #### Installed Packages
 213
 214  - mysql-client
 215  - mysql-server
 216  - mysqltuner
 217  - python-mysqldb
 218
 219
 220 ### net-base
 221
 222 Basic networking configuration, including the target hostname which is set
 223 to the Ansible inventory hostname.
 224
 225
 226 ### nfs-client
 227
 228 NFS client setup.
 229
 230 #### Depends on / Pulls in
 231
 232  - os-base
 233
 234 #### Variables
 235
 236  - `nfs_client_domain`: NFSv4 client domain. Default: `ansible_domain`.
 237
 238 #### Installed Packages
 239
 240  - nfs-common
 241
 242
 243 ### ntpd
 244
 245 Local *ntpd(8)* setup.
 246
 247 #### Depends on / Pulls in
 248
 249  - os-base
 250
 251 #### Installed Packages
 252
 253  - ntpdate
 254  - ntp
 255
 256
 257 ### os-base
 258
 259 Generic "base role" for the operating system, pulls in the actual OS and
 260 distribution specific role (e. g. "debian-base").
 261
 262
 263 ### postfix
 264
 265 Postfix SMTP server setup.
 266
 267 #### Depends on / Pulls in
 268
 269  - os-base
 270
 271 #### Installed Packages
 272
 273  - postfix
 274
 275
 276 ### postgresql-server
 277
 278 #### Depends on / Pulls in
 279
 280  - os-base
 281
 282 #### Installed Packages
 283
 284  - postgresql-$postgresql_major
 285
 286 #### Variables
 287
 288  - `postgresql_major`
 289
 290
 291 ### sshd
 292
 293 SSH daemon setup.
 294
 295 Please note that this role always updates the SSH packages to the latest
 296 version and not only makes sure that a "ssh" package is installed, like most
 297 other roles in this repository.
 298
 299 #### Depends on / Pulls in
 300
 301  - os-base
 302
 303 #### Installed Packages
 304
 305  - openssh-blacklist-extra
 306  - ssh
 307
 308
 309 ### systemd
 310
 311 Base role for systemd-based systems.
 312
 313
 314 ### ubuntu-base
 315
 316 Basic Ubuntu setup, including APT and Debconf configuration as well as a
 317 set of standard packages.
 318
 319 #### Installed Packages
 320
 321  - bash-completion
 322  - busybox-static
 323  - ca-certificates
 324  - curl
 325  - debconf-utils
 326  - etckeeper
 327  - git
 328  - htop
 329  - less
 330  - linux-image-generic
 331  - lsb-base
 332  - lsb-release
 333  - psmisc
 334  - net-tools
 335  - screen
 336  - sudo
 337  - telnet-ssl
 338  - vim
 339
 340
 341 ### xinetd
 342
 343 #### Depends on / Pulls in
 344
 345  - os-base
 346
 347 #### Installed Packages
 348
 349  - xinetd
 350
 351
 352 ### zabbix-agent
 353
 354 #### Depends on / Pulls in
 355
 356  - os-base
 357
 358 #### Installed Packages
 359
 360  - zabbix-agent
 361
 362 #### Variables
 363
 364  - `zabbix_agent_pkg_file`
 365  - `zabbix_agent_pkg_url`
 366  - `zabbix_agent_pkg_sha`
 367  - `zabbix_agent_server`:
 368    Zabbix server host for "passive" agent checks, empty to disable.
 369  - `zabbix_agent_prefork`:
 370    Number of agent processes for "passive" checks (0 to disable).
 371  - `zabbix_agent_server_active`:
 372    Zabbix server host (for "active" agent checks, empty to disable).
 373  - `zabbix_agent_metadata`:
 374    Zabbix agent "HostMetadata" (for auto-registration).