From c14d2e1493b122aaa418899d78242b3093dd05b9 Mon Sep 17 00:00:00 2001
From: Pedro Moura <pmoura@redhat.com>
Date: Jun 22 2022 20:24:31 +0000
Subject: Adding SOP to create Duffy tenant


Signed-off-by: Pedro Moura <pmoura@redhat.com>

---

diff --git a/docs/operations/ci/adding_cico_tenant/adding-duffy-tenant.md b/docs/operations/ci/adding_cico_tenant/adding-duffy-tenant.md
new file mode 100644
index 0000000..8841779
--- /dev/null
+++ b/docs/operations/ci/adding_cico_tenant/adding-duffy-tenant.md
@@ -0,0 +1,72 @@
+# SOP to create Duffy tenant
+This SOP covers the process of how to create a duffy tenant
+
+## Steps
+1. Connect to duffy.ci.centos.org 
+```shell
+ssh duffy.ci.centos.org
+```
+
+2. Change to duffy user
+```shell
+sudo su - duffy
+```
+
+3. Create tenant with the command below and save api key somewhere safe, it outputs the key as `<tenant name>: <API key>`
+```shell
+duffy admin create-tenant <tenant name> <ssh pub-key>
+``` 
+
+4. Connect to the host that will have duffy client
+```shell
+ssh <host user>@<target host>
+```
+
+5. Install duffy client using `pip`
+```shell
+pip3.8 install --user duffy[client]
+```
+
+6. In the home path of the user, create `.config` directory if it doesn’t exist and create `.config/duffy` with the following content
+```
+client:
+  url: https://duffy.ci.centos.org/api/v1
+  auth:
+    name: <tenant name>
+    key: <API key>
+```
+
+7. To create a session, the name of the pool is required. Check the pool available executing the command **_(Optional)_**
+```shell
+duffy client list-pools
+```
+
+8. Request a session
+```shell
+duffy client request-session pool=<name of the pool>,quantity=<number of sessions wanted>
+``` 
+
+By default this command outputs a _json_, but it's possible to change the format to _yaml_ or _flat_ using `--format`. Under "node" key it's possible to find the hostname to be used. Log in to it as `root` user, using `ssh`.
+
+```json
+{
+...output ommited...
+
+"nodes": [
+    {
+        "hostname": "<hostname>.ci.centos.org",
+        "ipaddr": "<ip address>",
+
+...output ommited...
+}
+```
+
+9. When needed to retire the session, connect to your duffy client host and execute the command
+```shell
+duffy client retire-session <session id>
+```
+
+It's possible to check the session id either when the session is requested, in the output under "session" key, or using the following command:
+```shell
+duffy client list-sessions
+```