Project scaffold base to start developing Drupal projects, modules and even core. The project scaffold sits on top Wodby's Docker4Drupal stack and Drupal Composer project.
To execute the scaffolding process, from your terminal run the following commands:
make setup
: collects configurarion and puts everything in place for the project.make onboard
: after setup is completed you must run this command to get your local environment ready to start the project.make install
: this will run the Drupal installation script, after it you will have fully functional Drupal site.make done
: this will terminate the scaffolding process, this command should be run ONLY if everything went well.
In case of errors in any point and you haven't execute the make done
command, you cand reset the whole process by running make clean
.
Most common tasks are explained below, also for each task a GNU/Make target is provided.
Make | Docker | Task |
---|---|---|
make onboard | - | Setup local environment |
make install | - | Install Drupal |
make [up:start] | docker-compose pull | Start stack |
docker-compose up -d --remove-orphans | ||
make [down:stop] | docker-compose stop | Stop stack |
make shell | docker-compose exec php sh | Enter PHP container |
make composer "COMMAND [PARAMS]" | docker-compose exec php "composer COMMAND [PARAMS] " | Execute Composer command |
make drush "COMMAND [PARAMS]" | docker-compose exec php "drush COMMAND [PARAMS] " | Execute Drush command |
make logs [SERVICE] | docker-compose logs [SERVICE] | Check service logs |
make prune [SERVICE] | docker-compose down -v [SERVICE] | Remove service (deleted all) |
The Drupal stack consist of the following containers:
Supported Drupal versions: 9
Images tags format is [VERSION]-[STABILITY_TAG]
where:
[VERSION]
is the version of an application (without patch version) running in a container, e.g. wodby/nginx:1.15-x.x.x
where Nginx version is 1.15
and x.x.x
is a stability tag. For some images we include both major and minor version like PHP 7.2
, for others we include only major like Redis 5
.
[STABILITY_TAG]
is the version of an image that corresponds to a git tag of the image repository, e.g. wodby/mariadb:10.2-3.3.8
has MariaDB 10.2
and stability tag 3.3.8
. New stability tags include patch updates for applications and image's fixes/improvements (new env vars, orchestration actions fixes, etc). Stability tag changes described in the corresponding a git tag description. Stability tags follow semantic versioning.
We highly encourage to use images only with stability tags.
We regularly update images used in this stack and release them together, see releases page for full changelog and update instructions. Most of routine updates for images and this project performed by the bot via scripts located at wodby/images.
- Read the docs on how to use
- Ask questions on Slack
- Follow @wodbycloud for future announcements