Skip to content

Commit

Permalink
Merge pull request #1812 from Varying-Vagrant-Vagrants/develop
Browse files Browse the repository at this point in the history
Release VVV 3
  • Loading branch information
tomjn committed May 17, 2019
2 parents 7d50c47 + a5c081d commit c9d33ff
Show file tree
Hide file tree
Showing 32 changed files with 638 additions and 618 deletions.
1 change: 1 addition & 0 deletions .gitignore
Expand Up @@ -16,6 +16,7 @@
/provision/provision-post.sh
/provision/github.token
/provision/resources/
/provision/utilities/
/provision/phpcs/

# Ignore custom trigger scripts in config/homebin.
Expand Down
34 changes: 33 additions & 1 deletion CHANGELOG.md
Expand Up @@ -4,7 +4,39 @@ title: Changelog
permalink: /docs/en-US/changelog/
---

## 2.6.0 ( TBD )
## 3.0.0 ( 17 May 2019 )

This version moves to an Ubuntu 18.04 box. It also moves the database data directory to a mounted folder. This means you can destroy and rebuild the VM without loss, but it also means **a `vagrant destroy` is necessary to update**. **Be sure to back up database tables you need beforehand**.

If you have issues provisioning with the new shared database folder, you can disable it by adding `db_share_type: false` to the `general:` section of `vvv-custom.yml` then reprovisioning. This will return you to the VVV 2 behaviour.

In the near future, we expect to use a box with PHP/etc preinstalled, this will be VVV 4.0.

### Enhancements

- The box was changed to use Ubuntu 18.04 LTS
- If cloning a git repo to create a new site fails, VVV will halt provisioning and warn the user
- Added tbe `git-svn` package, `git-svn` is used for bi-directional operation between subversion and git
- MongoDB was updated to v4.0
- New `/srv/provision` and `/srv/certificates` shared folders
- Provisioners now log their output to a `logs/provisioners` folder, with each provision having its own subfolder

### Bug Fixes

- Added a VVV package mirror PPA
- Updated apt-get keys for several sources
- Prevented provisioning from occurring inside Ubuntu 14 VMs
- Fixed issues with Nginx restarting too fast and too often by reloading instead
- Fixed the permissions on the `db_restore` script
- The `/var/log` folder is no longer directly mounted, instead the `/var/log/php`, `/var/log/nginx`, `/var/log/provisioners` and `/var/log/memcached` subfolders are mounted. This improves compatibility
- The SQL import script for backups will now create the databases if they don't exist before importing

### Removals

- The deprecated domains `vvv.dev`, `vvv.local`, and `vvv.localhost`, were removed, the dashboard lives at `vvv.test`.
- Removed the `/vagrant` default shared folder

## 2.6.0 ( 2nd April 2019 )

### Enhancements

Expand Down
57 changes: 16 additions & 41 deletions README.md
@@ -1,58 +1,33 @@
# Varying Vagrant Vagrants
# Varying Vagrant Vagrants ( VVV )

Varying Vagrant Vagrants is an open source [Vagrant](https://www.vagrantup.com) configuration focused on [WordPress](https://wordpress.org) development.
VVV is local developer environment, mainly aimed at [WordPress](https://wordpress.org) developers. It uses [Vagrant](https://www.vagrantup.com) and VirtualBox, and can be used ot build sites and contribute to WordPress.

The online documentation contains detailed [installation instructions](https://varyingvagrantvagrants.org/docs/en-US/installation/).
## How To Use

VVV is a [10up](https://10up.com) creation and [transitioned](http://10up.com/blog/varying-vagrant-vagrants-future/) to a community organization in 2014.
To use it, download and install [Vagrant](https://www.vagrantup.com) and [VirtualBox](https://www.virtualbox.org/). Then, clone this repository and run:

* **Latest Stable**: [2.5.0 master branch](https://github.com/Varying-Vagrant-Vagrants/VVV/tree/master)
* **Web**: [https://varyingvagrantvagrants.org/](https://varyingvagrantvagrants.org/)
* **Contributing**: Contributions are more than welcome. Please see our current [contributing guidelines](https://varyingvagrantvagrants.org/docs/en-US/contributing/). Thanks!
```
vagrant plugin install vagrant-hostsupdater --local
vagrant up --provision
```
When it's done, visit http://vvv.test.

VVV is under the [MIT License](LICENSE).
The online documentation contains more detailed [installation instructions](https://varyingvagrantvagrants.org/docs/en-US/installation/).

## Objectives

* Approachable development environment with a modern server configuration.
* Stable state of software and configuration in default provisioning.
* Excellent and clear documentation to aid in learning and scaffolding.
* **Web**: [https://varyingvagrantvagrants.org/](https://varyingvagrantvagrants.org/)
* **Contributing**: Contributions are more than welcome. Please see our current [contributing guidelines](https://varyingvagrantvagrants.org/docs/en-US/contributing/). Thanks!

VVV is ideal for developing themes and plugins, as well as for [contributing to WordPress core](https://make.wordpress.org/core/).

## Minimum System requirements

- [Vagrant](https://www.vagrantup.com) 2.2.4+
- [Virtualbox](https://www.virtualbox.org) 5.2+
- 8GB+ of RAM
- Virtualisation ( VT-X ) enabled in the BIOS ( Windows/Linux )
- Hyper-V turned off ( Windows )

## Software included

VVV is built on a Ubuntu 14.04 LTS (Trusty) base VM and provisions the server with current versions of several software packages, including:

1. [Nginx](http://nginx.org/) (mainline)
1. [MariaDB](https://mariadb.org/) 10.1.x (drop-in replacement for MySQL)
1. [PHP FPM](http://php-fpm.org/) 7.2.x
1. [WP-CLI](http://wp-cli.org/)
1. [Memcached](http://memcached.org/)
1. [PHPUnit](https://phpunit.de/)
1. [Composer](https://github.com/composer/composer)
1. [NodeJs](https://nodejs.org/) v10
1. [Mailhog](https://github.com/mailhog/MailHog)

For a more comprehensive list, please see the [list of installed packages](https://varyingvagrantvagrants.org/docs/en-US/installed-packages/).

## How to Use VVV

VVV requires recent versions of both Vagrant and VirtualBox.

[Vagrant](https://www.vagrantup.com) is a "tool for building and distributing development environments". It works with [virtualization](https://en.wikipedia.org/wiki/X86_virtualization) software such as [VirtualBox](https://www.virtualbox.org/) to provide a virtual machine sandboxed from your local environment.

Besides VirtualBox, provider support is also included for Parallels, Hyper-V, VMWare Fusion, and VMWare Workstation.

The online documentation contains detailed [installation instructions](https://varyingvagrantvagrants.org/docs/en-US/installation/).

Full documentation can be found on the [varyingvagrantvagrants.org](https://varyingvagrantvagrants.org) website.

## Contributors
For a comprehensive list, please see the [list of installed packages](https://varyingvagrantvagrants.org/docs/en-US/installed-packages/).

A full list of contributors can be found [here](https://github.com/Varying-Vagrant-Vagrants/VVV/graphs/contributors).

0 comments on commit c9d33ff

Please sign in to comment.