From 285239f422ff037ab00c98f477d31e8c2c824389 Mon Sep 17 00:00:00 2001
From: Louis Abel <label@rockylinux.org>
Date: Thu, 25 Jan 2024 15:06:29 -0700
Subject: [PATCH] point out simplified steps

---
 docs/sop/sop_compose.md   | 16 ++++++++++++++--
 docs/sop/sop_compose_8.md | 22 +++++++++++++++++++++-
 2 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/docs/sop/sop_compose.md b/docs/sop/sop_compose.md
index 07da957..09e53a8 100644
--- a/docs/sop/sop_compose.md
+++ b/docs/sop/sop_compose.md
@@ -48,6 +48,8 @@ First, the toolkit must be cloned. In the `iso/empanadas` directory, run `poetry
 * `pull-cloud-image`
 * `finalize_compose`
 
+#### Full Compose
+
 To perform a full compose, this order is expected (replacing X with major version or config profile)
 
 ```
@@ -77,6 +79,16 @@ poetry run pull-cloud-image --release X
 poetry run finalize_compose --release X
 ```
 
+#### Incremental Compose
+
+It is possible to simply compose singular repos if you know which ones you want to sync. This can be done when it's not for a brand new release.
+
+```
+# Set your repos as desired. --arch is also acceptable.
+# --ignore-debug and --ignore-source are also acceptable options.
+poetry run sync_from_peridot --release X --hashed --clean-old-packages --repo X,Y,Z
+```
+
 ## Syncing Composes
 
 Syncing utilizes the sync scripts provided in the release engineering toolkit.
@@ -120,8 +132,8 @@ RLVER=9 bash sync-to-staging.delete.sh Rocky
 Once the syncs are done, staging must be tested and vetted before being sent to production. Once staging is completed, it is synced to production.
 
 ```
-bash RLVER=8 sync-to-prod.sh
-bash RLVER=9 sync-to-prod.delete.sh
+# Set X to whatever release
+bash RLVER=X sync-to-prod.delete.sh
 bash sync-file-list-parallel.sh
 ```
 
diff --git a/docs/sop/sop_compose_8.md b/docs/sop/sop_compose_8.md
index 9a6675b..7671b5b 100644
--- a/docs/sop/sop_compose_8.md
+++ b/docs/sop/sop_compose_8.md
@@ -55,6 +55,7 @@ Each script is titled appropriately:
 * `produce-X-full.sh` -> Generates a full compose for X major release, including extras, plus, and devel in one go.
 * `updates-X.sh` -> Generates a smaller compose for X major release, typically set to the current minor release according to `rX.conf`
 * `updates-X-NAME.sh` -> Generates a compose for the specific compose, such as NFV, Rocky-devel, Extras, or Plus
+* `updates-X-full.sh` -> Generates a full incremental compose for the X release, which includes extras, plus, and devel in one go. Does NOT make ISO's.
 
 When these scripts are ran, they generate an appropriate directory under `/mnt/compose/X` with a directory and an accompanying symlink. For example. If an update to `Rocky` was made using `updates-8.sh`, the below would be made:
 
@@ -122,10 +123,29 @@ RLVER=8 bash sync-to-staging.sh Rocky
 Once the syncs are done, staging must be tested and vetted before being sent to production. During this stage, the `updateinfo.xml` is also applied where necessary to the repositories to provide errata. Once staging is completed, it is synced to production.
 
 ```
-bash RLVER=8 sync-to-prod.sh
+pushd /mnt/repos-staging/mirror/pub/rocky/8.X
+python3.9 /usr/local/bin/apollo_tree -p $(pwd) -n 'Rocky Linux 8 $arch' -i Live -i Minimal -i devel -i extras -i images -i isos -i live -i metadata -i Devel -i plus -i nfv
+popd
+RLVER=8 bash sign-repos-only.sh
+RLVER=8 bash sync-to-prod.sh
 bash sync-file-list-parallel.sh
 ```
 
 During this phase, staging is rsynced with production, the file list is updated, and the full time list is also updated to allow mirrors to know that the repositories have been updated and that they can sync.
 
 **Note**: If multiple releases are being updated, it is important to run the syncs to completion before running the file list parallel script.
+
+## Quicker Composes
+
+On the designated compose box, there is a script that can do all of the incremental steps.
+
+```
+cd /root/cron
+bash stable-updates
+```
+
+The same goes for a full production.
+
+```
+bash stable
+```