sanduhrs / ddev-gitpod

A full Drupal dev environment in a browser

ddev + Gitpod

Set up a full Drupal dev environment in a browser

This project demonstrates a complete Drupal 9 development environment, utilizing ddev and Gitpod, through your browser.

Video Demo

Watch a 5 minutes walkthrough video:

Prerequisites:

1. Sign up for gitpod.io

Try it out:

1. Click on the following link https://gitpod.io/#https://github.com/shaal/ddev-gitpod
2. Your environment is being prepared, wait about 40 seconds (A splash screen will appear)
3. VScode (or Theia) IDE will be displayed.
4. Note that one terminal is running sudo docker-up, and another terminal in parallel is running ddev start
5. Find your website's URL gp url 8080
6. Open your website's URL in a browser, you should see Drupal's installation screen.
7. Run in terminal ddev drush si demo_umami -y
8. Open your website's URL in a browser, you should see Drupal's Umami demo.
9. Run in terminal ddev xdebug on
10. Open VScode's debugger, place a new breakpoint in web/index.php
11. Open your website's URL in a browser.
12. 🎉

Do you like PhpStorm instead of Theia or VScode?

1. Open a bash window at the bottom
2. .ddev/run-phpstorm.sh
3. When it shows you port 9999 is up, click the link and use PhpStorm with this repo.

How does it work?

1. Gitpod - development environment based on Docker
   1. .gitpod.yml
      1. Defines the main docker image this environment is built on - .gitpod.Dockerfile
      2. Run initial commands using 3 terminals in parallel:
         1. gitpod-setup-ddev.sh
         2. composer install
         3. sudo docker-up
   2. .gitpod.Dockerfile
      1. Set base image to Gitpod's workspace-full (link)
      2. Install ddev using brew
2. ddev - ridiculously simple setup for complex development environments
   1. .ddev/config.yaml - main ddev (default) configuration, can be generated by running ddev config
   2. .ddev/gitpod-setup-ddev.sh - generate config overrides for ddev to work in the Gitpod environment.
      1. Delete any existing Docker images and containers (due to Gitpod bug, that cause issues when restarting a workspace)
      2. Set certain ports to public, following Gitpod's syntax [port]-[workspace-url]
         1. 8080 - Drupal Website
         2. 8025 - Mailhog
         3. 8036 - PHPmyadmin
      3. Set host.docker.internal with the correct value of gitpod's host ip
      4. Starts ddev

Thank you

@rfay for your endless patience and relentless support that made this project possible.

Persistent Storage:

• Gitpod backs up the state of the /workspace/ folder between workspace starts, so that you can revisit them later. Attention: Files in other locations will not be saved!
• Additional Storage Solutions