From de41f3db4ebbcf8a1cf398f43daee0abd863f8e6 Mon Sep 17 00:00:00 2001
From: Baptiste Jonglez <git@bitsofnetworks.org>
Date: Thu, 29 Dec 2022 14:22:28 +0100
Subject: Document how to run jobs

---
 doc/architecture.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'doc/architecture.md')

diff --git a/doc/architecture.md b/doc/architecture.md
index 53032c2..36f3798 100644
--- a/doc/architecture.md
+++ b/doc/architecture.md
@@ -143,6 +143,25 @@ $ nomad operator scheduler get-config --json
 
 ### Launching services
 
+To launch a service, e.g. `app/core`, use `nomad plan` first:
+
+```
+cd cluster/staging/app/core/deploy
+nomad plan core-system.hcl
+```
+
+If the diff looks fine, then you can run the job for real
+(the index is printed in the output of `nomad plan`):
+
+```
+nomad job run -check-index NNN core-system.hcl
+```
+
+There may be several jobs in the same directory, for instance
+`core-system.hcl` and `core-service.hcl`.
+
+### Which services to launch
+
 Stuff should be started in this order:
 
 1. `app/core`
-- 
cgit v1.2.3