From ade1972fc37c2d6ba9a80c4a86749f4af4c05d48 Mon Sep 17 00:00:00 2001
From: Arthur Dayne <huyueheng@inspur.com>
Date: Thu, 3 Jun 2021 17:54:55 +0800
Subject: [PATCH] Doc Improvment:Add doc about cyborg-nova interaction

Change-Id: I850a7e29880a9744b18523281756bab2de1d5492
Closes-Bug: #1930404
---
 doc/source/admin/index.rst                    | 237 ++++++++++++++++++
 .../cyborg-nova-interaction-workflow.svg      |  83 ++++++
 .../figures/cyborg-nova-interaction.png       | Bin 0 -> 37829 bytes
 doc/source/index.rst                          |   9 +
 4 files changed, 329 insertions(+)
 create mode 100644 doc/source/admin/index.rst
 create mode 100644 doc/source/figures/cyborg-nova-interaction-workflow.svg
 create mode 100644 doc/source/figures/cyborg-nova-interaction.png

diff --git a/doc/source/admin/index.rst b/doc/source/admin/index.rst
new file mode 100644
index 00000000..609060c3
--- /dev/null
+++ b/doc/source/admin/index.rst
@@ -0,0 +1,237 @@
+====================
+Acceleration Service
+====================
+
+The OpenStack Cyborg is running as an acceleration service that allows you to
+manage the lifecycle of accelerating for an instance in cloud computing
+platform. It gives you control over accelerators attached to instances easily.
+
+Overview
+--------
+
+A good understand on how Cyborg interacts with Nova and Placement help
+operators manage the acceleration service more effectively.
+
+.. image:: ../figures/cyborg-nova-interaction.png
+    :width: 700 px
+    :scale: 99 %
+    :align: center
+
+Coexistence with PCI whitelists
+-------------------------------
+
+The operator tells Nova which PCI devices to claim and to be used by
+configuring the PCI Whitelists mechanism. In addition, the operator installs
+Cyborg drivers in compute nodes and configures/enables them. Those drivers may
+then discover and report some PCI devices. The operator must ensure that both
+configurations are compatible.
+
+Ideally, there is a single way for the operator to identify which PCI
+devices should be claimed by Nova and which by Cyborg. Until that is figured
+out, the operator shall use Cyborg’s configuration file to specify which Cyborg
+drivers are enabled. Since each driver claims specific PCI IDs, the operator
+can and must ensure that none of these PCI IDs are included in Nova’s PCI
+whitelist.
+
+Placement update
+----------------
+
+Cyborg conductor calls Placement API directly to represent devices and
+accelerators. Some of the intended use cases for the API invocation are:
+
+* Create or delete child RPs under the compute node RP.
+
+* Create or delete custom RCs and custom traits.
+
+* Associate traits with RPs or remove such association.
+
+* Update RP inventory.
+
+Cyborg shall not modify the RPs created by any other component, such as Nova
+virt drivers.
+
+User Requests
+-------------
+
+The user request for accelerators is encapsulated in a device profile,
+which is created and managed by the admin via the Cyborg API.
+
+The structure overview of a `device_profile` is like this:
+
+.. code:: json
+
+  {
+      "device_profiles":[
+        {
+            "name":"fpga-dp1",
+            "uuid":"5518a925-1c2c-49a2-a8bf-0927d9456f3e",
+            "description": "",
+            "groups":[
+              {
+                "trait:CUSTOM_FPGA_TRAITS":"required",
+                "resources:FPGA":"1",
+                "accel:bitstream_id":"d5ca2f11-3108-4426-a11c-a959987565df"
+              }
+            ],
+            "created_at": "2020-03-10 03:52:15+00:00",
+            "updated_at": null,
+            "links":[
+              {
+                "href":"http://192.168.32.217/accelerator/v2/device_profiles/5518a925-1c2c-49a2-a8bf-0927d9456f3e",
+                "rel":"self"
+              }
+            ]
+        }
+      ]
+  }
+
+The device profile is folded into the flavor as an extra spec by the operator,
+as below:
+
+.. code:: bash
+
+    openstack flavor set --property 'accel:device_profile=<profile_name>' flavor
+
+Thus the standard Nova API can be used to create an instance with only the
+flavor (without device profiles), like this:
+
+.. code:: bash
+
+    openstack server create --flavor f ....  # instance creation
+
+In the future, device profile may be used by itself to specify accelerator
+resources for the instance creation API.
+
+Updating the Request Spec
+-------------------------
+
+When the user submits a request to create an instance, as described in Section
+User Requests, Nova needs to call a Cyborg API, to get back the resource
+request groups in the device profile and merge them into the request spec.
+
+This call, like all the others that Nova would make to Cyborg APIs, is done
+through a Keystone-based adapter that would locate the Cyborg service, similar
+to the way Nova calls Placement. A Cyborg client module added to Nova, will
+encapsulate such calls.
+
+VM images in Glance may be associated with image properties (other than image
+traits), such as bitstream/function IDs needed for that image. So, Nova should
+pass the VM image UUID from the request spec to Cyborg.
+
+The groups in the device profile are numbered by Cyborg. The request groups
+that are merged into the request spec are numbered by Nova. These numberings
+would not be the same in general, i.e., the N-th device profile group may not
+correspond to the N-th request group in the request spec.
+
+When the device profile request groups are added to other request groups in the
+flavor, the group_policy of the flavor shall govern the overall semantics of
+all request groups.
+
+Accelerator Requests
+--------------------
+
+An accelerator request (ARQ) is an object that represents the state of the
+request for an accelerator to be assigned to an instance. The creation and
+management of ARQs are handled by Cyborg, and ARQs are persisted in Cyborg
+database.
+
+An ARQ represents a request for a single accelerator by definition. The
+device profile in the user request may have N request groups, each asking for M
+accelerators, then N * M ARQs will be created for that device profile.
+
+When an ARQ is initially created by Cyborg, it is not yet associated with a
+specific host name or a device resource provider. So it is said to be in an
+unbound state. Subsequently, Nova calls Cyborg to bind the ARQ to a host name,
+a device RP UUID and an instance UUID. If the instance fails to spawn, Nova
+would unbind the ARQ with deleting it. On instance termination, Nova would
+delete the ARQs after unbinding them.
+
+Each ARQ needs to be matched to the specific RP in the allocation candidate
+that Nova has chosen, before the ARQ is bound. The current Nova code maps
+request groups to RPs, while the Cyborg client module in Nova
+(cyborg-client-module) matches ARQs to request groups. The matching is done
+using the request_id field in the RequestGroup object as below:
+
+* The order of request groups in a device profile is not significant, but it is
+  preserved by Cyborg. Thus, each device profile request group has a unique
+  index.
+
+* When the device profile request groups returned by Cyborg are added to the
+  request spec, the request_id field is set to ‘device_profile_<N>’ for the
+  N-th device profile request group (starting from zero). The device profile
+  name need not be included here because there is only one device profile per
+  request spec.
+
+* When Cyborg creates an ARQ for a device profile, it embeds the device profile
+  request group index in the ARQ before returning it to Nova.
+
+* The matching is done in two steps:
+
+  * Each ARQ is mapped to a specific request group in the request spec using
+    the request_id field.
+
+  * Each request group is mapped to a specific RP using the same logic as the
+    Neutron bandwidth provider.
+
+Cyborg and Nova interaction workflow
+------------------------------------
+
+This flow is captured by the following sequence diagram, in which the Nova
+conductor and scheduler are together represented as the Nova controller.
+
+.. image:: ../figures/cyborg-nova-interaction-workflow.svg
+
+A Cyborg client module is added to nova (cyborg-client-module). All Cyborg API
+calls are routed through that.
+
+1. The Nova API server receives a `POST /servers` API request with a flavor
+   that includes a device profile name.
+
+2. The Nova API server calls the Cyborg API
+   `GET /v2/device_profiles?name=$device_profile_name` and gets back the device
+   profile. The request groups in that device profile are added to the request
+   spec.
+
+3. The Nova scheduler invokes Placement and gets a list of allocation
+   candidates. It selects one of those candidates and makes claim(s) in
+   Placement. The Nova conductor then sends a RPC message
+   build_and_run_instances to the Nova compute manager.
+
+4. Nova conductor manager calls the Cyborg API `POST /v2/accelerator_requests`
+   with the device profile name. Cyborg creates a set of unbound ARQs for that
+   device profile and returns them to Nova.
+
+5. The Cyborg client in Nova matches each ARQ to the resource provider picked
+   for that accelerator.
+
+6. The Nova compute manager calls the Cyborg API
+   `PATCH /v2/accelerator_requests` to bind the ARQ with the host name,
+   device’s RP UUID and instance UUID. This is an asynchronous call which
+   prepares or reconfigures the device in the background.
+
+7. Cyborg, on completion of the bindings (successfully or otherwise),
+   calls Nova’s `POST /os-server-external-events` API with:
+
+.. code::
+
+    {
+        "events": [
+            { "name": "accelerator-request-bound",
+                "tag": $device_profile_name,
+                "server_uuid": $instance_uuid,
+                "status": "completed" # or "failed"
+            },
+            ...
+        ]
+    }
+
+8. The Nova compute manager waits for the notification, subject to the timeout
+   mentioned in Section Other deployer impact. It then calls the Cyborg REST
+   API `GET /v2/accelerator_requests?instance=<uuid>&bind_state=resolved`.
+
+9. The Nova virt driver uses the attach handles returned from the Cyborg call
+   to compose PCI passthrough devices into the VM’s definition.
+
+10. If there is any error after binding has been initiated, Nova must unbind
+    the relevant ARQs by calling Cyborg API. It may then retry on another host
+    or delete the (unbound) ARQs for the instance.
diff --git a/doc/source/figures/cyborg-nova-interaction-workflow.svg b/doc/source/figures/cyborg-nova-interaction-workflow.svg
new file mode 100644
index 00000000..6e668eeb
--- /dev/null
+++ b/doc/source/figures/cyborg-nova-interaction-workflow.svg
@@ -0,0 +1,83 @@
+<svg height="885" viewBox="0 0 856 885" width="856" xmlns="http://www.w3.org/2000/svg" xmlns:inkspace="http://www.inkscape.org/namespaces/inkscape" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <defs id="defs_block">
+    <filter height="1.504" id="filter_blur" inkspace:collect="always" width="1.1575" x="-0.07875" y="-0.252">
+      <feGaussianBlur id="feGaussianBlur3780" inkspace:collect="always" stdDeviation="4.2"></feGaussianBlur>
+    </filter>
+  </defs>
+  <title>blockdiag</title>
+  <desc></desc>
+  <rect fill="rgb(0,0,0)" height="40" stroke="rgb(0,0,0)" style="filter:url(#filter_blur);opacity:0.7;fill-opacity:1" width="128" x="67" y="21"></rect>
+  <rect fill="rgb(0,0,0)" height="40" stroke="rgb(0,0,0)" style="filter:url(#filter_blur);opacity:0.7;fill-opacity:1" width="128" x="267" y="21"></rect>
+  <rect fill="rgb(0,0,0)" height="40" stroke="rgb(0,0,0)" style="filter:url(#filter_blur);opacity:0.7;fill-opacity:1" width="128" x="467" y="21"></rect>
+  <rect fill="rgb(0,0,0)" height="40" stroke="rgb(0,0,0)" style="filter:url(#filter_blur);opacity:0.7;fill-opacity:1" width="128" x="667" y="21"></rect>
+  <path d="M 128 55 L 128 885" fill="none" stroke="rgb(0,0,0)" stroke-dasharray="8 4"></path>
+  <path d="M 328 55 L 328 885" fill="none" stroke="rgb(0,0,0)" stroke-dasharray="8 4"></path>
+  <path d="M 528 55 L 528 885" fill="none" stroke="rgb(0,0,0)" stroke-dasharray="8 4"></path>
+  <path d="M 728 55 L 728 885" fill="none" stroke="rgb(0,0,0)" stroke-dasharray="8 4"></path>
+  <rect fill="rgb(255,255,255)" height="40" stroke="rgb(0,0,0)" width="128" x="64" y="15"></rect>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="90" x="128.0" y="41">Nova Controller</text>
+  <rect fill="rgb(255,255,255)" height="40" stroke="rgb(0,0,0)" width="128" x="264" y="15"></rect>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="54" x="328.0" y="41">Placement</text>
+  <rect fill="rgb(255,255,255)" height="40" stroke="rgb(0,0,0)" width="128" x="464" y="15"></rect>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="36" x="528.0" y="41">Cyborg</text>
+  <rect fill="rgb(255,255,255)" height="40" stroke="rgb(0,0,0)" width="128" x="664" y="15"></rect>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="72" x="728.0" y="41">Nova Compute</text>
+  <path d="M 136 85 L 520 85" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="512,81 520,85 512,89" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 125 L 520 125" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="144,121 136,125 144,129" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 191 L 224 191" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 224 191 L 224 207" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 224 207 L 136 207" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="144,203 136,207 144,211" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 247 L 320 247" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="312,243 320,247 312,251" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 300 L 320 300" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="144,296 136,300 144,304" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 353 L 224 353" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 224 353 L 224 369" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 224 369 L 136 369" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="144,365 136,369 144,373" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 409 L 720 409" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="712,405 720,409 712,413" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 462 L 720 462" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="544,458 536,462 544,466" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 502 L 720 502" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="712,498 720,502 712,506" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 555 L 720 555" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="544,551 536,555 544,559" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 595 L 720 595" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="712,591 720,595 712,599" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 136 635 L 520 635" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="144,631 136,635 144,639" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 736 701 L 816 701" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 816 701 L 816 717" fill="none" stroke="rgb(0,0,0)"></path>
+  <path d="M 816 717 L 736 717" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="744,713 736,717 744,721" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 796 L 720 796" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="544,792 536,796 544,800" stroke="rgb(0,0,0)"></polygon>
+  <path d="M 536 836 L 720 836" fill="none" stroke="rgb(0,0,0)"></path>
+  <polygon fill="rgb(0,0,0)" points="712,832 720,836 712,840" stroke="rgb(0,0,0)"></polygon>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="198" x="239.0" y="83">GET /v2/device_profiles?name=mydp</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="216" x="412.0" y="123">{"device_profiles": $device_profile}</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="108" x="190.0" y="163">Merge request grou</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="108" x="190.0" y="176">ps into request_sp</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="12" x="142.0" y="189">ec</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="156" x="218.0" y="245">Get /allocation_candidates</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="180" x="230.0" y="285">allocation candidates with nes</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="42" x="299.0" y="298">ted RPs</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="108" x="190.0" y="345">Select a candidate</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="150" x="215.0" y="407">build_and_run_instances()</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="174" x="633.0" y="454">POST /v2/accelerator_requests</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="120" x="600.0" y="500">{"arqs": [$arq, ...]</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="180" x="630.0" y="547">PATCH /v2/accelerator_requests</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="120" x="600.0" y="593">{"arqs": [$arq, ...]</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="186" x="427.0" y="633">POST /os-server-external-events</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="96" x="784.0" y="673">Wait for notific</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="96" x="784.0" y="686">ation from Cybor</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="6" x="739.0" y="699">g</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="174" x="633.0" y="762">GET /v2/accelerator_requests?</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="180" x="630.0" y="775">instance=$uuid&amp;bind_state=reso</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="24" x="708.0" y="788">lved</text>
+  <text fill="rgb(0,0,0)" font-family="sans-serif" font-size="11" font-style="normal" font-weight="normal" text-anchor="middle" textLength="132" x="606.0" y="834">{"arqs": [$arq, ....]}</text>
+</svg>
\ No newline at end of file
diff --git a/doc/source/figures/cyborg-nova-interaction.png b/doc/source/figures/cyborg-nova-interaction.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c0674b641b892a90e767a265c520d775fb19236
GIT binary patch
literal 37829
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
HrhooFV{1d{

literal 0
HcmV?d00001

diff --git a/doc/source/index.rst b/doc/source/index.rst
index ef7792cb..b842f143 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -29,6 +29,7 @@ Installation
    install/install-from-pip
    install/install-from-source
    admin/config-wsgi
+   admin/index
 
 Configuration Reference
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -39,6 +40,14 @@ Configuration Reference
    configuration/index
    reference/support-matrix
 
+Maintenance
+~~~~~~~~~~~
+
+Once you are running cyborg, the following information is extremely useful.
+
+* :doc:`Admin Guide </admin/index>`: A collection of guides for administrating
+  cyborg.
+
 For End Users
 -------------