From a1dbe56eef6b230d625b8f42337cd3f4e6956dbe Mon Sep 17 00:00:00 2001 From: Chris Thompson Date: Tue, 21 Jul 2020 22:40:35 -0400 Subject: [PATCH] Expand things slightly --- tools/creating-new-drutopia-site.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/tools/creating-new-drutopia-site.md b/tools/creating-new-drutopia-site.md index e6951b9..90520d2 100644 --- a/tools/creating-new-drutopia-site.md +++ b/tools/creating-new-drutopia-site.md @@ -1,6 +1,6 @@ # Deploying Drutopia Sites -Agaric manages a large number of Drupal, primarily [Drutopia](https://drutopia.org/) sites, on a +Agaric manages a large number of Drupal, primarily [Drutopia](https://drutopia.org/) sites. Please see [the Drutopia Platform README for an overview of hosting and deploying Drutopia sites](https://gitlab.com/drutopia-platform/drutopia_host#introduction ) If you won't be deploying, skip overall setup. @@ -56,13 +56,13 @@ ddev composer install Webserver, PHP, and MySQL versions and types are selected here to match those used on Elizabeth and should be adjusted to match your live environment, including double-checking that they are still valid for `elizabeth.mayfirst.org`. Please update this documentation if it changes! The last two options (enabling Xdebug by default and not using DNS for your local site) are optional at the developer's preference. Additional ddev options can be found at https://ddev.readthedocs.io/en/latest/users/cli-usage/ ``` -## Acquiring a database and configuration for the live instance +## Setting up database and configuration for the live instance -In order to get a configuration that has the proper site key, it is easiest to first deploy the site to the production location, and sync that database locally. +In order to get a configuration that has the proper site key, it is easiest to first deploy the site to the eventual live location, and sync that database locally. If you are creating a specialized build of Drutopia, you will have to add that to the host vars, and build that prior to deploying the site. `ahoy vars-edit` and `ahoy deploy-build ` are used for this. Note that new builds should be added ONLY as absolutely required. Configuration, and themes should be leveraged as much as possible prior to resorting to a new build. If additional/different modules are required, a new build is required - do *NOT* add them to build_source except when they are known to be required for *ALL* Drutopia basic sites. -Create a new site (member entry) per instructions in Drutopia hosting, and use `ahoy deploy-site ` to deploy it. This should install the site, when one is not present. +Create a new site (member entry) per instructions in Drutopia hosting. The simplest method is to use `ahoy new-site ` and follow it's output to get started. Then use `ahoy deploy-site ` to deploy one. ### Configure drush aliases @@ -94,7 +94,7 @@ This will create a self.site.yml using the expected pattern of "site_name_INSTAN ### Syncing, and setting up configuration -Drutopia releases will expect the configuration in `$project_root/config/sync`. Be sure to set the appropriate variable in `settings.php` for it to be stored/retrieved from there: +Drutopia releases will expect the configuration in `$project_root/config/sync`. Be sure to set the appropriate variable in `settings.php` for it to be stored/retrieved from there. Note not to use `settings.ddev.php`, as this will be generated during `ddev start`: ``` $settings['config_sync_directory'] = '../config/sync';