Baseline playbook to update and install all the packages needed for a server
It is the server preparation used by lucascbeyeler.zimbra, which supports the latest version of Zimbra (10.1), on the distributions Zimbra 10.1 runs on (Ubuntu 22.04 and Rocky Linux / Red Hat 8 and 9).
- Ansible 2.18.0 or superior.
- This playbook now depends on the
community.generalcollection. You can install it using:More information can be found here.ansible-galaxy collection install -r requirements.yml
Baseline is already in Ansible Galaxy, so the only thing you need is to install this script in your machine is just use ansible-galaxy command:
ansible-galaxy install lucascbeyeler.baseline
When a new version of baseline is released, you will need to run the install process again, but with the "-f" or "--force" parameter.
ansible-galaxy install -f lucascbeyeler.baseline
- Update the system and install some basic packages (like vim, unzip, and ca-certificates), plus EPEL on RedHat;
- Refresh the APT cache before installing packages, even when the full upgrade is turned off, so it works on fresh Ubuntu hosts and images with an empty cache;
- Configure chrony as the NTP client (on Ubuntu and RedHat) and change the timezone to what you want;
- Change the hostname and manage a single line in /etc/hosts (127.0.1.1 by default, or baseline_hosts_ip) to answer when the hostname is resolved;
- Enable the NTP service to start during the boot (SystemD);
- Including hushlogin in /etc/skel (new users) and root's home to hide the MOTD (only when
enable_hushloginistrue); - Change the SSH default port (also allowed in SELinux when it is enabled);
- Disable Root login through SSH;
- Safe to run many times: nothing is changed when the server already matches the configuration.
Every change to the SSH configuration is validated with sshd -t before it is written, and sshd is reloaded afterwards.
When /etc/ssh/sshd_config includes /etc/ssh/sshd_config.d/*.conf (Ubuntu 22.04+, RHEL 9), PermitRootLogin is written to /etc/ssh/sshd_config.d/00-baseline.conf, so drop-ins from the installer or the cloud image (like RHEL's 01-permitrootlogin.conf) cannot override it.
Warning: when changing
ssh_port, make sure the new port is open in your firewall (firewalld, ufw, security groups) and updateansible_portfor the next runs, otherwise you will lose SSH access.
This playbook has been tested against:
- Rocky Linux 9
- Ubuntu Jammy Jellyfish
Both are tested with Molecule in CircleCI on every push.
- hostname: set the hostname of your server WITHOUT the domain;
- domain: set the domain for the server and the primary domain for your server;
- timezone: inform the timezone the playbook should set in your server;
- baseline_hosts_ip: address the hostname resolves to in /etc/hosts (default
127.0.1.1). Set it to the server's own address when installing Zimbra; - enable_hushlogin: set to
trueto enable hush login (defaultfalse); - ssh_port: define the default port for OpenSSH Server (unset keeps the current port);
- baseline_ssh_permit_root_login: value for
PermitRootLogin(defaultno); - baseline_full_upgrade: upgrade all the packages on every run (default
true); - baseline_install_epel: install EPEL on RedHat systems (default
true); - baseline_ntp_servers: list of NTP servers used by chrony (default
pool.ntp.org); - multidist: packages installed on every distribution;
- debian / centos: extra packages installed only on Debian/Ubuntu or CentOS/RedHat;
- hosts: all
become: yes
become_method: sudo
roles:
- role: lucascbeyeler.baseline
hostname: pikachu
domain: johto.com
timezone: America/Sao_Paulo
enable_hushlogin: true
ssh_port: 8080
The role has unit tests (tests/unit/main.yml), which render the per-distribution variables and the chrony template with mocked facts, and a Molecule scenario that runs the role in Ubuntu Jammy and Rocky Linux 9 containers. CircleCI runs ansible-lint, a syntax check, the unit tests and Molecule. See Development.md to run them on your machine.
View official GNU site http://www.gnu.org/licenses/gpl.html.
