Basic Vagrant Setup with a bootstrap script for a LEMP (NGINX, PHP7, MySQL) stack, Jekyll, Ruby and Composer. Makes use of the 64 bit version of Ubuntu Bionic (18.04) box provided by Vagrant itself. Automates the setup and initial configuration of the packages.
Its a custom machine I use in my projects.
- VirtualBox
- Vagrant
- Cygwin or any other ssh-capable terminal shell.
- Rsync if you're using a Windows host.
- Ubuntu Xenial 16.04 (
ubuntu/xenial64) - MySQL (
mysql-server mysql-client) - Nginx (
nginx) - PHP 7.2 (
php7.2-fpm) - Ruby 2.1 (
ruby ruby-dev) - github-pages (
github-pages bundler jekyll-paginate) - Jekyll (provided with github-pages)
- Composer (lastest version on provision).
PHP Extensions:
php-cli php-curl php-dev php-zip php-fpm php-gd php-xml php-mysql php-mbstring php-json php-sqlite3 php-xdebug
Other Packages:
curl
host $ git clone https://github.com/drvy/drvys-box.git
host $ cd drvys-box
host $ vagrant up
Once build, log into the machine with:
host $ vagrant ssh
You can check if everything went well by opening http://192.168.30.10 on your host machine.
There is a shared folder that points directly to the root directory of the Nginx site. That is:
host: drvys-box/wwww
guest: /var/www/
Please notice that some boxes like the one used here, force the sharing method to rsync. RSYNC does NOT come by default in Windows environments and you need to install it by yourself before running the box for the first time.
The easiest way to install it is to install the CyGWIN platform. Go to Cygwin.com, download and run the installer. When it prompts you for packages to install, be sure to select rsync and openssh.
Also, notice that the GIT installer for Windows although it does include some UNIX tools, does NOT provide rsync therefore you should use the CyGWIN Terminal to provision and run your Vagrant box.
The default MySQL user is root. The default password for root is toor.
You can access the database as normal. PHPMyAdmin is NOT available. You can use any external program for such task by providing the default params. Recommended and tested programs: Navicat, HeidiSQL and MySQL Workbench.
A setup example for Navicat would be:
* Notice: As this is pretended to be a development machine, MySQL installation is NOT secured.
Vagrant is instructed to generate a random key file, so your Private Key will be inside the machine folder `(.vagrant/machines/default/virtualbox/private_key)
- The only port forwarded is the default SSH (22), and its done automatically by Vagrant.
- GitHub-Pages or Jekyll use by default the port 4000.
- MySQL uses the default port (3306)
There are some problems forwarding the connections between the Jekyll server and the guest/host. Also, you need to enable force polling so Jekyll can correctly watch and update the site on the go. If you want to serve a Jekyll site with auto-rebuild, you should use this command:
jekyll serve --force_polling --host=0.0.0.0
If everything builds well, you should be able to access your Jekyll site on your host machine by accessing http://192.168.30.10:4000
The default nginx virtualhost (site) is replaced with a custom one in order to be able to serve PHP files. No big changes. You can check the bootstrap.sh file to see what the build looks like.
The default site serves files from /var/www/.
The default site logs are in /var/log/nginx/.
On provision, the machine will generate a self-signed certificate to enable NGINX SSL (HTTPS). Since the key is self-signed, you will be presented with an alert on any modern browser. Just skip or replace the certificate (/etc/nginx/conf.d/certs/dmdev.(cert/key)) with your own.
Due to a known bug with Virtualbox, the sendfile directive is disabled by default after installation. You can change this behavior inside the Vagrantfile. However you may experience some annoying behavior like files not updating after a change on the host machine.
This are the default URLs on your host machine:
| Service | URL |
|---|---|
| HTTP (Nginx) | http://192.168.30.10 or https://192.168.30.10 |
| Jekyll | http://192.168.30.10:4000 |
These are the basic commands to manage the vagrant machine. If you want to know more about them, just check the official Vagrant documentation.
| Action | Command |
|---|---|
| First Start | vagrant up --provision |
| Normal Start | vagrant up |
| Update Box | vagrant box update |
| Suspend | vagrant suspend |
| Resume | vagrant resume |
| Shutdown | vagrant halt |
| Destroy | vagrant destroy |
| Status | vagrant status |
MIT License
Copyright (c) 2018 Dragomir Yordanov
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.