Skip to content

README.md

Latest commit

 

History

History
61 lines (44 loc) · 2.15 KB

README.md

File metadata and controls

61 lines (44 loc) · 2.15 KB

Laravel Ansible Deployer

A full Laravel deployment solution built with Ansible, bootstraped-from ansible-quick-starter.

This repository helps you quickly provision and deploy a Laravel application with best practices for automation and repeatability.

It’s designed to make deployment on on-premise or VM-based environments simple and efficient.

NB: The project don't integrate SSL/TLS

Project Structure

main_playbook.yml is the entry point of project! playbooks/ contain Ansible playbooks for provisioning and deployment roles/ Modular roles for different parts of the stack vagrant/ Local test environment (Vagrant + VirtualBox). (NB: You can use any Hypervisor) reference/ have some a manual process ofdeployment of the solution! It's no-more updated! But I left it to share the importance of doing things manually at least once!

Roles Overview

Each role is a building block of the deployment process:

  • common : updates system packages, installs common utilities (git, curl, unzip, etc.)
  • php8.1 or php8.2 : installed any version of php with required extensions on your hosts
  • composer installed the mytic PHP package manager
  • nginx installed the NGINX webserver/proxy used to serve content
  • mariadb installed a relationnal database to store and persist our apps data
  • redis installed and setup the in memory database use to perform caching and queues jobs
  • deploy-laravel-app use to deploy the laravel project

How to use it ?

  1. Clone the project
git clone https://github.com/tchedem/laravel_ansible_deployer.git
cd laravel_ansible_deployer
  1. Initialize inventory (optional)
mv inventories.example inventories

If you want to use vagrant to test the playbook in a controlled environment

# Make sure you have vagrant installed
cd vagrant
vagrant up

# get SSH keys instructions
cd ../scripts
cat README.md
  1. Start cooking from your Control Node (CN)
# ansible-playbook -i inventories/test main_playbook.yml -u <your_username>
ansible-playbook -i inventories/local main_playbook.yml -u vagrant # If you are using vagrant