project:init fails to generate DB env vars for custom service names (e.g. "mariadb"), breaking Drupal Stacks guide

[AnupamKhosla]

Priority

2 - Important - inaccurate info needs to be corrected to prevent customer issues

Where should the changes be made?

I am building a Drupal 11 site following the official Upsun Drupal documentation. The documentation relies entirely on the upsun project:init command to generate a .environment file that maps PLATFORM_RELATIONSHIPS to standard shell variables (DB_SCHEME, DB_HOST, etc.) for Drupal's use.

The project:init command gives .environment file:

export DATABASE_URL="${DB_SCHEME}://${DB_USERNAME}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_PATH}"

but it completely fails to generate the definition/parsing logic for these variables.

As a result, DB_SCHEME and other variables remain empty, DATABASE_URL is malformed, and Drupal crashes with "Driver not specified".

Documentation Links:

• Current Docs (Broken Flow): https://docs.upsun.com/get-started/stacks/drupal.html
  • Relies entirely on the shell script generation which is currently buggy for custom service names.
  • Does not mention installing platformsh/config-reader.
• Old/Alternative Docs (Working Flow): https://fixed.docs.upsun.com/guides/drupal/deploy/customize.html#install-the-config-reader
  • Explicitly advises installing platformsh/config-reader.
  • This library handles the JSON parsing correctly regardless of the service name.

What exactly should be updated?

The new docs https://docs.upsun.com/get-started/stacks/drupal.html should be updated to clarify platformsh/config-reader usage or fix the init command to generate correct .environment logic

Optional: Additional context

No response