Ansible LAMP Setup

A base LAMP environment for PHP deployment using Ansible.

The base setup is borrowed from the Digital Ocean community ansible scripts and inspired by My First 5 Minutes On A Server by Bryan Kennedy.

Requirements

You will need a local install of Ansible and shell access to the deployment server.

Installing Ansible on macOS with Homebrew.

brew install ansible

Depending on the script you are running you will need to install these ansible roles.

ansible-galaxy install geerlingguy.apache
ansible-galaxy install geerlingguy.apache-php-fpm
ansible-galaxy install geerlingguy.certbot
ansible-galaxy install geerlingguy.composer
ansible-galaxy install geerlingguy.mysql
ansible-galaxy install geerlingguy.php
ansible-galaxy install geerlingguy.php-versions

hosts is an Ansible inventory file.

You will need a minimal of host_vars/hostname.yaml file like this to get going.

deploy_user: deploy

mysql_root_password: "super secret"

php_version: "7.4"

You can use a hosts file like this if you have multiple hosts.

host1
host2

Then run your commands like this.

ansible-playbook -i hosts base.yaml

If you want to target a few hosts you can directly use hostnames from ~/.ssh/config like this.

ansible-playbook -i host1,host2 base.yaml

For a single host add a trailing command like this.

ansible-playbook -i host1, base.yaml

You can install in stages like this

ansible-playbook -i host1, base.yaml
ansible-playbook -i host1, mysql.yaml
ansible-playbook -i host1, apache.yaml
ansible-playbook -i host1, php.yaml

Or you can take run the LAMP script to combine the above like this.

ansible-playbook -i host1, base.yaml
ansible-playbook -i host1, lamp.yaml

There is another apache-php.yaml that only installs Apache with PHP. The base.yaml step is always required to be run first.

Setup LAMP

ansible-playbook -i host1, base.yaml
ansible-playbook -i host1, lamp.yaml

The certbot playboot is not used since it doesn't setup the Apache config files. This part is done manually using https://certbot.eff.org/

Ansible Lint

If you make any changes make sure you lint your Ansible playbooks.

ansible-lint base.yml
ansible-lint mysql.yml
ansible-lint apache.yml
ansible-lint php.yml

Testing

Tested on Ubuntu 20.04 LTS with the help of multipass.

Troubleshooting

If you are using multipass check their network troubleshooting section here https://multipass.run/docs

Personally I had to stop dnsmasq and add a nameserver 1.1.1.1 to the end of /etc/resolv.conf to get DNS working from inside the virtual machine.

sudo brew services stop dnsmasq