DevShop
Primary version
Primary version
  • Introduction
  • Introduction
    • About DevShop
    • Roadmap
    • Tour
    • How it works
  • Install & Upgrade
    • Installing DevShop
    • Upgrading DevShop
    • Changing Hostname
    • System Configuration with Ansible
    • Setup Examples
  • Using DevShop
    • Deployment Hooks
    • Migrating sites into DevShop
    • Customizing settings.php
    • Automated Testing
    • Acquia Cloud Hooks Integration
    • Remote Servers
    • Going Live
    • Scaling
    • Deleting Projects & Environments
    • Using SSL
    • Password Protection
    • Troubleshooting
  • Developing DevShop
    • Developing DevShop
  • Learning DevShop
    • The Complete DevShop Training
  • Contributing
    • How to contribute to DevShop
    • Release Process
Powered by GitBook
On this page
  • Docker via Robo
  • Dependencies
  • Robo
  • Repos
  • "DevShop": Main Project
  • "DevMaster": Drupal install profile for devshop front-end
  • Debugging
  • Vagrant
  • Help Improve Documentation
  1. Contributing

How to contribute to DevShop

PreviousThe Complete DevShop TrainingNextRelease Process

Last updated 7 years ago

DevShop is a big project with a lot of git repositories, so we've made sure to include tools to make it easier.

Docker via Robo

We've implemented a RoboFile to allow us to use the Robo CLI to manage the development environment.

Visit for more information on Robo.

Dependencies

The only tools you need on your host machine to develop devshop are:

  • Git: Used to clone the source code.

  • PHP-CLI: Needed to run Drush.

  • Drush: Used to build the Drupal codebase on your host machine.

  • Docker version 1.10.0+.

  • Docker Compose version 1.6.0+.

  • .

  • .

  • .

  • .

  • .

  • Clone this Repo and change to it's directory.

     git clone git@github.com:opendevshop/devshop.git
     cd devshop
  • If working on a Mac (or a linux machine with a user other than uid 1000), you need to regenerate your containers so the Aegir user UID matches your local user UID:

    robo prepare:containers

    The command will attempt to automatically detect your UID. If you need to set it manually, you can pass the UID as an argument

    robo prepare:containers 1001
  1. Run robo up script to clone the rest of the source code and launch the docker containers.

  2. That's it! Look for a one-time login link that looks like:

    http://devshop.local.computer/user/reset/1/1475596064/EzLbpsTpSgKLJl7GmO0

    The docker logs will remain open. Press CTRL-C to cancel out of the logs if you wish, the containers will still run.

Robo

Our Robofile.php has all the commands you need to manage a local development copy of DevShop:.

Once the robo CLI is installed, cd to the DevShop repo directory and run robo to see a list of available commands.

Available commands:
  destroy             Destroy all containers, docker volumes, and aegir configuration.
  help                Displays help for a command
  launch              Launch devshop after running prep:host and prep:source. Use --build to build new local containers.
  list                Lists commands
  logs                Stream logs from the containers using docker-compose logs -f
  login               Get a one-time login link to Devamster.
  shell               Enter a bash shell in the devmaster container.
  stop                Stop devshop containers using docker-compose stop
  test                Run all devshop tests on the containers.
  up                  Launch devshop containers using docker-compose up and follow logs.
 prepare
  prepare:containers  Build aegir and devshop containers from the Dockerfiles. Detects your UID or you can pass as an argument.
  prepare:host        Check for docker, docker-compose and drush. Install them if they are missing.
  prepare:sourcecode  Clone all needed source code and build devmaster from the makefile.

Repos

DevShop consists of a number of code repositories.

"DevShop": Main Project

If you want to develop the server setup, the standalone install script, the documentation, or improve the Vagrantfile, fork this repo.

Contains:

  • DevShop install script: install.sh

  • Ansible playbooks: playbook.yml, roles folder.

  • Documentation

  • Vagrantfile

  • build-devmaster.make file: used to build the devshop front-end.

    (Modify this file to use your fork of devmaster.)

"DevMaster": Drupal install profile for devshop front-end

If you want to develop the front-end of devshop:

  1. Edit build-devmaster.make file, and replace the devmaster url and branch with your forked repo url and branch like so:

    projects[devmaster][type] = "profile"
    projects[devmaster][download][type] = "git"
    projects[devmaster][download][url] = "git@github.com:MYUSERNAME/devmaster.git"
    projects[devmaster][download][branch] = "dev-MYBRANCH"

See the ./source/devmaster-1.x/profiles/devmaster folder for the fully built devmaster stack.

Debugging

The containers now contain XDEBUG that works for web requests and drush calls.

This is extremely helpful when working on tasks, which might be running in the backend.

To setup your IDE to listen for debug connections, use the following settings:

DGBp Proxy:

  • idekey: PHPSTORM

  • Host: 172.17.0.1

  • Port: 9000

In PHPStorm, this is in the Settings > PHP > Debug > DGBp Proxy page.

Don't forget to "Start Listening to PHP Debug Connections", get an XDEBUG plugin for your browser and enable it for devshop.local.computer, and to set a breakpoint or an error to see the debugger work.

If using PHPStorm, It will ask you to map files. You should map ./aegir-home to /var/aegir as "Absolute path on the server".

If your Docker machine IP is not 172.17.0.1, you can change it but you must also change a line in docker-compose.yml:

    XDEBUG_CONFIG: "remote_host=172.17.0.1 idekey=PHPSTORM"

To detect what your machine's host IP is, you can run the following command from within the container:

    docker-compose exec devmaster bash
    /sbin/ip route|awk '/default/ { print $3 }'

Vagrant

The Vagrantfile in this project is now deprecated, but is still included in the vagrant folder if you wish to use it.

It uses the install.sh file in this repo to provision the vagrant server.

This is the recommended install method for servers as well as vagrant boxes.

Help Improve Documentation

Thanks!

Fork this repo (), and create your own branch for your feature or bugfix.

Credit to

See for legacy instructions.

Think this can be improved? You can and select "Create a new branch for this commit and start a pull request.".

http://robo.li
Install Git
Install Drush
Install Robo
Install Docker
Install Docker Compose
github.com/opendevshop/devshop
github.com/opendevshop/devmaster
https://github.com/opendevshop/devshop
http://stackoverflow.com/questions/22944631/how-to-get-the-ip-address-of-the-docker-host-from-inside-a-docker-container
Development with Vagrant
edit this file on GitHub