[WIP] Co-execution client for Google Cloud Platform Batch v1

docs/containers.rst

@@ -132,6 +132,22 @@ GA4GH TES
 
    GA4GH TES job execution with Conda dependencies for the tool and no message queue.
 
+Google Cloud Platform Batch
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. figure:: pulsar_gcp_coexecution_deployment.plantuml.svg
+
+   GA4GH TES job execution with a biocontainer for the tool and no message queue.
+
+.. figure:: pulsar_gcp_deployment.plantuml.svg
+
+   GA4GH TES job execution with Conda dependencies for the tool and no message queue.
+
+Pulsar job destination options to configure these scenarios:
+
+.. figure:: job_destination_parameters_gcp.png
+
+
 AWS Batch
 ~~~~~~~~~~
 

docs/gen_erd_diagrams.py

@@ -0,0 +1,18 @@
+import os
+import sys
+
+import erdantic as erd
+
+sys.path.insert(1, os.path.abspath(os.path.join(os.path.dirname(__file__), os.pardir)))
+
+from pulsar.client.container_job_config import (
+    GcpJobParams,
+)
+
+DOC_SOURCE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__)))
+class_to_diagram = {
+    GcpJobParams: "job_destination_parameters_gcp",
+}
+
+for clazz, diagram_name in class_to_diagram.items():
+    erd.draw(clazz, out=f"{DOC_SOURCE_DIR}/{diagram_name}.png")

docs/pulsar_gcp_coexecution_deployment.plantuml.txt

@@ -0,0 +1,48 @@
+@startuml
+
+!include plantuml_options.txt
+
+component galaxy as "galaxy" {
+
+}
+
+storage disk as "Object Store" {
+
+}
+
+note as disknote
+    Disk is unrestricted and does
+    not need to be shared between
+    Pulsar and Galaxy.
+end note
+
+disk ... disknote
+
+cloud cluster as "Google Cloud Platform" {
+    queue api as "Google Batch v1 API" {
+
+    }
+
+    frame pod as "Job" {
+
+        component staging as "pulsar Task" {
+        }
+
+        component tool as "biocontainer Task" {
+        }
+
+    }
+
+    note as stagingnote
+        Pulsar Tasks run with a batch_v1.AllocationPolicy.Disk of type "local-ssd"
+        that is used for Pulsar's staging directory and shared across pulsar stagings and
+        tool/biocontainer containers.
+    end note
+    pod ... stagingnote
+}
+
+galaxy --> disk
+galaxy --> api : create, delete, get (for status)
+api -[dashed]-> pod : [manages]
+staging --> galaxy : stage in and out
+@enduml