FoxLab Workflow

Requirements

Make sure all dependencies have been installed before moving on:

• Ansible 2.0.2
• Virtualbox >= 4.3.10
• Vagrant 1.8.1
• vagrant-bindfs >= 0.3.1 (Windows users may skip this)
• vagrant-hostmanager

Installation

1. Create a new project directory: $ mkdir example && cd example
2. Clone Trellis: $ git clone --depth=1 [email protected]:foxlab/trellis.git && rm -rf trellis/.git
3. Clone Bedrock: $ git clone --depth=1 [email protected]:foxlab/bedrock.git site && rm -rf site/.git
4. Install the Ansible Galaxy roles: $ cd trellis && ansible-galaxy install -r requirements.yml

Local development setup

1. Configure your WordPress sites in group_vars/development/wordpress_sites.yml and in group_vars/development/vault.yml
2. Run vagrant up

Add and start new Wordpress site dev

1. Configure your WordPress sites in group_vars/development/wordpress_sites.yml and in group_vars/development/vault.yml
2. Clone Bedrock: $ git clone --depth=1 [email protected]:foxlab/bedrock.git site && rm -rf site/.git
3. Navigate to the trellis directory
4. Run vagrant reload --provision
5. Navigate to the site directory
6. Run composer update
7. Navigate to the theme directory
8. Run npm install
9. Run bower install
10. Run gulp

Using BrowserSync

To use BrowserSync during gulp watch you need to update devUrl at the bottom of assets/manifest.json to reflect your local development hostname.

...
  "config": {
    "devUrl": "http://project-name.dev"
  }
...

Trellis

Ansible playbooks for setting up a LEMP stack for WordPress.

• Local development environment with Vagrant
• High-performance production servers
• One-command deploys for your Bedrock-based WordPress sites

What's included

Trellis will configure a server with the following and more:

• Ubuntu 16.04 Xenial LTS
• Nginx (with optional FastCGI micro-caching)
• PHP 7.0
• MariaDB (a drop-in MySQL replacement)
• SSL support (scores an A+ on the Qualys SSL Labs Test)
• Let's Encrypt integration for free SSL certificates
• HTTP/2 support (requires SSL)
• Composer
• WP-CLI
• sSMTP (mail delivery)
• MailHog
• Memcached
• Fail2ban
• ferm

Requirements

Make sure all dependencies have been installed before moving on:

• Ansible 2.0.2
• Virtualbox >= 4.3.10
• Vagrant >= 1.8.5
• vagrant-bindfs >= 0.3.1 (Windows users may skip this)
• vagrant-hostmanager

Installation

The recommended directory structure for a Trellis project looks like:

example.com/      # → Root folder for the project
├── trellis/      # → Your clone of this repository
└── site/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)

See a complete working example in the roots-example-project.com repo.

1. Create a new project directory: $ mkdir example.com && cd example.com
2. Clone Trellis: $ git clone --depth=1 [email protected]:roots/trellis.git && rm -rf trellis/.git
3. Clone Bedrock: $ git clone --depth=1 [email protected]:roots/bedrock.git site && rm -rf site/.git
4. Install the Ansible Galaxy roles: $ cd trellis && ansible-galaxy install -r requirements.yml

Windows user? Read the Windows docs for slightly different installation instructions. VirtualBox is known to have poor performance in Windows — use VMware or see some possible solutions.

Documentation

Trellis documentation is available at https://roots.io/trellis/docs/.

Local development setup

1. Configure your WordPress sites in group_vars/development/wordpress_sites.yml and in group_vars/development/vault.yml
2. Run vagrant up

Read the local development docs for more information.

Remote server setup (staging/production)

A base Ubuntu 16.04 server is required for setting up remote servers.

1. Configure your WordPress sites in group_vars/<environment>/wordpress_sites.yml and in group_vars/<environment>/vault.yml (see the Vault docs for how to encrypt files containing passwords)
2. Add your server IP/hostnames to hosts/<environment>
3. Specify public SSH keys for users in group_vars/all/users.yml (see the SSH Keys docs)
4. Run ansible-playbook server.yml -e env=<environment> to provision the server

Read the remote server docs for more information.

Deploying to remote servers

1. Add the repo (Git URL) of your Bedrock WordPress project in the corresponding group_vars/<environment>/wordpress_sites.yml file
2. Set the branch you want to deploy
3. Run ./deploy.sh <environment> <site name>
4. To rollback a deploy, run ansible-playbook rollback.yml -e "site=<site name> env=<environment>"

Read the deploys docs for more information.

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Keep track of development and community news.

• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter
• Listen to the Roots Radio podcast