Skip to content
This repository has been archived by the owner on Dec 1, 2018. It is now read-only.

Commit

Permalink
Renamed to DDE
Browse files Browse the repository at this point in the history
  • Loading branch information
lmakarov committed Oct 24, 2016
1 parent 11de366 commit 943d78c
Show file tree
Hide file tree
Showing 11 changed files with 45 additions and 45 deletions.
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Drude (**Dru**pal **D**ocker **E**nvironment)
# DDE (**D**rupal **D**ocker **E**nvironment)

Docker and Docker Compose based environment for Drupal.

Expand All @@ -10,7 +10,7 @@ Existing users are advised to switch to Docksal.
--------------------------------------------------------------------------


**For a fully working example of Drude setup take a look at:**
**For a fully working example of DDE setup take a look at:**
- [Drupal 7 sample project](https://github.com/blinkreaction/drude-d7-testing)
- [Drupal 8 sample project](https://github.com/blinkreaction/drude-d8-testing)

Expand All @@ -23,11 +23,11 @@ Please review [system requirements](/docs/system-requirements.md) before proceed
<a name="setup"></a>
## Setup

1. [Drude environment setup](/docs/drude-env-setup.md)
1. [DDE environment setup](/docs/dde-env-setup.md)

This is done **one time per host** and should be performed by everyone.

2. [Configure a project to use Drude](/docs/drude-project-setup.md)
2. [Configure a project to use DDE](/docs/dde-project-setup.md)

This is done **one time per project** and should be performed by the project TL.

Expand Down Expand Up @@ -56,9 +56,9 @@ dsh init


<a name="dsh"></a>
## Drude Shell Helper (dsh)
## DDE Shell Helper (dsh)

Drude shell helper is a console tool that simplifies day-to-day work with Drude.
DDE shell helper is a console tool that simplifies day-to-day work with DDE.
It provides a set of most commonly used commands and operations for controlling the Boot2docker VM, containers, running drush or other commands inside the **cli** container. (**Note**: dsh requires cli container to function properly)

See `dsh help` for a complete list.
Expand Down
2 changes: 1 addition & 1 deletion docs/apache-solr.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Enabling Apache Solr service

## Drude configuration
## DDE configuration

1. Add Apache Solr service to `docker-compose.yml`:

Expand Down
28 changes: 14 additions & 14 deletions docs/behat.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Expected folder structure

Drude expects your Behat tests to be in `tests/behat` folder of the project repo.
DDE expects your Behat tests to be in `tests/behat` folder of the project repo.

> tests/behat
> \_ bin/behat
Expand All @@ -18,26 +18,26 @@ Assuming you are using [Behat Drupal Extension](https://github.com/jhedstrom/dru

```yml
# Docker profile.
# For use inside the CLI container in Drude.
# For use inside the CLI container in DDE.
docker:
extensions:
Behat\MinkExtension:
# URL of the site when accessed inside Drude.
# URL of the site when accessed inside DDE.
base_url: http://hello-world.drude
selenium2:
wd_host: http://browser.hello-world.docker:4444/wd/hub
# Stick with chrome by default. It's 2x faster than firefox or phantomjs (your results may vary).
browser_name: chrome
Drupal\DrupalExtension:
drupal:
# Site docroot inside Drude.
# Site docroot inside DDE.
drupal_root: /var/www/docroot
drush:
# Site docroot inside Drude.
# Site docroot inside DDE.
root: /var/www/docroot
```
This will configure Behat for use with Drude.
This will configure Behat for use with DDE.
**Important note**
Expand All @@ -47,7 +47,7 @@ in the web container definition and `DOMAIN_NAME` in the browser container defin

## Running tests

Tests can be launched with `dsh` (Drude Shell):
Tests can be launched with `dsh` (DDE Shell):

dsh behat

Expand Down Expand Up @@ -88,22 +88,22 @@ Example:

```yml
# Docker profile.
# For use inside the CLI container in Drude.
# For use inside the CLI container in DDE.
docker:
extensions:
Behat\MinkExtension:
# URL of the site when accessed inside Drude.
# URL of the site when accessed inside DDE.
base_url: http://drupal7.drude
selenium2:
wd_host: http://drude3-d7-testing.browser.docker:4444/wd/hub
# Stick with chrome by default. It's 2x faster than firefox or phantomjs (your results may vary).
browser_name: chrome
Drupal\DrupalExtension:
drupal:
# Site docroot inside Drude.
# Site docroot inside DDE.
drupal_root: /var/www/docroot
drush:
# Site docroot inside Drude.
# Site docroot inside DDE.
root: /var/www/docroot
```

Expand Down Expand Up @@ -236,7 +236,7 @@ On this step you can see an error:

In this case check Drupal `settings.php`. Please don't use variables for DB settings:
```PHP
# Drude DB connection settings.
# DDE DB connection settings.
$databases['default']['default'] = array (
'database' => getenv('DB_1_ENV_MYSQL_DATABASE'),
'username' => getenv('DB_1_ENV_MYSQL_USER'),
Expand All @@ -249,7 +249,7 @@ $databases['default']['default'] = array (
Use only values - something like this:

```PHP
# Drude DB connection settings.
# DDE DB connection settings.
$databases['default']['default'] = array (
'database' => 'drupal',
'username' => 'drupal',
Expand Down Expand Up @@ -288,7 +288,7 @@ default:
...
```

`192.168.10.1` is your machine's IP in Drude subnet.
`192.168.10.1` is your machine's IP in DDE subnet.

If you use host selinium driver, please don't use selenium2 node - check and comment `browser` container config in your docker-compose.yml file:

Expand Down
4 changes: 2 additions & 2 deletions docs/db-access.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# MySQL DB access for external tools

MySQL port is not exposed in the `db` container by default.
This is done to avoid port conflicts if running multiple Drude powered projects (multisites don't count).
This is done to avoid port conflicts if running multiple DDE powered projects (multisites don't count).

Add the following lines in the `db` service definition in `docker-compose.yml` to make port **3306** exposed:

Expand All @@ -13,7 +13,7 @@ Run `dsh up`.
You will now be able to connect to MySQL in the db container on `192.168.10.10:3306`

Please keep in mind that two db containers will not be able to use the same port (`3306`) on the host.
To avoid port conflicts with multiple Drude powered projects give each project a unique port assignments.
To avoid port conflicts with multiple DDE powered projects give each project a unique port assignments.

**Project 1**

Expand Down
10 changes: 5 additions & 5 deletions docs/drude-env-setup.md → docs/dde-env-setup.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Drude environment setup
# DDE environment setup

**This is a one time setup.**
Once you have a working Drude environment in place, you can use it for all Drude powered projects.
Once you have a working DDE environment in place, you can use it for all DDE powered projects.

## Directory structure

Drude expects a particular [directory structure](/docs/directory-structure.md).
DDE expects a particular [directory structure](/docs/directory-structure.md).
Please review it before proceeding with the setup.

## Windows only
Expand All @@ -19,7 +19,7 @@ Babun should be installed and run **as a regular user (do not use admin command

## Setup

1. Install `dsh` (Drude Shell)
1. Install `dsh` (DDE Shell)

```
sudo curl -L https://raw.githubusercontent.com/blinkreaction/drude/master/bin/dsh -o /usr/local/bin/dsh
Expand All @@ -42,7 +42,7 @@ Babun should be installed and run **as a regular user (do not use admin command
cd /c/projects
```

3. Install Drude's prerequisites
3. Install DDE's prerequisites

Mac and Windows: virtualbox, vagrant, boot2docker-vagrant
Linux: docker, docker-compose
Expand Down
12 changes: 6 additions & 6 deletions docs/drude-project-setup.md → docs/dde-project-setup.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# Configure a project to use Drude
# Configure a project to use DDE

Initial configuration is done once per project (e.g. by a team lead) and committed into the project repo.

`docker-compose.yml` file and an optional `.drude` folder are good indicators that a project is using Drude.
`docker-compose.yml` file and an optional `.drude` folder are good indicators that a project is using DDE.

**On Windows** make sure your `projects` folder is **not** inside `%USERPROFILE%/.babun` folder.

## Setup

1. Edit `settings.php` for your site (see [Drupal settings](/docs/drupal-settings.md)).
2. Open console (Babun on Windows) and cd into `<projects/your-drupal-site>`.
3. Install default Drude configuration file (downloads the latest `docker-compose.yml`):
3. Install default DDE configuration file (downloads the latest `docker-compose.yml`):

```
dsh install drude-config
```

4. Update `docker-compose.yml` as necessary.

5. Start Drude with:
5. Start DDE with:

```
dsh up
Expand All @@ -31,13 +31,13 @@ This is optional, but highly recommended.
Site provisioning can be automated via a [custom command](custom-commands.md).
E.g. `dsh init` will call `.drude/commands/init`, where you can put project specific initialization tasks like:

- initialize Drude configuration
- initialize DDE configuration
- import database or perform a site install
- compile sass
- run update, revert features, clear caches, etc.
- enable/disable modules, update variable values
- run Behat tests

For a fully working example of a Drude powered project (including `dsh init`) take a look at:
For a fully working example of a DDE powered project (including `dsh init`) take a look at:
- [Drupal 7 sample project](https://github.com/blinkreaction/drude-d7-testing)
- [Drupal 8 sample project](https://github.com/blinkreaction/drude-d8-testing)
2 changes: 1 addition & 1 deletion docs/directory-structure.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Directory structure

Drude enforces a directory structure where all your projects go into subfolders under the main `<projects>` folder.
DDE enforces a directory structure where all your projects go into subfolders under the main `<projects>` folder.
The `<projects>` folder can be arbitrarily located and named. It is best to put it on the fastest drive you have.

`dsh` will install the necessary boot2docker-vagrant VM files (`Vagrantfile` and `vagrant.yml`) into the `<projects>` folder.
Expand Down
8 changes: 4 additions & 4 deletions docs/drupal-settings.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Drupal settings

Below you will find instructions on configuring you Drupal project to work with Drude.
Below you will find instructions on configuring you Drupal project to work with DDE.
Some settings are required, others are optional or enahncements. Please review carefully.

<a name="db"></a>
Expand All @@ -14,7 +14,7 @@ If you change the DB node name in `docker-compose.yml` (e.g. `mysql` instead of
**Drupal 7 and 8**

```php
# Drude DB connection settings.
# DDE DB connection settings.
$databases['default']['default'] = array (
'database' => getenv('DB_1_ENV_MYSQL_DATABASE'),
'username' => getenv('DB_1_ENV_MYSQL_USER'),
Expand Down Expand Up @@ -60,7 +60,7 @@ you are most likely using it's vhost-proxy. In that case add the following to se
**Drupal 7**

```php
# Reverse proxy configuration (Drude's vhost-proxy)
# Reverse proxy configuration (DDE's vhost-proxy)
$conf['reverse_proxy'] = TRUE;
$conf['reverse_proxy_addresses'] = array($_SERVER['REMOTE_ADDR']);
// HTTPS behind reverse-proxy
Expand All @@ -77,7 +77,7 @@ if (
**Drupal 8**

```php
# Reverse proxy configuration (Drude's vhost-proxy)
# Reverse proxy configuration (DDE's vhost-proxy)
$settings['reverse_proxy'] = TRUE;
$settings['reverse_proxy_addresses'] = array($_SERVER['REMOTE_ADDR']);
// HTTPS behind reverse-proxy
Expand Down
2 changes: 1 addition & 1 deletion docs/phpcs.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Using PHP Code Sniffer with Drude
# Using PHP Code Sniffer with DDE

phpcs and phpcbf are readily available in up-to-date version of cli container.

Expand Down
8 changes: 4 additions & 4 deletions docs/system-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@

**8GB** (16GB if you keep lost of apps running) for a comfortable work experience.

It is possible to use Drude with less than 8GB of RAM (e.g. 4GB), however not recommended.
It is possible to use DDE with less than 8GB of RAM (e.g. 4GB), however not recommended.

The amount of RAM Drude reserves is configurable via the `vagrant.yml` file (2GB by default).
The amount of RAM DDE reserves is configurable via the `vagrant.yml` file (2GB by default).
You can lower it to 1GB if your host computer runs low on memory.
Please understand that this will be the amount of RAM available to the application stack and sites running on it.

Expand All @@ -20,11 +20,11 @@ Your CPU should support hardware **VT-x/AMD-V virtualization** (most modern CPUs

While Docker is supported natively on Linux, Mac and Windows users will need a tiny Linux VM layer to be able to run Docker containers.

Drude relies on the following components for Docker support on Mac and Windows:
DDE relies on the following components for Docker support on Mac and Windows:

- [VirtualBox](https://www.virtualbox.org) 5.0+
- [Vagrant](https://www.vagrantup.com) 1.7.3+
- [Boot2docker Vagrant Box](https://github.com/blinkreaction/boot2docker-vagrant) v1.3.1+

**You do not have to install these components manually as Drude automates this for you.**
**You do not have to install these components manually as DDE automates this for you.**
Please refer to the [setup instructions](/README.md#setup) for further steps.
2 changes: 1 addition & 1 deletion docs/xdebug.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Debugging with Drude, Xdebug and PhpStorm
# Debugging with DDE, Xdebug and PhpStorm

`xdebug` extension is disabled by default as it causes about 20% performance hit.

Expand Down

0 comments on commit 943d78c

Please sign in to comment.