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

• Host: GitHub
• URL: https://github.com/lcatlett/blt-ddev
• Owner: lcatlett
• Created: 2019-08-25T04:42:48.000Z (over 5 years ago)
• Default Branch: 1.x
• Last Pushed: 2023-12-28T02:02:13.000Z (12 months ago)
• Last Synced: 2024-11-04T13:37:36.311Z (about 2 months ago)
• Topics: acquia, blt, blt-plugin, ddev, develop, docker, docker-compose, drupal-8
• Language: PHP
• Size: 25.4 KB
• Stars: 17
• Watchers: 3
• Forks: 11
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ddev - Acquia BLT integration with ddev

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.