The project goal is to automatically deploy the configuration needed for an operational development environment.
The component are standard dev stack for front and back.
The databases as well as the indexing engine is defined on the second machine so as to limit the impacts.
The application servers are on the main machine.
The aim of such an architecture is to have a modular configuration.
It is possible to extend this base via the association of additional roles.
This project involves the use of:
Automation:
- ansible
- vagrant
- virtualbox
HTTP Server:
- nginx
- apache2
Database:
- mongodb
- mysql
Search Engine:
- elasticsearch
Paas:
- cloudfoundry
Language:
- python 2.7
- php 7.x
- php fpm
- nodejs
Framework:
- Symfony Framework 3.x
================================================================================ Why these choices
Ansible:
Ansible is a radically simple IT automation engine that automates cloud provisioning, configuration management, application deployment, intra-service ... Ansible is an agentless architecture.
Vagrant:
Vagrant enables users to create and configure lightweight, reproducible, and portable development environments. The goal is building and maintaining portable virtual development environments.
Virtualbox:
VirtualBox is a cross-platform virtualization application. VirtualBox is a free and open-source hypervisor for x86 computers. VirtualBox allow a user to run a secondary instance of another operating system for compatibility or testing purposes.
Nginx:
Nginx is a web server, which can also be used as a reverse proxy, load balancer and HTTP cache. Nginx doesn't rely on threads to handle requests, unlike traditional servers.
Nginx utilizes an asynchronous event-driven approach.
The modular event-driven architecture used by nginx allows for more predictability in regards to performance when the server is under heavy loads.
Apache2:
The Apache HTTP Server, colloquially called Apache is the world's most used web server software. Originally based on the NCSA HTTPd server.
Mongodb:
MongoDB is an open source database that uses a document-oriented data model. MongoDB offers scalability, no schema migrations. MongoDB offers deep query-ability and supports dynamic queries on documents using a document-based query language that's nearly as powerful as SQL.
Mysql:
MySQL is a free, open-source database management system (DBMS for short). A DBMS is a system that manages databases and connects them to software. For example, a MySQL database can be used to run a website, to run the database of an ERP or any other software. MySQL is an relational database management system (RDBMS) based on Structured Query Language.
Elasticsearch:
Elasticsearch is a search engine based on Apache Lucene. It provides a distributed, multitenant-capable full-text search engine with an HTTP web interface. Elasticsearch is RESTful search engine built on top of Apache Lucene.
Elasticsearch provides a scalable search solution. Elasticsearch performs near-real-time searches. Elasticsearch provides support for multi-tenancy. Elasticsearch Streamlines backup processes ensures data integrity. With elasticsearch, an index can be easily recovered in a case of a server crash. Elasticsearch uses Javascript Object Notation (JSON) and Java application program interfaces (APIs). Elasticsearch automatically indexes JSON documents. Elasticsearch indexing uses unique type-level identifiers. With elasticsearch, each index can have its own settings. With elasticsearch, searches can be done with Lucene-based querystrings.
Cloud Foundry:
Cloud Foundry is an open source, multi cloud application platform as a service (PaaS) governed. Cloud Foundry is a system to easily deploy, operate and scale stateless applications that are written in any programming language or framework. Customizable, it allows to program in several languages and under several infrastructures. Cloud Foundry provides a REST API to deploy, operate and scale applications.
Language:
python 2.7, php 7.x, nodejs are representative languages of web technologies with a strong community and frameworks.
PHP-FPM:
PHP-FPM is a simple and robust FastCGI Process Manager for PHP. It can dramatically ease scaling of PHP apps and is the normal way of running PHP-based sites and apps when using a webserver like Nginx (though it can be used with other webservers just as easily).
Framework Php:
- Symfony Framework is high performance PHP framework for web development
================================================================================
Software on host
vagrant 1.8.5
ansible 2.1.1.0
python 2.7.12
virtualbox 5.1.4r110228
supported systems
We currently support Linux and macOS.
vagrant plugins
sahara (0.0.17)
vagrant-ansible-local (0.0.2)
vagrant-env (0.0.3)
vagrant-gatling-rsync (0.9.0)
vagrant-guestip (0.2)
vagrant-host-shell (0.0.4)
vagrant-hostmanager (1.8.5)
vagrant-hosts (2.8.0)
vagrant-hosts-provisioner (2.0)
vagrant-hostsupdater (1.0.2)
vagrant-list (0.0.6)
vagrant-multi-hostsupdater (0.0.6)
vagrant-proxyconf (1.5.2)
vagrant-reload (0.0.1)
vagrant-rsync (0.2.5)
vagrant-share (1.1.6)
vagrant-triggers (0.5.3)
vagrant-vbguest (0.13.0)
vagrant-vbox-snapshot (0.0.10)
-
Clone repository
git clone [email protected]:logorn/dev_stack.git deploy
-
Record and execute command
vagrant up
-
Open url devstack from your browser. The following message should appear "Service Unavailable"
curl devstack
-
Acces vm through the ssh connection
vagrant ssh
You can use this project associating it with telosys for symfony ansible role.
Inside roles directory:
git clone https://github.com/logorn/ansible-role-telosys-symfony.git telosys-php
Example Playbook
Inside devstack.yml, add this:
- hosts: devstack
roles:
- role: telosys-php
tags: telosys-php
...
and play now your provision ...
In case of problem, just start with the command on host
vagrant provision # provisionning guest machine
To destroy virtual machine and provisionning
vagrant destroy
vagrant up
Inspired by:
Jeff Geerling (geerlingguy)
https://github.com/geerlingguy/ansible-role-php
https://github.com/geerlingguy/ansible-role-nginx
https://github.com/geerlingguy/ansible-role-java
https://github.com/geerlingguy/ansible-role-elasticsearch
https://github.com/geerlingguy/ansible-role-php-xdebug
Ansible City
https://github.com/ansible-city/swap
locationlabs
https://github.com/locationlabs/ansible-role_kernel-update
Apache License, Version 2.0
http://www.apache.org/licenses/LICENSE-2.0.html
These roles were created in 2017 by Hugues MAILLET, inspired by Jeff Geerling author of Ansible for DevOps and the work of many.