diff --git a/docs/composer/library/traefik/index.md b/docs/composer/library/traefik/index.md index be2abc18fdcd9c4d648c0282ede3edbdf88fdac9..4a5d27864f5b0e243db541714a8bb4b9b5a57114 100644 --- a/docs/composer/library/traefik/index.md +++ b/docs/composer/library/traefik/index.md @@ -7,6 +7,15 @@ tags: --- # Docker Traefik -to be done. +[Traefik](https://traefik.io/) is one of our most important tool. We provide this library here +to set up all network related communication in our environments. -[Traefik dashboard](http://traefik.docker.localhost:8000/dashboard/) +A `Traefik` network is always running, if not see [here](../../../docker/l3d/index.md#traefik-network). + +You can define [L3D](../../../docker/l3d/index.md) projects running in +parallel [managed by Traefik](../../../docker/l3d/drupal.md#working-with-multiple-projects-in-parallel). + +See the dashboard: `http(s)://traefik.<your-root.domain>/dashboard`. Here you have a great overview of all +routers, services and middlewares: + + diff --git a/docs/dev_tools/debug.md b/docs/dev_tools/debug.md index e668173ac2e3548ed64b5155428ee45e8e7cf93c..a05ecf1bfcd7905f368b4f2c93c91237bf9e9678 100644 --- a/docs/dev_tools/debug.md +++ b/docs/dev_tools/debug.md @@ -7,6 +7,20 @@ tags: # Debugging Drupal Code +Debugging PHP can be a game changer in Drupal development. In the context of L3D +in combination with the composer plugin [Docker4Drupal](/composer/plugin/d4d) +this is provided out of the box and configured very easily. We describe the +steps for PhpStorm, but other IDEs should be very similar. + +As XDebug comes with a performance hit, it is turned off by default. When you +need it, simply call `ahoy debug on` in you L3D container of the project you +want to debug and the scripts will reconfigure the PHP container and refresh +it with a few seconds. When you've finished debugging, you may want to turn it +off again with `ahoy debug off`. + +XDebug version 3 connects to port 9003 of your IDE and PhpStorm is preconfigured +by default to list on that port. + ## Add a PHP Server First, you have to set up a Drupal environment with the tool [l3d](../docker/l3d/index.md). The tool is diff --git a/docs/dev_tools/host.md b/docs/dev_tools/host.md index e52ac1c261610eb16ace342860d5942f92d0def5..6a5754b373cc13f1173e130312d39b8660993312 100644 --- a/docs/dev_tools/host.md +++ b/docs/dev_tools/host.md @@ -32,28 +32,31 @@ DOCKER_IMAGE_PREFIX= DORGFLOW=0 DRUPAL_LIVE=0 GITLAB_PRIVATE_TOKEN= -GITLAB_URL= +GITLAB_URL=https://gitlab.lakedrops.com LOCAL_IP=1 -MAILHOG_HOST=smtp.freesmtpservers.com -MAILHOG_MECHANISM=NONE +MAILHOG_HOST=smtprelaypool.ispgateway.de +MAILHOG_MECHANISM=PLAIN MAILHOG_PASSWORD= MAILHOG_PORT=25 -MAILHOG_USERNAME= -MAILPIT_HOST=smtp.freesmtpservers.com -MAILPIT_PORT=25 -MAILPIT_USERNAME= +MAILHOG_USERNAME=support@lakedrops.com +MAILPIT_HOST=smtprelaypool.ispgateway.de +MAILPIT_PORT=587 +MAILPIT_USERNAME=support@lakedrops.com MAILPIT_PASSWORD= -MAILPIT_STARTTLS= -MAILPIT_ALLOW_INSECURE= -MAILPIT_AUTH=none +MAILPIT_STARTTLS=true +MAILPIT_ALLOW_INSECURE=true +MAILPIT_AUTH=plain MAILPIT_SECRET= MAILPIT_RETURNPATH= MAILPIT_RECIPIENT_ALLOW_LIST= +NODE_VERSION=18-slim PHP_COVERAGE=0 PHP_DEBUG=0 +PHP_PROFILER=0 PHP_VERSION=8.1 -UNLIGHTHOUSE=0 WEBSERVER_CONFIG_OVERWRITE=0 +UNLIGHTHOUSE=0 +RENDERER_CONFIG_DEBUG=0 ``` ### ~/.gitconfig diff --git a/docs/docker/l3d/drupal.md b/docs/docker/l3d/drupal.md index 9d60a09770f2a18aa139676334d6f247d1ad78c7..5933f3bd5f3ee9eb0aa78c092b067faa3e9ee5e7 100644 --- a/docs/docker/l3d/drupal.md +++ b/docs/docker/l3d/drupal.md @@ -216,36 +216,6 @@ DOCKER4DRUPAL_TRAEFIK_KEY=privkey.pem Note: every 2 months you will have to renew the SSL cert with LetsEncrypt by calling `certbot renew` and then copying the new cert files into the same directory ad described above and then restart Traefik. -## Using XDebug - -Debugging PHP can be a game changer in Drupal development. In the context of L3D -in combination with the composer plugin [Docker4Drupal](/composer/plugin/d4d) -this is provided out of the box and configured very easily. We describe the -steps for PhpStorm, but other IDEs should be very similar. - -As XDebug comes with a performance hit, it is turned off by default. When you -need it, simply call `ahoy debug on` in you L3D container of the project you -want to debug and the scripts will reconfigure the PHP container and refresh -it with a few seconds. When you've finished debugging, you may want to turn it -off again with `ahoy debug off`. - -XDebug version 3 connects to port 9003 of your IDE and PhpStorm is preconfigured -by default to list on that port. - -You can then just enable debugging in PhpStorm and wait for the first request -which will prompt you to configure the details. Or you configure actively the -debug configuration: - - - -The name and the server name should both be called `Docker`. And the mapping -needs to be configured from your project root directory on your host to the -path `/var/www/html` in the container. - -With this setup, you can debug both web requests coming from the browser and -CLI commands for PHP which is executed inside the PHP container like e.g. -drush - all with the same setup. - ## Using MailPit When using the [Docker4Drupal](../../composer/plugin/d4d/index.md), a MailPit service will be configured automatically by default. diff --git a/docs/files/screenshots/traefik_dashboard_screenshot.png b/docs/files/screenshots/traefik_dashboard_screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..d599da284c960451ed5d7b3b2a1fa7aaba3f99f7 --- /dev/null +++ b/docs/files/screenshots/traefik_dashboard_screenshot.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1b562832a6911f485f32441dfa901ac8500fa76e8d49c8d940428ef1ba173611 +size 105291