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 ### piwik
 264
 265 #### Depends on / Pulls in
 266
 267  - os-base
 268  - apache2-php5
 269
 270 #### Installed Packages
 271
 272  - piwik
 273
 274 #### Variables
 275
 276  - `piwik_apt_repository`
 277  - `piwik_vhost_ipa`
 278  - `piwik_vhost_port`
 279  - `piwik_vhost_fqdn`
 280  - `piwik_admin_email`
 281  - `piwik_db_host`: Initial database host.
 282  - `piwik_db_user`: Initial database user.
 283  - `piwik_db_password`: Initial database password.
 284  - `piwik_db_name`: Initial database name.
 285  - `piwik_trusted_hosts`: Initial list of trusted hosts.
 286
 287
 288 ### postfix
 289
 290 Postfix SMTP server setup.
 291
 292 #### Depends on / Pulls in
 293
 294  - os-base
 295
 296 #### Installed Packages
 297
 298  - postfix
 299
 300
 301 ### postgresql-server
 302
 303 #### Depends on / Pulls in
 304
 305  - os-base
 306
 307 #### Installed Packages
 308
 309  - postgresql-$postgresql_major
 310
 311 #### Variables
 312
 313  - `postgresql_major`
 314
 315
 316 ### sshd
 317
 318 SSH daemon setup.
 319
 320 Please note that this role always updates the SSH packages to the latest
 321 version and not only makes sure that a "ssh" package is installed, like most
 322 other roles in this repository.
 323
 324 #### Depends on / Pulls in
 325
 326  - os-base
 327
 328 #### Installed Packages
 329
 330  - openssh-blacklist-extra
 331  - ssh
 332
 333
 334 ### systemd
 335
 336 Base role for systemd-based systems.
 337
 338
 339 ### ubuntu-base
 340
 341 Basic Ubuntu setup, including APT and Debconf configuration as well as a
 342 set of standard packages.
 343
 344 #### Installed Packages
 345
 346  - bash-completion
 347  - busybox-static
 348  - ca-certificates
 349  - curl
 350  - debconf-utils
 351  - etckeeper
 352  - git
 353  - htop
 354  - less
 355  - linux-image-generic
 356  - lsb-base
 357  - lsb-release
 358  - psmisc
 359  - net-tools
 360  - screen
 361  - sudo
 362  - telnet-ssl
 363  - vim
 364
 365
 366 ### xinetd
 367
 368 #### Depends on / Pulls in
 369
 370  - os-base
 371
 372 #### Installed Packages
 373
 374  - xinetd
 375
 376
 377 ### zabbix-agent
 378
 379 #### Depends on / Pulls in
 380
 381  - os-base
 382
 383 #### Installed Packages
 384
 385  - zabbix-agent
 386
 387 #### Variables
 388
 389  - `zabbix_agent_pkg_file`
 390  - `zabbix_agent_pkg_url`
 391  - `zabbix_agent_pkg_sha`
 392  - `zabbix_agent_server`:
 393    Zabbix server host for "passive" agent checks, empty to disable.
 394  - `zabbix_agent_prefork`:
 395    Number of agent processes for "passive" checks (0 to disable).
 396  - `zabbix_agent_server_active`:
 397    Zabbix server host (for "active" agent checks, empty to disable).
 398  - `zabbix_agent_metadata`:
 399    Zabbix agent "HostMetadata" (for auto-registration).