Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lcatlett/blt-ddev

ddev integration with Acquia BLT
https://github.com/lcatlett/blt-ddev

acquia blt blt-plugin ddev develop docker docker-compose drupal-8

Last synced: about 1 month ago
JSON representation

ddev integration with Acquia BLT

Awesome Lists containing this project

README

        

Acquia BLT integration with ddev
====

This is an [Acquia BLT](https://github.com/acquia/blt) plugin providing [ddev](https://ddev.readthedocs.io) integration.

This plugin is **community-created** and **community-supported**. Acquia does not provide any direct support for this software or provide any warranty as to its stability.

## Quickstart

To create a new BLT project with ddev integration for local development, run the following commands, replacing `mysite` with your desired BLT project name:

```
composer create-project --no-interaction --no-install drupal/recommended-project mysite
cd mysite
sudo sed -i '' -e "s|web/|docroot/|g" composer.json
composer require --dev lcatlett/blt-ddev
blt recipes:ddev --no-interaction
ddev blt setup
```

## Installation and usage

To use this plugin on your existing BLT 12 project, you must be using ddev [v1.10.0](https://github.com/drud/ddev/releases/tag/v1.10.0) or newer.

You can check your version of ddev with `ddev version`.

In your project, require the plugin with Composer:

`composer require --dev lcatlett/blt-ddev`

Initialize the ddev integration by calling `recipes:ddev`, which is a custom BLT command provided by this plugin:

`blt recipes:ddev`

Running `blt recipes:ddev` will initialize a .ddev folder as well as BLT configuration in the /blt directory of your project.

The plugin adds a custom ddev command in the web container which makes the `ddev blt` command available. **All blt commands should be prefixed with `ddev` to ensure it is executed within the docker container**, for example:

`ddev blt setup`

`ddev blt tests`

`ddev blt sync`

`ddev blt sync --environment=ci`

# BLT Enhancements

## Behat configuration

BLT makes some assumptions about the local development environment which informs behat testing configuration. This plugin extends the default `blt behat` command to run behat tests in a container as a dedicated service via the `ddev blt behat` command.