Local Studio Container

This guide will walk you through launching a Docker-container local development studio and using it to test changes made within a local Git repository.

Launch studio container

1. Install Chef Habitat:

   curl -s https://raw.githubusercontent.com/habitat-sh/habitat/master/components/hab/install.sh | sudo bash
   

2. Set up Chef Habitat, accepting defaults for all prompts:

   hab setup
   

3. Clone emergence-skeleton repository and any submodules:

   git clone --recursive git@github.com:JarvusInnovations/emergence-skeleton.git
   

4. Change into cloned directory:

   cd ./emergence-skeleton
   

5. Launch studio:

   Use the included scripts-to-rules-them-all workflow script to configure and launch a studio session:

   script/studio
   

   Review the notes printed to your terminal at the end of the studio startup process for a list of all available studio commands.

Bootstrap and develop backend

1. Start services:

   Use the studio command start-all to launch the http server (nginx), the application runtime (php-fpm), and a local mysql server:

   start-all
   

   At this point, you should be able to open localhost:7080 and see the error message Page not found.

2. Build site:

   To build the entire site and load it, use the studio command update-site:

   update-site
   

   At this point, localhost:7080 should display the current build of the site

3. Load fixture data into site database (optional):

   load-fixtures
   

   The standard fixture data includes the following users:

   Username	Password	AccountLevel	About
   system	system	Developer	Full system access
   admin	admin	Administrator	Manage site and staff
   staff	staff	Staff	Staff access
   user	user	User	Regular user

4. Make and apply changes:

   After editing code in the working tree, you must rebuild and update the site:

   update-site
   

   A command to automatically rebuild and update the site as changes are made to the working tree is also available, but currently not that efficient or reliable:

   watch-site
   

Enable user registration

To enable user registration on a site that comes with it disabled:

# write class configuring enabling registration
mkdir -p php-config/Emergence/People
echo '<?php Emergence\People\RegistrationRequestHandler::$enableRegistration = true;' > php-config/Emergence/People/RegistrationRequestHandler.config.php

# rebuild environment
update-site

After visiting /register and creating a new user account, you can use the studio command promote-user to upgrade the user account you just registered to the highest access level:

promote-user <myuser>

Connect to local database

The studio container hosts a local MySQL instance that can be connected to at:

• Host: localhost (or LAN/WAN IP of machine hosting Docker engine)
• Port: 7036
• Username: admin
• Password: admin