Skip to content

Commit

Permalink
docs: revamp to Quads 2.0
Browse files Browse the repository at this point in the history
Change-Id: I13b91eef8e3ae631d445a1917533184236699912
  • Loading branch information
grafuls committed May 10, 2024
1 parent 7bff00b commit c9e3f1a
Show file tree
Hide file tree
Showing 7 changed files with 214 additions and 217 deletions.
395 changes: 199 additions & 196 deletions README.md

Large diffs are not rendered by default.

32 changes: 13 additions & 19 deletions docs/quads-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,9 @@

Below are common workflows, visualizations and features of QUADS.

* [QUADS Workflow and Examples)](#quads-workflow-and-visuals)
* [QUADS Workflow and Examples](#quads-workflow-and-visuals)
* [QUADS Architecture](#quads-architecture)
* [QUADS Data Structure](#quads-data-structure)
* [QUADS Workflow](#quads-workflow)
* [QUADS Foreman Provisioning Workflow](#quads-foreman-provisioning-workflow)
* [QUADS Move and Rebuild Provisioning UML](#quads-move-and-rebuild-provisioning-uml)
* [Example: Automated Scheduling](#example-automated-scheduling)
Expand All @@ -15,50 +14,45 @@ Below are common workflows, visualizations and features of QUADS.
* [Example: IRC and Email Notifications](#example-irc-and-email-notifications)

## QUADS Architecture
Typically this is how things look via our container orchestration.

![quadsarchitecture](../image/quads-container-architecture.png?raw=true)

## QUADS Data Structure
This is how our scheduling data, collections and data model within Mongo collections are stored.

![quads-erd-mongo](../image/quads-erd-mongo.png?raw=true)
![quadsarchitecture](../image/quads-architecture.png)

## QUADS Workflow
More of a flat, "creative" process interpretation.
## QUADS Data Structure
This is how our scheduling data, collections and data model look like within PostgreSQL.

![quadsworkflow](../image/quads-workflow.png?raw=true)
![quads-erd](../image/quads-erd.jpg)

## QUADS Foreman Provisioning Workflow
This is the workflow behind `quads/tools/move_and_rebuild_hosts.py`
This is the workflow behind `quads/tools/move_and_rebuild.py`

![quadsforemanarch](../image/quads-foreman-workflow.png?raw=true)
![quadsforemanarch](../image/quads-foreman-workflow.png)

## QUADS Move and Rebuild Provisioning UML
This is a UML chart illustrating all the API, host, switch and foreman workflows that happen when systems and networks are built and moved.

![quadsmoverebuild](../image/quads_provisioning_uml.png?raw=true)
![quadsmoverebuild](../image/quads_provisioning_uml.png)

## Example: Automated Scheduling

![quads-schedule](../image/quads-example-scheduling.png?raw=true)
![quads-schedule](../image/quads-example-scheduling.png)

## Example: Systems Wiki

![wiki](../image/quads-wiki.png?raw=true)
![wiki](../image/quads-wiki.png)

## Example: Workload Assignments

![wiki](../image/quads-assignments.png?raw=true)
![wiki](../image/quads-assignments.png)

## Example: Workload Assignments Readiness
We color-code progress bars and status based on total amount of completion for an entire assignment.

![wiki](../image/quads-assignment-readiness.png?raw=true)
![wiki](../image/quads-assignment-readiness.png)

## Example: Systems Visualization Map

![wiki](../image/quads-visual.png?raw=true)
![wiki](../image/quads-visual.png)

## Example: IRC and Email Notifications
- We notify our Supybot IRC bot to announce when new environments are provisioned
Expand Down
Binary file added image/quads-architecture.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed image/quads-container-architecture.png
Binary file not shown.
Binary file removed image/quads-erd-mongo.png
Binary file not shown.
Binary file added image/quads-erd.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions src/quads/server/swagger.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -595,9 +595,9 @@ paths:
tags:
- Disks
parameters:
- name: hostName
- name: disk_id
in: path
description: Hostname
description: Disk ID
required: true
schema:
type: string
Expand Down

0 comments on commit c9e3f1a

Please sign in to comment.