Setting up a highly available homelab with KVM, Katello and Puppet.
I was working on a project where I needed to design a highly available (HA) infrastructure for a WordPress application, and I used my homelab environment to deliver a proof of concept (POC).
Goals and Requirements
One of the main goals of the homelab is to deliver a POC for a highly available WordPress application.
Other requirements, in no particular order, can be seen below.
- A KVM hypervisor. KVM is ubiquitous these days, and anything else is basically The Dark Side – the force may be strong, but one must resist the temptation.
- All virtual machines use CentOS 7.
- Services that are essential for the environment to function must be highly available. This includes DNS, DHCP, SMTP, NTP and LDAP.
- The environment is automated and managed by Katello and Puppet. This is a very important goal in order to make the environment scalable should I need to.
- All servers have to use LDAP authentication.
- All servers have to be monitored and backed up (backups are extremelly important, however, as long as I take KVM snapshots, setting up a dedicated backup server becomes less of a priority).
- All servers have to send logs to a central syslog server for audit.
- Web servers have to be configured to send application logs to a central syslog server for further processing and reporting.
- There has to be no single point of failure when it comes to the availability of the WordPress application, meaning that we will need at least two load balancers (or proxies), two web servers, two database servers, and two NFS servers for shared storage.
- SELinux must be enforced on all servers.
- There are likely some more requirements which I forgot about while working on this write up…
Hardware isn’t really a concern, mainly because I don’t need powerfull piece of equipment in order to run KVM and deliver a POC.
My homelab environment is deployed on a single (and rather old, if we consider nowadays standards) Dell workstation. Hardware specs below.
- 8 CPUs (i7-2720QM).
- 26 GB of RAM.
- 128 GB of SSD storage for Proxmox.
- 256 GB of SSD storage for KVM images.
There are two distinct parts to setting up the homelab, the manual one, where we need to install a hypervisor and configure some essential services (e.g. DNS) before we can start automating things, and the automated one, where we start utilising Katello and Puppet to provision the rest of the infrastructure.
As already mentioned under the requirements section, I use CentOS 7 exclusively, SELinux is set to enforcing mode on all servers and firewall rules are hardened in a way so that they allow required traffic only.
Proxmox, Admin Servers and Katello
These are the things that we need to provision manually.
1. Set up a KVM hypervisor (I use Proxmox). There are a couple of things that one should be aware of before sticking with Proxmox. Proxmox does not use libvirt, therefore:
- Pacemaker clusters cannot be fenced by using fence-agents-virsh. There is fence_pve, but you won’t find it in CentOS/RHEL, and you’ll need to compile it yourself.
- Proxmox does not work with foreman-libvirt and cannot be used with Foreman as a “Compute Resources” provider to create guests. If you come from a libvirt enviroment then this can be a bit of a drag, but as long as you can PXE boot it isn’t that big of a problem, at least in a homelab.
2. Create three VMs. Two of them will named admin1 and admin2, and will be configured to provide redundant DNS, DHCP, SMTP and NTP services to the environment. The third server will host Katello/Puppet. See the homelab network diagram below for more info.
The Katello server will provide TFTP services, and the DHCP servers will use the Katello server as the PXE boot machine.
DNS servers will be configured to serve a forward and a reverse zones.
Additionally, we will import errata information from the CentOS-Announce mailing list into the Katello server so that we can see security update advisory information.
Automation: Puppet-managed Servers and Services
Once we have our hypervisor running, the admin1/admin2 servers provisioned and Katello configured, we will go ahead and do the following.
3. Use Katello to PXE boot a pair of Master/Slave LDAP servers. Do not allow anonymous bind, and do not use plain-text LDAP (allow LDAPS only). All Puppet-managed servers will be configured to use LDAP authentication.
4. Use Katello to PXE boot a Zabbix monitoring server. Use Puppet to configure active Zabbix agent auto-registration and ensure that all servers get the correct monitoring template applied.
5. Use Katello to PXE boot a Graylog syslog server. Use Puppet to configure all servers to send syslog data to Graylog.
6. Use Katello to PXE boot a pair of MySQL servers and use Puppet to configure Master/Master replication for HA.
7. Use Katello to PXE boot a pair of NFS servers and use Puppet to configure a Pacemaker cluster for HA.
8. Use Katello to PXE boot a pair of Apache servers and deploy WordPress via Puppet. Serve all content over HTTPS and use shared NFS storage for the WordPress uploads folder.
9. Use Katello to PXE boot a pair of HAProxy servers and use Puppet to configure a load-balancing cluster with Keepalived. Configure HAProxy to use TLS.
10. Use Katello to PXE a backup server. See the homelab network diagram below for more info.
Homelab Network Diagram
A simplified network diagram showing services provided by each virtual machine, as well as their IP addresses, can be seen below. It should hopefully make sense if you read all the sections above. Three servers, which are coloured in black, will be set up manually. The rest of the servers (coloured in grey) will be provisioned by Katello (PXE boot) and managed by Puppet.
We’ll have a pair of LDAP servers to provide redundancy. We’ll also have two Pacemaker nodes in an NFS cluster to export shared storage, it will be used by the web servers (WordPress uploads folder). A pair of HAProxy servers for load balancing and HA, and a pair of MySQL servers with active/active replication.
Homelab Info Table
The VM IDs are used by Proxmox only and can be pretty much anything.
Homelab subnet is 10.11.1.0/24.
MAC address of each VM is configured in a way so that it always start with 00:22:FF:00:00 but the remaining part is tied to the last byte of a VM’s IP address.
For example, a VM with the IP address of 10.11.1.15 would have a MAC address of 00:22:FF:00:00:15. This is important as we’ll be using PXE boot with static DHCP leases.
|VM ID||Hostname/DNS||IP address||RAM (MB)||Notes||PXE boot||Katello agent||Puppet Managed|
|200||admin1.hl.local||10.11.1.2||512||DNS/DHCP master, NTP, SMTP||No||Yes||No|
|201||admin2.hl.local||10.11.1.3||512||DNS/DHCP slave, NTP, SMTP||No||Yes||No|
|207||storage1.hl.local||10.11.1.15||768||NFS Pacemaker cluster node||Yes||Yes||Yes|
|208||storage2.hl.local||10.11.1.16||768||NFS Pacemaker cluster node||Yes||Yes||Yes|
|211||proxy1.hl.local||10.11.1.19||768||HAProxy master (with keepalived)||Yes||Yes||Yes|
|212||proxy2.hl.local||10.11.1.20||768||HAProxy slave (with keepalived)||Yes||Yes||Yes|
In addition to the information provided in the table above, the following resources will be used as well.
|pve.hl.local||10.11.1.5||Proxmox KVM hypervisor|
|blog.hl.local||10.11.1.30||VIP for the WordPress website used by HAProxy|
|nfsvip.hl.local||10.11.1.31||VIP for NFS used by Pacemaker|
Network Diagram for Highly Available WordPress Deployment
Here is a GIF representing the HA setup for WordPress. I could put some effort trying to explain what’s going on here, however, there is a new episode of “Abroad in Japan” out so I have to go and watch it. If you look at the network diagram, you’ll notice that there isn’t a single point of failure – we can lose a server regardless of the service that it provides and still have a functioning web application.
Over the upcoming weeks I plan to publish articles covering the creation on the homelab. At the time I write this, I actually use the WordPress application that’s running in the homelab environment, which is finished and operational. See the images below to get a better idea.
Part 1: Install Proxmox/KVM on bare-metal
Part 2: Set up Admin servers with DNS/DHCP/NTP/SMTP. See links below.
>Part 2.1: Configure Bind DNS Servers with Failover and Dynamic Updates on CentOS 7
>Part 2.2: Configure DHCP Failover with Dynamic DNS on CentOS 7
>Part 2.3: Configure Peered NTP Servers on CentOS 7
>Part 2.4: Configure Postfix to Relay Mail to an External SMTP Server on CentOS 7
Part 3: Install Katello on CentOS 7
Part 4: Configure Katello services. See links below.
>Part 4.1: Katello: Create Products, Repositories, Content Views, Lifecycle Environments, Activation Keys
>Part 4.2: Katello: Import CentOS Errata into Pulp
>Part 4.3: Katello: Create a Domain, Subnet, Installation Media, OS, Provisioning Templates, Host Groups, PXE Boot
>Part 4.4: Katello: Working with Puppet Modules and Creating the Main Manifest
>Part 4.5: Katello: Separate Lifecycle for Puppet Modules
Part 5: Configure OpenLDAP Master/Slave Replication with Puppet
Part 6: Configure Zabbix Monitoring Server with Puppet
Part 7: Configure Graylog Server with Puppet
Part 8: Configure MySQL Replication with Puppet
Part 9: Configure Active/Passive NFS Server on a Pacemaker Cluster with Puppet
Part 10: Configure Apache Server and Deploy WordPress with Puppet
Part 11: Configure HAProxy and Keepalived with Puppet