From acc0d8a30984a78cdc99aeeadb1e4f6efb13ffff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Benjamin=20Melan=C3=A7on?= <ben@agaric.coop>
Date: Mon, 21 Feb 2022 11:46:27 -0500
Subject: [PATCH] Add deploying drutopia sites to contents and begin expanding

---
 index.md                            |  1 +
 tools/deploying-drutopia-updates.md | 41 +++++++++++++++++++++++++----
 2 files changed, 37 insertions(+), 5 deletions(-)

diff --git a/index.md b/index.md
index 2f7f6e1..460affc 100644
--- a/index.md
+++ b/index.md
@@ -48,6 +48,7 @@ tools/git-setup
 tools/setting-up-nextcloud
 tools/setting-up-email
 tools/creating-new-drutopia-site
+tools/deploying-drutopia-updates
 tools/ddev-local-development-environment
 tools/drutopia-member-server-access
 ```
diff --git a/tools/deploying-drutopia-updates.md b/tools/deploying-drutopia-updates.md
index 5ff9916..b46bc0a 100644
--- a/tools/deploying-drutopia-updates.md
+++ b/tools/deploying-drutopia-updates.md
@@ -2,17 +2,15 @@
 
 ## Prerequsites
 
-Note that this is sort of 
+A bit more PHP than you need, but this will definitely get you ready for composer and friends:
 
 ```bash
 sudo apt-get install ansible rsync php7.4 php7.4-gd php7.4-mysql php7.4-xml php7.4-curl php7.4-fpm php7.4-sqlite3 php7.4-cli
 ```
 
-(Yeah that's more PHP than you need.)
+Then follow the commands from:
 
-The commands from:
-
-https://getcomposer.org/download/
+[getcomposer.org/download](https://getcomposer.org/download/)
 
 And then:
 
@@ -20,11 +18,44 @@ And then:
 sudo mv composer.phar /usr/local/bin/composer
 ```
 
+To make working with [Drutopia Platform's recommended Ansible setup](https://gitlab.com/drutopia-platform/drutopia_host#introduction) easier (and for the following instructions to work), install Ahoy per its instructions:
+
+[github.com/ahoy-cli/ahoy](https://github.com/ahoy-cli/ahoy)
+
+Finally, [clone needed Drutopia repositories locally according to the recommended setup](creating-new-drutopia-site#overall-setup).
+
+Now you are ready for deploying Drutopia updates on a regular basis.
+
+## Ensure you are up-to-date
+
 ```bash
 cd ~/Projects/drutopia-platform/drutopia_host/hosting_private
 ahoy git-pull-all
 ```
 
+```
+ahoy new-site example
+```
+
+And, following the instructions that provides, copy the 
+
+```
+ansible-vault edit host_vars/elizabeth.mayfirst.org/vault.yml
+```
+
+## Prepare appropriate base
+
+```
+ahoy deploy-build next
+```
+
+## Deploy your site
+
+```
+ahoy deploy-site example_test
+```
+
+
 ## Bonus: Keep Drutopia builds with similar available modules
 
 To try to keep various Drutopia-based distributions from diverging too much, at least insofar as available modules, even if they aren't installed, we can use the **meld** (`sudo apt-get install meld`) diff tool to compare and share when posssible.