README.md

Wunder template for Drupal projects - Recipes edition

This project template is an opinionated fork of the popular Drupal-composer template, configured to automatically deploy code to a Kubernetes cluster using CircleCI. Everything that works with the Drupal-composer project template will work with this repository, so we won't duplicate the documentation here.

DRUPAL recipes testing grounds

In this forked repository, we are experimenting with Drupal Recipes, which is a new way to share reusable configuration across Drupal sites, as part of the Distributions and recipes core initiative.

Check the README.md file in the /recipes directory for more information.

Getting started

• Click "Use this template" to generate a new project,
  • select the correct owner,
  • name the project as client-COUNTRYCODE-CLIENT-PROJECT,
  • make the repository private (unless the project is public).
• Clone the new project locally and modify it's details:
  • composer.json name,
  • silta/silta.yml values.
• Log in to CircleCI using your Github account and add the new project using existing config.

For additional instructions, please see the Silta documentation.

Main environment

• URL: https://main.drupal-project.dev.wdr.io
• Drush alias: drush @main st
• SSH: ssh www-admin@main-shell.drupal-project -J www-admin@ssh.dev.wdr.io

Drush alias for current Silta feature branch deployment is drush @current st.

Local environment

• Appserver: https://drupal-project.lndo.site
• Elasticsearch: http://localhost:9200, http://elasticsearch.lndo.site
• Kibana: http://localhost:5601, http://kibana.lndo.site
• Mailhog: http://mail.lndo.site
• Drush alias: lando drush @local st
• SSH: lando ssh (-s <service>)

Setup

1. Install the latest Lando and read the documentation.
2. Update your project name and other Lando Drupal 9 recipe's parameters at .lando.yml.
3. Run lando start.

Services

• chrome - uses selenium/standalone-chrome image, uncomment the service definition at .lando.yml to enable.
• elasticsearch - uses official Elasticsearch image, uncomment the service definition at .lando.yml to enable. Requires at least 4GiB of memory.
• kibana - uses official Kibana image, uncomment the service definition at .lando.yml to enable.
• mailhog - uses Lando MailHog service.
• node - uses Lando Node service.

Tools

• lando - tools / commands overview.
• lando grumphp <commands> - run GrumPHP code quality checks. Modified or new files are checked on git commit, see more at lando grumphp -h or wunderio/code-quality.
• lando npm <commands> - run npm commands.
• lando phpunit <commands> - run PHPUnit commands.
• lando xdebug <mode> - load Xdebug in the selected mode(s).

Drupal development hints

• Updating Drupal core.
• Altering scaffold files (robots.txt, .htaccess etc.).

Running tests

The PHPUnit test framework is predefined in this project, see phpunit.xml for details. Also, there is a minified web/modules/custom/phpunit_example module included from examples module for learning purposes.

Testing examples

Use lando phpunit to run the PHPUnit commands.

• run one test class: lando phpunit path/to/your/class/file.php,
• list groups: lando phpunit --list-groups,
• run all the tests in a particular group: lando phpunit --group Groupname.