search

Metadrop / ddev-aljibe

DDEV Aljibe (ddev-aljibe) is an add-on for DDEV to develop Drupal projects with many tools included out-of-the-box
Apache License 2.0
6 stars 3 forks source link
aljibe ddev ddev-get drupal

readme

tests project is maintained GitHub Release

DDEV Aljibe

Aljibe (ddev-aljibe) is an add-on for DDEV for Drupal projects that adds several tools in a simple and fast way, leaving a new project ready for development in a few minutes.

Aljibe sits on top of DDEV and adds some containers, configuration and commands to make the development of Drupal projects faster and easier.

Included tools

Requirements

Starting a new project with Aljibe

Create a folder for your new project (e.g. mkdir my-new-project) Configure a basic ddev project:

ddev config --auto

Install the Aljibe addon. This will install all the dependant addons too:

ddev get metadrop/ddev-aljibe

Launch Aljibe Assistant. This will guide you throught the basic Drupal site instalation process:

ddev aljibe-assistant

You are ready! you will have a new Drupal project based on Aljibe ready for development!

Migrate legacy projects to DDEV Aljibe

To transform a legacy project to Ddev Aljibe, the following steps must be followed, always taking into account the particularities of each project:

  1. Clone the project without install it and remove all docker related files

  2. Run basic ddev-config:

    ddev config --auto

  3. Install Aljibe:

    ddev get metadrop/ddev-aljibe

  4. Run again ddev config, but this time go throught the assistant to set project type to Drupal, docroot folder, etc...

    ddev config

  5. Edit .ddev/config.yml to fine tune the environment.

  6. Edit .ddev/aljibe.yml to set deault site name (the folder inside sites) and all themes to be transpiled

  7. update .gitignore to look like this.

If you come from a boilerplate project:

Advanced Configuration

The aljibe.yml file allows you to customize various aspects of the Aljibe setup. Below are the available options and how to use them:

default_site

This option sets the default site name to be processed. It is used when no specific site name is provided.

default_site: self

theme_paths

This section allows you to define paths to custom themes that need to be processed. Each theme should be listed with a unique key.

theme_paths:
  custom_theme: /var/www/html/web/themes/custom/custom_theme

hooks

Hooks are commands that can be executed at different stages of the setup process. They are defined as lists of commands under various hook points.

Example:

hooks:
  pre_setup:
    - echo "Aljibe pre setup hook"
    - ddev snapshot
  post_setup:
    - echo "Aljibe post setup hook"
    - ddev drush uli --uid=2
  pre_site_install: []
  post_site_install: []
    - ddev @${SITE_ALIAS} drush cr
  pre_site_install_config: []
  post_site_install_config: []
  pre_site_install_db: []
  post_site_install_db: []

Available variables for site_install hooks are:

Available variables for setup hooks are:

In addition, all the variables provided by ddev are available on all hooks.

You can add any other configuration you need to the aljibe.yml file. This config can be obtained with the ddev aljibe-config command.

Example commands to obtain specific configurations:

Usage

Project setup in other machines

Once the project has been created and uploaded to version control, anyone else working with it can clone it and with the following command you can have the project ready to work with.

ddev setup [--all] [--no-install] [--no-themes]

Unique site install (Multisite)

If you have a multisite instalation, you can install only one site by running:

ddev site-install <site_name>

Create a secondary database

If you need to create a secondary database, you can run:

ddev create-database <db_name>

NOTE: This command will create a database accesible with the same user and password from the main one. If you want to persist this across multiples setups, you can add this command to te pre-setup hooks in .ddev/aljibe.yml file.

Launch behat tests

To launch local, or env tests, you can run:

ddev behat [local|pro|other_behat_folder] [suite]

Process custom themes CSS

By default there is one theme defined in .ddev/aljibe.yml. You can add multiple themes. To process them, run:

ddev frontend production [theme_name]

where theme_name is the key defined in .ddev/aljibe.yml. You can run a watch command to process the CSS on the fly:

ddev frontend watch [theme_name]

Sync solr config

If you use ddev-solr addon and need to sync the solr config from the server, you can run:

ddev solr-sync

Power off ddev

ddev poweroff

Troubleshooting

https not working

Follow ddev install recomendations. It is needed to install mkcert and libnss3-tools, and then run:

mkcert -install

Can't debug with NetBeans

Until https://github.com/apache/netbeans/issues/7562 is solved you need to create a file named xdebug.ini at .ddev/php with the following content:

[XDebug]
xdebug.idekey = netbeans-xdebug

NOTE: The netbeans-xdebug is the default Session ID value in the the Debugging tab in the PHP Netbeans' configuration dialog. If you have changed it do it in the xdebug.ini file as well.

Xdebug profiler does not save the files

Follow the instructions from ddev xprofiler documentation

[XDebug]
xdebug.mode=profile
xdebug.start_with_request=yes
# Set a ddev shared folder for the xprofile reports.
xdebug.output_dir=/var/www/html/tmp/xprofile
xdebug.profiler_output_name=trace.%c%p%r%u.out

Review the php info (/admin/reports/status/php) page to review that the xdebug variables are setup properly after run ddev xdebug on, restart the project if necessary.