Project description

This project template includes Drupal 9, Drush 10, Composer installations for Drupal recommended Project and which can be used to develop, stage or put into production Drupal 9 project.

Also included are drush/config-extra and other utilities for CI/CD in terms of a Drupal project - site updates, database schema updates, database backups, push of databases via git, backup of files, replication of production environments and much more.

This is a terminal built environment based on the minimal install profile and the ./drush site:install minimal command.

The thought behind this approach is to prepare the environment and tools needed to always be running an updated system with a modern proactive approach. The main goal is to have a fully automated production ready installation. Thus this project includes no modules, dependencies or themes not needed for the project beforehand, making it more manageable and minimal in terms of maintenance.

Development

Run with Docker

For development purposes this project can be started with:

$ docker-compose up -d

Drupal 9 will be available via localhost:9998

phpMyAdmin for development purposes will be available via localhost:9999

Basic site configuration

Rename your project or set your frontpage url:

• go to your basic settings page via GUI
• fill in the field "Default front page" with /node
• visit the frontpage

Fix file and cache permissions:

$ chmod 777 -R web/sites/default/files

Using Composer

Composer dependencies

To install modules or other dependencies strictly use Composer. Installed dependencies are locked to specific versions using the composer.lock file. composer install will install every package specified in composer.json with respect to the pinned versions in composer.lock.

Adding dependencies

Use composer require to add and install new packages. Alternatively add the requirement to composer.json and run composer install.

 $ docker-compose exec -T drupal composer require "vendor/package:2.*"

Updating dependencies

When a version update is needed, use composer update vendor/package.

$ docker-compose exec -T drupal composer update vendor/package

On first run, the composer.lock file was generated using composer update without further parameters.

Using Drush

Run Drush commands using - this command provides a full list of useful Drush commands:

$ docker-compose exec -T drupal ./drush

Full list of commands in Drush 9.