pubstack

Publisher's Local Development Stack

Features

• PHP 5.5.x
• Drupal/Drush
• XhProf
• XDEBUG
• New Relic
• memcached
• Splunk
• Ruby/NodeJS

Easy Installation

Using nbcutechnology/pubstack-shell is the easy way to get started with Pubstack

1. Install Composer
2. composer global require nbcutechnology/pubstack-shell:~1.0
3. pubstack init
4. vagrant plugin install vagrant-hostsupdater
5. pubstack configure (and edit the configuration to how you want it)
6. pubstack up

Manual Installation

1. Install Vagrant.

2. Install VirtualBox.

3. Install Ansible:

   • Latest Releases Via Homebrew (Mac OSX): brew update && brew install ansible

   • Latest Releases Via Apt (Ubuntu)

   • See all

4. Create a local copy of at least one project you want to work on (for example in ~/Sites/nbcu/Publisher7).

5. Clone this repo to ~/pubstack:

   git clone --branch master git@github.com:NBCUOTS/pubstack.git ~/pubstack
   cd ~/pubstack

   Note: the full path where you clone this repo should not include spaces or you will experience errors when you start up your vagrant box for the first time.

6. Install Hostupdater:

   vagrant plugin install vagrant-hostsupdater

   Note: you can disable automatic hosts file management by adding hostupdater: false to your config.yml (see below). If you do this, you will need to manage hosts file entries yourself.

7. Create your config file from the example config and modify as needed (each config has commented instructions):

   cp config.example.yml config.yml
   vim config.yml

   Note: After the initial vagrant up, any time you edit your config file values you will want to run:

   vagrant reload --provision
   

8. Start-up your vagrant box:

   vagrant up

9. Visit http://pubstack.dev/ in your browser.

Documentation

• Setting up your IDE for debugging
• Differences between Acquia & pubstack
• Detailed IP Address Setup

Customizing

1. Power users can add their own playbook(s):

   • An optional, main user playbook will be loaded if it exists: provisioning/user.playbook.yml

   • This playbook can include additional playbooks, including the main playbook, before or after your user-specific roles:

     ---
     - include: webserver.yml

2. You can also add custom roles:

   • User-specific roles should follow this naming convention:

     provisioning/roles/user-ROLE-NAME

Note: Both your user playbook, and user-specific roles will be gitignored.

Troubleshooting

Operating Systems

• We support Mac users running Mavericks
• Linux users (we trust you to know what you're doing!) -- https://github.com/NBCUOTS/pubstack/wiki/Installing-Pubstack-on-Ubuntu-14.04
• Windows (untested and currently unsupported, but feedback welcome)

Common Errors

• PDOException: SQLSTATE[42S02]: Base table or view not found : This means your Database is empty. Pubstack only creates the database for you it does not populate it.

• NFS issues? : https://github.com/NBCUOTS/pubstack/wiki/NFS-Mounting-issues

• Unable to connect to :127.0.0.1:INCORRECT_DATABASE_NAME : Please make sure your settings.local.php in your site folder includes the credentials found on http://pubstack.dev/. If you do please remove your database credentials in that file. Pubstack sets up its own database credentials and loads those.

VPN

• Cisco Issue When enabled, the Cisco Anyconnect VPN client blocks out all IP to IP communication. The fix is to remove this one line from Mac's IP Firewall, by running this script:

  ./scripts/cisco.workaround.sh

  You will be prompted for your password. Note you may need to run this twice.

Maintainers

• conortm
• ericduran
• scottrigby
• cweagans

Contributors

• rebmullin
• https://github.com/NBCUOTS/pubstack/graphs/contributors