From 6f2d68eb4a88ab9cb6ea7895611ec4a01541fc4a Mon Sep 17 00:00:00 2001
From: Danial Hezarkhani <danial.hezarkhani@iais.fraunhofer.de>
Date: Tue, 30 Apr 2024 15:57:12 +0200
Subject: [PATCH] brought bug fixes from main
---
00_Documentation/class_diagram.drawio | 189 ++++++++++++++++++++
00_Documentation/class_diagram_V1.png | Bin 0 -> 77769 bytes
src/hpc_deployer/unicore/backend_api.py | 2 +-
src/hpc_deployer/unicore/unicore_job.py | 88 ++++++++-
src/hpc_deployer/utils/config.py | 5 +-
src/hpc_deployer/webui/app.py | 6 +-
src/hpc_deployer/webui/templates/index.html | 4 +
7 files changed, 283 insertions(+), 11 deletions(-)
create mode 100644 00_Documentation/class_diagram.drawio
create mode 100644 00_Documentation/class_diagram_V1.png
diff --git a/00_Documentation/class_diagram.drawio b/00_Documentation/class_diagram.drawio
new file mode 100644
index 0000000..b9abdda
--- /dev/null
+++ b/00_Documentation/class_diagram.drawio
@@ -0,0 +1,189 @@
+<mxfile host="Electron" modified="2024-04-30T13:35:56.614Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/24.0.4 Chrome/120.0.6099.109 Electron/28.1.0 Safari/537.36" etag="IlZTv-QdUwuiADvnxMXv" version="24.0.4" type="device">
+ <diagram id="C5RBs43oDa-KdzZeNtuy" name="Page-1">
+ <mxGraphModel dx="2206" dy="1483" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+ <root>
+ <mxCell id="WIyWlLk6GJQsqaUBKTNV-0" />
+ <mxCell id="WIyWlLk6GJQsqaUBKTNV-1" parent="WIyWlLk6GJQsqaUBKTNV-0" />
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--0" value="UnicoreJob" style="swimlane;fontStyle=2;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+ <mxGeometry x="100" y="140" width="160" height="216" as="geometry">
+ <mxRectangle x="230" y="140" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--1" value="Registry " style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="26" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--2" value="client" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="52" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--3" value="job" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="78" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--4" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="104" width="160" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--5" value="sumbit_job(job_description)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="112" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-2" value="wait_for_job_start()" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="138" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-3" value="wait_for_job_finish()" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="164" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-1" value="get_job()" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--0" vertex="1">
+ <mxGeometry y="190" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--6" value="Portforwarder" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+ <mxGeometry x="20" y="480" width="320" height="130" as="geometry">
+ <mxRectangle x="130" y="380" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--7" value="job
" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+ <mxGeometry y="26" width="320" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--9" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+ <mxGeometry y="52" width="320" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--11" value="make_connection(hpc_port, local_port)
" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+ <mxGeometry y="60" width="320" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-5" value="check_connection()

" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--6" vertex="1">
+ <mxGeometry y="86" width="320" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--12" value="" style="endArrow=diamondThin;endSize=10;endFill=1;shadow=0;strokeWidth=1;rounded=0;edgeStyle=elbowEdgeStyle;elbow=vertical;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="zkfFHV4jXpPFQw0GAbJ--6" target="zkfFHV4jXpPFQw0GAbJ--0" edge="1">
+ <mxGeometry width="160" relative="1" as="geometry">
+ <mxPoint x="200" y="203" as="sourcePoint" />
+ <mxPoint x="200" y="203" as="targetPoint" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--17" value="HPC_Deployer" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+ <mxGeometry x="530" y="130" width="160" height="216" as="geometry">
+ <mxRectangle x="550" y="140" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--18" value="job_list" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="26" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--19" value="portforwarding_list" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="52" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--20" value="config" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="78" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--23" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="104" width="160" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--24" value="set_config" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="112" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--25" value="start_pulling" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="138" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-11" value="start_jobs" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="164" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-12" value="start_portforwardings" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="zkfFHV4jXpPFQw0GAbJ--17" vertex="1">
+ <mxGeometry y="190" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--26" value="" style="endArrow=diamondThin;shadow=0;strokeWidth=1;rounded=0;endFill=0;edgeStyle=elbowEdgeStyle;elbow=vertical;jumpSize=9;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="zkfFHV4jXpPFQw0GAbJ--0" target="zkfFHV4jXpPFQw0GAbJ--17" edge="1">
+ <mxGeometry x="0.5" y="41" relative="1" as="geometry">
+ <mxPoint x="380" y="192" as="sourcePoint" />
+ <mxPoint x="540" y="192" as="targetPoint" />
+ <mxPoint x="-40" y="32" as="offset" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--27" value="1..*" style="resizable=0;align=left;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="zkfFHV4jXpPFQw0GAbJ--26" connectable="0" vertex="1">
+ <mxGeometry x="-1" relative="1" as="geometry">
+ <mxPoint y="4" as="offset" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="zkfFHV4jXpPFQw0GAbJ--28" value="1" style="resizable=0;align=right;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="zkfFHV4jXpPFQw0GAbJ--26" connectable="0" vertex="1">
+ <mxGeometry x="1" relative="1" as="geometry">
+ <mxPoint x="-7" y="4" as="offset" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;endArrow=diamondThin;endFill=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="Nfre0TDgzKp-mo3EwC7I-5" target="zkfFHV4jXpPFQw0GAbJ--17" edge="1">
+ <mxGeometry relative="1" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-9" value="0..*" style="resizable=0;align=left;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="WIyWlLk6GJQsqaUBKTNV-1" connectable="0" vertex="1">
+ <mxGeometry x="190" y="480" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-10" value="0..*" style="resizable=0;align=left;verticalAlign=bottom;labelBackgroundColor=none;fontSize=12;" parent="WIyWlLk6GJQsqaUBKTNV-1" connectable="0" vertex="1">
+ <mxGeometry x="350" y="570" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-13" value="Backend" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+ <mxGeometry x="1040" y="177" width="160" height="117" as="geometry">
+ <mxRectangle x="550" y="140" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-14" value="unicore_job" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="Nfre0TDgzKp-mo3EwC7I-13" vertex="1">
+ <mxGeometry y="26" width="160" height="22" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-17" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="Nfre0TDgzKp-mo3EwC7I-13" vertex="1">
+ <mxGeometry y="48" width="160" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="Nfre0TDgzKp-mo3EwC7I-18" value="start_job(job_config)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="Nfre0TDgzKp-mo3EwC7I-13" vertex="1">
+ <mxGeometry y="56" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="TvflgwcU52VNFXFne61s-5" value="start_orchestrator_job" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" vertex="1" parent="Nfre0TDgzKp-mo3EwC7I-13">
+ <mxGeometry y="82" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-0" value="UI" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" parent="WIyWlLk6GJQsqaUBKTNV-1" vertex="1">
+ <mxGeometry x="1040" y="385" width="160" height="216" as="geometry">
+ <mxRectangle x="550" y="140" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-1" value="job_type(gpu,cpu)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="26" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-2" value="# nodes" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="52" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-3" value="# Cpu per task" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="78" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-4" value="mem per cpu" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rounded=0;shadow=0;html=0;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="104" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-5" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="130" width="160" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-7" value="generate bluprint.json" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="138" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-9" value="start_job(): job_config" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" parent="CWfM8TEpYPpnlyCobIkf-0" vertex="1">
+ <mxGeometry y="164" width="160" height="26" as="geometry" />
+ </mxCell>
+ <mxCell id="CWfM8TEpYPpnlyCobIkf-8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.75;entryDx=0;entryDy=0;" parent="WIyWlLk6GJQsqaUBKTNV-1" source="Nfre0TDgzKp-mo3EwC7I-11" target="Nfre0TDgzKp-mo3EwC7I-13" edge="1">
+ <mxGeometry relative="1" as="geometry">
+ <mxPoint x="850" y="247" as="targetPoint" />
+ <Array as="points">
+ <mxPoint x="690" y="260" />
+ <mxPoint x="851" y="260" />
+ <mxPoint x="851" y="267" />
+ </Array>
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="TvflgwcU52VNFXFne61s-4" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" edge="1" parent="WIyWlLk6GJQsqaUBKTNV-1" source="TvflgwcU52VNFXFne61s-0" target="Nfre0TDgzKp-mo3EwC7I-13">
+ <mxGeometry relative="1" as="geometry">
+ <Array as="points">
+ <mxPoint x="840" y="330" />
+ <mxPoint x="1120" y="330" />
+ </Array>
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="TvflgwcU52VNFXFne61s-0" value="Orchestrator_client" style="swimlane;fontStyle=0;align=center;verticalAlign=top;childLayout=stackLayout;horizontal=1;startSize=26;horizontalStack=0;resizeParent=1;resizeLast=0;collapsible=1;marginBottom=0;rounded=0;shadow=0;strokeWidth=1;" vertex="1" parent="WIyWlLk6GJQsqaUBKTNV-1">
+ <mxGeometry x="760" y="363" width="160" height="117" as="geometry">
+ <mxRectangle x="550" y="140" width="160" height="26" as="alternateBounds" />
+ </mxGeometry>
+ </mxCell>
+ <mxCell id="TvflgwcU52VNFXFne61s-2" value="" style="line;html=1;strokeWidth=1;align=left;verticalAlign=middle;spacingTop=-1;spacingLeft=3;spacingRight=3;rotatable=0;labelPosition=right;points=[];portConstraint=eastwest;" vertex="1" parent="TvflgwcU52VNFXFne61s-0">
+ <mxGeometry y="26" width="160" height="8" as="geometry" />
+ </mxCell>
+ <mxCell id="TvflgwcU52VNFXFne61s-3" value="start_orchestrator(job_config)" style="text;align=left;verticalAlign=top;spacingLeft=4;spacingRight=4;overflow=hidden;rotatable=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;" vertex="1" parent="TvflgwcU52VNFXFne61s-0">
+ <mxGeometry y="34" width="160" height="26" as="geometry" />
+ </mxCell>
+ </root>
+ </mxGraphModel>
+ </diagram>
+</mxfile>
diff --git a/00_Documentation/class_diagram_V1.png b/00_Documentation/class_diagram_V1.png
new file mode 100644
index 0000000000000000000000000000000000000000..0a1c970a5c091d06bc243d17bd61d249961cab12
GIT binary patch
literal 77769
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
literal 0
HcmV?d00001
diff --git a/src/hpc_deployer/unicore/backend_api.py b/src/hpc_deployer/unicore/backend_api.py
index b2cd4f2..84485a0 100644
--- a/src/hpc_deployer/unicore/backend_api.py
+++ b/src/hpc_deployer/unicore/backend_api.py
@@ -63,7 +63,7 @@ def start_job(unicore_config):
@app.route('/start-orchestrator', methods=['POST'])
def start_orchestrator_job():
- start_orchestrator("localhost",config.orchestrator_portgrpc,config.base_path)
+ start_orchestrator("localhost",int(config.orchestrator_portgrpc),config.base_path)
@app.route('/job-started', methods=['POST'])
diff --git a/src/hpc_deployer/unicore/unicore_job.py b/src/hpc_deployer/unicore/unicore_job.py
index c708d0c..6be02cf 100644
--- a/src/hpc_deployer/unicore/unicore_job.py
+++ b/src/hpc_deployer/unicore/unicore_job.py
@@ -67,8 +67,8 @@ class UnicoreJob:
if response.status_code == 200:
return response.content
-
- def generate_pull_config(self,unicore_config):
+ # There is a bug regarding of pulling apptainers in parallel: https://github.com/apptainer/singularity/issues/3579. We use none parallel in our case
+ def generate_pull_config_parallel(self,unicore_config):
email = unicore_config["notification_email"]
project= unicore_config["project_name"]
partition= unicore_config["partition"]
@@ -78,6 +78,7 @@ class UnicoreJob:
for job_dic in container_list:
docker_path = job_dic["image_url"]
apptainer_name = job_dic["name"]
+
if num_gpu>0:
srun_string = "srun --exact --gres=gpu:1 -n1 --cpus-per-task=4 bash -c \"apptainer pull --dir ${{APPTAINER_FOLDER}} {apptainer_name}.sif docker://{docker_path}\" &".format(apptainer_name=apptainer_name, docker_path=docker_path)
else:
@@ -97,8 +98,8 @@ class UnicoreJob:
"mkdir -p ${WRITABLE_DIRECTORY}",
"mkdir -p ${APPTAINER_FOLDER}",
- "APPTAINER_CACHEDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
- "APPTAINER_TMPDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
+ "export APPTAINER_CACHEDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
+ "export APPTAINER_TMPDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
"echo ${APPTAINER_CACHEDIR}",
"echo ${APPTAINER_TMPDIR}"
]
@@ -147,6 +148,85 @@ class UnicoreJob:
return job_dic
+ def generate_pull_config(self,unicore_config):
+ email = unicore_config["notification_email"]
+ project= unicore_config["project_name"]
+ partition= unicore_config["partition"]
+ num_gpu= int(unicore_config["gpu_number"])
+ container_list= unicore_config["containers"]
+ srun_list=[]
+ for job_dic in container_list:
+ docker_path = job_dic["image_url"]
+ apptainer_name = job_dic["name"]
+
+ if num_gpu>0:
+ srun_string = "apptainer pull --dir ${{APPTAINER_FOLDER}} {apptainer_name}.sif docker://{docker_path}".format(apptainer_name=apptainer_name, docker_path=docker_path)
+ else:
+ srun_string = "apptainer pull --dir ${{APPTAINER_FOLDER}} {apptainer_name}.sif docker://{docker_path}".format(apptainer_name=apptainer_name, docker_path=docker_path)
+ srun_list.append(srun_string)
+
+ scratch_folder_name = "${{SCRATCH_{}}}".format(project)
+ data_beginn = [
+ "#!/bin/sh",
+ "echo Job started",
+
+ "JOBDIR=job1",
+
+ "export WRITABLE_DIRECTORY=/tmp/cacheapptainer/${JOBDIR}Cache",
+ "export APPTAINER_FOLDER={}/apptainerfolder".format(scratch_folder_name),
+
+ "mkdir -p ${WRITABLE_DIRECTORY}",
+ "mkdir -p ${APPTAINER_FOLDER}",
+
+ "export APPTAINER_CACHEDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
+ "export APPTAINER_TMPDIR=$(mktemp -d -p $WRITABLE_DIRECTORY)",
+ "echo ${APPTAINER_CACHEDIR}",
+ "echo ${APPTAINER_TMPDIR}"
+ ]
+
+ data_end = [
+ "rm -rf ${APPTAINER_CACHEDIR}",
+ "rm -rf ${APPTAINER_TMPDIR}"
+ ]
+
+ data_complete = data_beginn + srun_list + data_end
+
+ sbatch_setting = [
+ "#!/bin/bash",
+ f"#SBATCH --account={project}",
+ f"#SBATCH --partition={partition}",
+ "#SBATCH --nodes=1",
+ "#SBATCH --mem-per-cpu=4G # memory per CPU core",
+ "#SBATCH --time=30",
+ "#SBATCH --output=stdout",
+ "#SBATCH --error=stderr"
+ ]
+
+ if num_gpu>0:
+ sbatch_setting.append("#SBATCH --gres=gpu:{}".format(num_gpu))
+
+ job_dic = {
+ "Name": "Pull job",
+ "User email": email,
+ "Job type": "RAW",
+ "BSS file": "bss.sh",
+ "Project": project,
+ "Executable": "/bin/sh",
+ "Arguments": ["pull.sh"],
+ "Imports": [
+ {
+ "To": "pull.sh",
+ "Data": data_complete
+ },
+ {
+ "To": "bss.sh",
+ "Data": sbatch_setting
+ }
+ ]
+ }
+
+ return job_dic
+
def generate_run_config(self,unicore_config):
email = unicore_config["notification_email"]
diff --git a/src/hpc_deployer/utils/config.py b/src/hpc_deployer/utils/config.py
index 5c08067..396d0c7 100644
--- a/src/hpc_deployer/utils/config.py
+++ b/src/hpc_deployer/utils/config.py
@@ -12,10 +12,9 @@ class Config:
self.orchestrator_id = 99
self.orchestrator_host = "localhost"
self.orchestrator_portgrpc= "9200"
- self.orchestrator_portwebui = "9201"
self.orchestrator_cpu = 4
- self.orchestrator_url = "/generic-parallel-orchestrator/orchestrator_container:1.8"
- self.orchestrator_start= "pipenv run python3 -m /app/ai4eu.orchestratorservice"
+ self.orchestrator_url = "/generic-parallel-orchestrator/orchestrator_container:1.9-hpc"
+ self.orchestrator_start= "python -m ai4eu.orchestratorservice -p {}".format(self.orchestrator_portgrpc)
self.path_to_blueprint = os.path.join(base_path, "blueprint.json")
self.path_to_dockerinfo = os.path.join(base_path, "dockerinfo.json")
diff --git a/src/hpc_deployer/webui/app.py b/src/hpc_deployer/webui/app.py
index f98f3e8..15a99a9 100644
--- a/src/hpc_deployer/webui/app.py
+++ b/src/hpc_deployer/webui/app.py
@@ -93,10 +93,10 @@ def save_dockerinfo(input_list):
def generate_unicore_config():
for container in containers:
- a = container["image_url"]
path = urlparse(container["image_url"]).path
+ if path.startswith("7444"):
+ path = path[len("7444"):]
container["image_url"] = config.docker_registery_url + path
- print(a)
dic={
"containers":containers
@@ -226,7 +226,7 @@ def configure_orchestrator():
"name": config.orchestrator_name,
"cpu": config.orchestrator_cpu,
"portgrpc": config.orchestrator_portgrpc,
- "portwebui": config.orchestrator_portwebui,
+ "portwebui": config.orchestrator_portgrpc,
"startcommand": config.orchestrator_start,
"image_url":config.orchestrator_url
}
diff --git a/src/hpc_deployer/webui/templates/index.html b/src/hpc_deployer/webui/templates/index.html
index 34b1cbc..efe589f 100644
--- a/src/hpc_deployer/webui/templates/index.html
+++ b/src/hpc_deployer/webui/templates/index.html
@@ -129,6 +129,10 @@
</div>
</div>
+ <form action="/job" method="get">
+ <button type="submit" class="btn btn-warning btn-block">Go to Orchestartor page</button>
+ </form>
+
</div>
</div>
--
GitLab