__ ___ ___ __ ____ \ \ / \ \ / \ \ / / |___ \ \ \ / / \ \ / / \ \ / / __) | \ V / \ V / \ V / / __/ \_/ \_/ \_/ |_____| Varying Vagrant Vagrants Tom J Nowell @tarendai https://tomjn.com

This Talk Covers ● What is VVV ● What Changed in VVV 2 ● Migrating from VVV 1 ● Setting up a new Site ● Setting up an existing site

What is VVV?

A Local Developer Environment ● WP CLI ● PHP ● MariaDB ● MemcacheD ● Nginx ● Site Provisioning ● A standardised system

Installation From scratch ● Install Vagrant & Virtualbox & git ● Grab a copy of VVV from GitHub ● Run: vagrant plugin install vagrant-triggers vagrant-hostsupdater Then: vagrant up --provision

No content

vagrant up Turns it on vagrant halt Turns it off

What Changed in VVV 2?

vvv-config.yml

Sites: # The wordpress-default configuration provides a default installation of the # latest version of WordPress. wordpress-default: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-default.git hosts: - local.wordpress.dev # The wordpress-develop configuration is useful for contributing to WordPress. wordpress-develop: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-develop.git hosts: - src.wordpress-develop.dev - build.wordpress-develop.dev #example-site: # repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template.git # hosts: # - my-example-site.dev utilities: core: - memcached-admin - opcache-status - phpmyadmin - webgrind

Important: Copy to vvv-custom.yml

Migrating from VVV 1

Backup your database Already done if you have vagrant-triggers

Rebuild: vagrant destroy Vagrant up --provision

Migrating a VVV 1 Site

No content

sites: vvv1site: hosts: - vvv1site.dev

Always reprovision on changes vagrant reload --provision

Setting Up a New Site

Add a site to vvv-custom.yml: newsite: repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-t emplate.git hosts: - newsite.com

sites: wordpress-default: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-default.git hosts: - local.wordpress.dev wordpress-develop: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-develop.git hosts: - src.wordpress-develop.dev - build.wordpress-develop.dev newsite: repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template.git hosts: - newsite.com utilities: core: - memcached-admin - opcache-status - phpmyadmin - webgrind

Always reprovision on changes vagrant reload --provision

Setting Up An Existing Site

Add a site to vvv-custom.yml: site-name: repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-t emplate.git hosts: - example.com

1. Reprovision 2. Copy files 3. Copy Database

Always reprovision on changes vagrant reload --provision

Advanced Provisioning

provision/vvv-init.sh A bash script that sets up your site provision/vvv-nginx.conf The NGINX config for your site

More Per Site Options skip_provisioning: true branch: develop

Custom Folders local_dir: vm_dir:

example-site: local_dir: /home/user/Documents/example vm_dir: /srv/www/examplesite hosts: - my-example-site.dev

sites: # The wordpress-default configuration provides a default installation of the # latest version of WordPress. wordpress-default: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-default.git hosts: - local.wordpress.dev example-site: repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template.git local_dir: /home/user/Documents/example vm_dir: /srv/www/examplesite hosts: - my-example-site.dev utilities: core: - memcached-admin - opcache-status - phpmyadmin - webgrind

Custom PHP Versions nginx_upstream: php56

sites: # The wordpress-default configuration provides a default installation of the # latest version of WordPress. wordpress-default: repo: https://github.com/Varying-Vagrant-Vagrants/vvv-wordpress-default.git nginx_upstream: php70 hosts: - local.wordpress.dev example-site: repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template.git nginx_upstream: php56 hosts: - my-example-site.dev utilities: core: - memcached-admin - opcache-status - phpmyadmin - webgrind - php56

Common Troubleshooting Local Network Clashes VVV using the same IP as other computers Typos in vvv-custom.yml Syntax errors will break provisioning Corrupt VMs Powering down a machine unsafely, or disk corruption Out of Date Software Old Vagrant and Virtualbox Downgrading to VVV 1 Downgrading isn’t supported

Database Backups Vagrant triggers runs a backup script on halt/destroy that places SQL files in database/backups/*.sql Backups are restored on provision if the db is empty

More Info https://github.com/Varying-Vagrant-Vagrants https://varyingvagrantvagrants.org

Tom J Nowell VIP Wrangler at Automattic https://tomjn.com @tarendai

Q? Tom J Nowell @tarendai https://tomjn.com