thegbomb / blt-ddev
ddev integration for Acquia BLT
Requires
- acquia/blt: ^12 || ^13
- acquia/blt-behat: ^1.4
This package is auto-updated.
Last update: 2024-04-27 15:26:09 UTC
README
This is an Acquia BLT plugin providing ddev 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. This has been forked from https://github.com/lcatlett/blt-ddev and updated to keep it installing.
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
sed -i '' -e "s|web/|docroot/|g" composer.json
composer require --dev thegbomb/blt-ddev
./vendor/bin/blt recipes:ddev --no-interaction
ddev blt setup
Installation and usage
To use this plugin on your existing BLT 13 project, you must be using ddev 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 thegbomb/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.