Configuring Acquia BLT with Lando

Acquia BLT with Lando generally works as expected, but to achieve a better integration, add the following code to your .lando.yml file, and then rebuild the containers:

tooling:
  blt:
    service: appserver
cmd: /app/vendor/bin/blt

You can also update your BLT config (blt.yml) with the Lando host name syntax:

project:
  machine_name: abc
  prefix: ABC
  human_name: 'A website'
  profile:
    name: standard
  local:
    protocol: http
    hostname: ${project.machine_name}.lndo.site

Lando known issues

The Acquia BLT integration with Lando has the following known issues:

Missing Chrome driver

Depending on your Lando recipe, running lando blt tests:behat may display an error message about a missing Chrome driver. If you encounter this error message, add the driver installation to your Lando recipe.

Chrome timeouts

If you receive timeout error messages, try running the blt command with the -vvv option for more output (lando blt -vvv tests:behat). If you receive the following error messages, the issue is with the permissions on your container:

[Filesystem\FilesystemStack] mkdir ["/app/reports"]
[info] Killing running google-chrome processes...
[info] Killing all processes on port '9222'...
[info] Launching headless chrome...
[Robo\Common\ProcessExecutor] Running 'google-chrome' --headless --disable-web-security --remote-debugging-port=9222 http://localhost in /app
[info] Waiting for response from http://localhost:9222...
[debug] cURL error 7: Failed to connect to localhost port 9222: Connection refused (see http://curl.haxx.se/libcurl/c/libcurl-errors.html)
...
[info] Killing running google-chrome processes...
[info] Killing all processes on port '9222'...
[error] Timed out.
12.412s total time elapsed.

If you ssh in to Lando and then run the google-chrome command, the following output will be displayed:

$ google-chrome --headless --disable-web-security --remote-debugging-port=9222 http://localhost
Failed to move to new namespace: PID namespaces supported, Network
namespace supported, but failed: errno = Operation not permitted
Failed to generate minidump.Illegal instruction

The solution is to invoke the chrome command with the --no-sandbox option by patching your Acquia BLT installation. Patching your installation adds the --no-sandbox option to the `launchChrome() function in the Behat command.

Undefined index notices for $_SERVER keys

When running several Acquia BLT or Drush commands through Lando when initializing Acquia Cloud Site Factory, the following notices may display:

<em class="placeholder">Notice</em>: Undefined index: HTTP_HOST in <em class="placeholder">require()</em> (line <em class="placeholder">119</em> of <em class="placeholder">/app/vendor/acquia/blt/settings/blt.settings.php</em>). <pre class="backtrace">require(&#039;/app/vendor/acquia/blt/settings/blt.settings.php&#039;) (Line: 797)
require(&#039;/app/docroot/sites/default/settings.php&#039;) (Line: 122)
Drupal\Core\Site\Settings::initialize(&#039;/app/docroot&#039;, &#039;sites/default&#039;, Object) (Line: 1056)
Drupal\Core\DrupalKernel-&gt;initializeSettings(Object) (Line: 271)
Drupal\Core\DrupalKernel::createFromRequest(Object, Object, &#039;prod&#039;, 1) (Line: 172)
Drush\Boot\DrupalBoot8-&gt;bootstrapDrupalConfiguration(NULL) (Line: 295)
Drush\Boot\BootstrapManager-&gt;doBootstrap(3, 6, NULL) (Line: 504)
Drush\Boot\BootstrapManager-&gt;bootstrapMax() (Line: 224)
Drush\Application-&gt;bootstrapAndFind(&#039;csex&#039;) (Line: 191)
Drush\Application-&gt;find(&#039;csex&#039;) (Line: 229)
Symfony\Component\Console\Application-&gt;doRun(Object, Object) (Line: 148)
Symfony\Component\Console\Application-&gt;run(Object, Object) (Line: 112)
Drush\Runtime\Runtime-&gt;doRun(Array) (Line: 41)
Drush\Runtime\Runtime-&gt;run(Array) (Line: 66)
require(&#039;/app/vendor/drush/drush/drush.php&#039;) (Line: 17)
drush_main() (Line: 141)
require(&#039;phar:///usr/local/bin/drush/bin/drush.php&#039;) (Line: 10)
</pre>

Notice: Undefined index: argv in Symfony\Component\Console\Input\ArgvInput->__construct() (line 53 of /app/vendor/symfony/console/Input/ArgvInput.php).

Symfony\Component\Console\Input\ArgvInput->__construct(NULL) (Line: 113)
require('/app/vendor/acquia/blt/settings/blt.settings.php') (Line: 797)
require('/app/docroot/sites/default/settings.php') (Line: 122)
Drupal\Core\Site\Settings::initialize('/app/docroot', 'sites/default', Object) (Line: 1056)
Drupal\Core\DrupalKernel->initializeSettings(Object) (Line: 656)
Drupal\Core\DrupalKernel->handle(Object) (Line: 19)

Lando does not populate the $_SERVER['HTTP_HOST] and $_SERVER['argv'] variables. Beyond warnings and notices displayed on the screen, the impact is unknown.