drupalpod's Introduction

DrupalPod

👉 Start here 1. Download the DrupalPod browser extension Chrome or Firefox. 2. Go to any issue page on Drupal.org (core, module, or theme). 3. Click on the DrupalPod extension. 4. (Optional) Choose a patch / issue fork / branch. 🎉 A full Drupal development environment is being generated for you 🎉 Please submit feedback, bug reports and feature requests

About the project

This project allows you to work on Drupal contributions with a familiar setup of a "normal" Drupal website.
No computer is needed because it is all running in the cloud.

Install additional packages - ddev composer
Run Drush commands - ddev drush <command>
Run tests
- Nightwatch - ddev nightwatch <arguments>
- PHPUnit - ddev phpunit <arguments>
IDE in a browser
- VScode (default)
- PHPStorm - run phpstorm

Project structure

Every project is cloned into /repos/<project_name>
Required by composer
Symlinked into a normal Drupal website structure:
- Core directory /web/core
- Module directory /web/modules/contrib/module_name
- Theme directory /web/themes/contrib/theme_name

The secret sauce

Gitpod - development environment in the cloud
DDEV - easy setup for PHP projects using Docker
DrupalPod Browser Extension
Drupal Core Development Project

Pushing code

* In order to push code, a one time SSH keys setup is required.

From within a Gitpod workspace run:

.gitpod/drupal/ssh/02-setup-private-ssh.sh
Follow the instructions on the screen.
.gitpod/drupal/ssh/04-confirm-ssh-setup.sh
If SSH keys are valid, it stores your private SSH key as an environment variable in Gitpod.

Notes

Manual SSH setup is a temporary requirement until the Drupal's self-hosted Gitlab gets integrated with Gitpod.

WIP - making a friendlier interactive dialog.
If you prefer working locally - you can clone this repo to your computer.
The only 2 requirements are Docker and DDEV.