Roots Example Project

This repository is an example of how to integrate and use the following projects together:

• Bedrock
• Trellis
• Sage (with Soil)

For more background, see this blog post.

This project is a complete working example that's deployed on a Digital Ocean 512MB droplet.

You can view it at http://roots-example-project.com/.

Instructions

This project can be cloned and re-configured to fit your needs but we highly suggest you follow in the instructions below to create your own. This will guarantee you have the latest version of Bedrock, Trellis, Sage, and Soil in case this example falls behind a little.

Here's how this example project was created:

1. Create a new project directory: $ mkdir example.com && cd example.com
2. Clone Trellis: $ git clone --depth=1 [email protected]:roots/trellis.git ansible && rm -rf ansible/.git
3. Clone Bedrock: $ git clone --depth=1 [email protected]:roots/bedrock.git site && rm -rf site/.git
4. Clone Sage: $ git clone --depth=1 [email protected]:roots/sage.git site/web/app/themes/sage && rm -rf site/web/app/themes/sage/.git
5. Move Vagrantfile to root: $ mv ansible/Vagrantfile . and update the ANSIBLE_PATH to File.join(__dir__, 'ansible')

After that your folder structure is complete and you're ready to configure the individual components.

Bedrock

Bedrock doesn't need any additional configuration by default. There's only one custom option set in this example: WP_DEFAULT_THEME.

• In site/config/application.php add define('WP_DEFAULT_THEME', 'sage');

Trellis

Trellis' instructions apply here, but more specifically:

1. Make sure you have the requirements all installed
2. Install the Ansible Galaxy roles: $ cd ansible && ansible-galaxy install -r requirements.yml
3. Configure your wordpress_sites: docs and follow our example

Staging/Production

If you also want staging/production servers, create those manually at this point.

1. Add their hostnames/IPs to ansible/hosts/<environment>
2. Configure their wordpress_sites just like #3 above and follow our example. Be sure to uncomment subtree: site.
3. Define your SSH keys to give users the ability to deploy. Follow our example and read the SSH Keys wiki.

Provision

Development

1. Run vagrant up

Staging/Production

1. Provision server: ansible-playbook -i hosts/<environment> server.yml
2. Deploy your site: ./deploy.sh <environment> <site name>

Naming

Some notes on names used throughout this project:

• You're encouraged to rename Sage to your theme name. Just remember to rename references to it everywhere.
• Any time you see a name like "example.com", "example.dev", "roots-example-project.com", etc, it should be renamed to your project name.
• <environment> is a placeholder to be replaced by staging or production (for example).

Sage/Theme

1. Install Sage's requirements
2. SSH into VM: $ vagrant ssh
3. Add Soil: $ cd /srv/www/example.com/current && composer require roots/soil
4. Activate Soil: $ wp plugin activate soil
5. Configure Sage and customize the theme as usual. At a minimum, do this on your host/local machine:

$ cd web/app/themes/sage
$ npm install
$ bower install
$ gulp

Platform-B Setup steps:

I. Clone this repository.

II. Configure Trellis:

1. Make sure you have the requirements all installed
2. Install the Ansible Galaxy roles: $ cd ansible && ansible-galaxy install -r requirements.yml
3. Configure ansible/group_vars/all: a. Add your SSH Keys:

		users:
	  - name: "{{ web_user }}"
	    groups:
	      - "{{ web_group }}"
	    keys:
	      - "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
	      - https://github.com/okimangelo.keys
	  - name: "{{ admin_user }}"
	    groups:
	      - sudo
	    keys:
	      - "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
	      - https://github.com/okimangelo.keys      

4. Configure ansible/group_vars/development:

	wordpress_sites:
	  posvisualsolutions.dev:
	    site_hosts:
	      - posvisualsolutions.dev
	    local_path: ../site # path targeting local Bedrock site directory (relative to Ansible root)
	    repo: [email protected]:tinbot-development/posvisualsolutions.git
	    site_install: true
	    site_title: POS Visual Solutions
	    db_import: ../site/db/Dump20150909.sql
	    admin_user: admin
	    admin_password: admin
	    admin_email: [email protected]
	    multisite:
	      enabled: false
	      subdomains: false
	    ssl:
	      enabled: false
	    cache:
	      enabled: false
	      duration: 30s
	    system_cron: true
	    env:
	      wp_home: http://posvisualsolutions.dev
	      wp_siteurl: http://posvisualsolutions.dev/wp
	      wp_env: development
	      db_name: posvisualsolutions
	      db_user: posvisualsolutions
	      db_password: posvisualsolutions

4. Run "Run Vagrant up"