What's the best practice for setting up Drupal CMS purely from the command line/CLI? Here's my flow - it is OK-ish?
I'm building a reproducible Drupal CMS 2.1 (Drupal 11) demo/starter/showcase project and I want the whole setup to live in the CLI and in git, no UI clicking. This is my current flow and I'd like to know where it diverges from best practice.
I work as a developer advocate for CKEditor and I need the boilerplate for my showcases/demos/workshops/...
Initial scaffold:
```sh ddev config --project-type=drupal11 --docroot=web ddev start ddev composer create-project drupal/cms # Initial installing of the packages mostly CKEditor pack + premium features, but it does not matter that much ``` Day-to-day setup (fresh clone):
This is mostly when I need to have a PR deployment/preview build/feature branch for specific event/or something similar.
I plan to use Render to have the PR-based deployments.
```sh ddev start ddev composer install ddev drush site:install --existing-config -y \ --account-name=admin --account-pass=admin ddev drush php:script scripts/import-demo-content.php ```sh Conventions I started with:
- ddev is optional, anything else is fine, I just saw it being used as kinda base
- All config changes go through
drush config:exportand get committed toconfig/sync, sosite:install --existing-configrebuilds the exact site. - Repeatable setup steps (text formats, module wiring) live as
drush php:scriptfiles inscripts/, not as one-off UI actions. - Demo content ships as a recipe (
recipes/<name>/contentYAML) and is imported with core's DefaultContent at build time, instead of committing a database dump. (I plan to use sqllite for these demos for simplicity). - Secrets and endpoints come only from env vars read in
settings.php, the file itself is committed.
Where it hurts/"not sure about" parts
drush site:install --existing-configcrashes in the installer's configure-form step ("Field user_picture is unknown") after config import already succeeded. A fresh bootstrap of the same DB is fine, so it looks like a stale field-map cache inside the installer process. I currently tolerate the exit code and finish the installer work (user 1, site name) via drush. Anyone hit this / know the issue number?drupal/core-recipe-unpackremoves recipes from composer.lock after unpacking, socomposer installcan't restore them and I have to commit the recipes directory. Is committing unpacked recipes the intended workflow?- Keeping license keys out of
config/sync: I inject all CKEditor Premium Features credentials (license key, and for the self-hosted stack the websocket + API URLs) as runtime$configoverrides from env vars insettings.php. Nothing is ever saved through the module's settings form, soconfig/syncstays secret-free. It works, but the admin form at/admin/config/ckeditor5-premium-features/settingsrenders completely empty, because Drupal forms only show stored config, not overrides. So the site is fully configured and the form says otherwise. Worse, if someone "helpfully" fills it in, those values get saved to the DB and either shadowed by the overrides or accidentally exported later. Is there an established pattern here: Key module support, a config_exclude approach, or modules showing an "overridden by settings.php" hint on the form? Or is an empty-but-overridden form just the accepted price of env-driven config?
How do you find it? Would you change something? Anything completely wrong?
[link] [comments]