debian-base: Add "update APT repositories" handler
[AnsibleRoles.git] / 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-php5
17
18 Default Apache 2.x setup with PHP 5.x.
19
20 #### Depends on / Pulls in
21
22  - debian-base
23
24 #### Installed Packages
25
26  - apache2-mpm-prefork
27  - apache2-utils
28  - apachetop
29  - libapache2-mod-php5
30  - php-apc
31  - php5
32  - php5-cli
33  - php5-mysql
34
35
36 ### autofs
37
38 NFS "automounter" (autofs) setup including `/net/hostname` pseudo
39 directory hierarchy.
40
41 #### Depends on / Pulls in
42
43  - debian-base
44
45 #### Installed Packages
46
47  - autofs
48
49
50 ### debian-base
51
52 Basic Debian setup, including APT and Debconf configuration as well as a
53 set of standard packages.
54
55 #### Installed Packages
56
57  - bash-completion
58  - busybox-static
59  - ca-certificates
60  - curl
61  - debconf-utils
62  - etckeeper
63  - git
64  - htop
65  - less
66  - linux-image-amd64
67  - lsb-base
68  - lsb-release
69  - psmisc
70  - net-tools
71  - screen
72  - sudo
73  - telnet-ssl
74  - vim
75
76
77 ### git-backup-script
78
79 Local "BackupScript" installation from the GIT repository of Alex
80 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=backup-script.git).
81
82 #### Depends on / Pulls in
83
84  - debian-base
85
86 #### Installed Packages
87
88  - rsync
89
90
91 ### git-configscripts
92
93 Local "ConfigScripts" installation from the GIT repository of Alex
94 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ConfigScripts.git).
95
96 #### Depends on / Pulls in
97
98  - debian-base
99
100 #### Variables
101
102  - `git_configscripts_users`: List of existing users to update.
103
104
105 ### git-nagcollect
106
107 Local "NagCollect" client installation from the GIT repository of Alex
108 (see https://arthur.barton.de/cgi-bin/gitweb.cgi?p=nagcollect.git).
109
110 #### Depends on / Pulls in
111
112  - debian-base
113
114 #### Variables
115
116  - `nagcollect_server_url`: Server URL.
117  - `nagcollect_client_key`: Client key ("password").
118  - `nagcollect_client_id`: Client (host) identifier.
119
120
121 ### lcmc-cluster-node
122
123 Setup for Linux clusters running DRBD, Pacemaker, and Corosync using the
124 "Linux Cluster Management Console" (LCMC, see http://lcmc.sourceforge.net).
125
126 #### Depends on / Pulls in
127
128  - debian-base
129  - sshd
130  - ntpd
131
132 #### Installed Packages
133
134  - drbd8-utils
135  - pacemaker
136  - corosync
137
138
139 ### mysql-server
140
141 MySQL Server setup, including a separate LVM data partition, if desired.
142
143 #### Depends on / Pulls in
144
145  - debian-base
146
147 #### Variables
148
149  - `mysql_server_vg`: LVM volume group name.
150  - `mysql_server_ansible_user`: MySQL management user. Default "ansible".
151  - `mysql_server_ansible_password`: Password of management user. Default "ansible".
152  - `mysql_server_root_host`: Hostname for MySQL "root" user. Default "localhost".
153  - `mysql_server_root_password`: Password for the MySQL "root" user.
154
155 #### Installed Packages
156
157  - mysql-client
158  - mysql-server
159  - mysqltuner
160  - python-mysqldb
161
162
163 ### net-base
164
165 Basic networking configuration, including the target hostname which is set
166 to the Ansible inventory hostname.
167
168
169 ### nfs-client
170
171 NFS client setup.
172
173 #### Depends on / Pulls in
174
175  - debian-base
176
177 #### Variables
178
179  - `nfs_client_domain`: NFSv4 client domain. Default: `ansible_domain`.
180
181 #### Installed Packages
182
183  - nfs-common
184
185
186 ### ntpd
187
188 Local *ntpd(8)* setup.
189
190 #### Depends on / Pulls in
191
192  - debian-base
193
194 #### Installed Packages
195
196  - ntpdate
197  - ntp
198
199
200 ### postfix
201
202 Postfix SMTP server setup.
203
204 #### Depends on / Pulls in
205
206  - debian-base
207
208 #### Installed Packages
209
210  - postfix
211
212
213 ### sshd
214
215 SSH daemon setup.
216
217 Please note that this role always updates the SSH packages to the latest
218 version and not only makes sure that a "ssh" package is installed, like most
219 other roles in this repository.
220
221 #### Depends on / Pulls in
222
223  - debian-base
224
225 #### Installed Packages
226
227  - openssh-blacklist-extra
228  - ssh