From e46d97f3c627ac272acaec67e60a2ce6402be57c Mon Sep 17 00:00:00 2001
From: EOEPCA CI <ci@eoepca.org>
Date: Mon, 24 Feb 2025 16:57:48 +0000
Subject: [PATCH] Deployed 533d996 to current with MkDocs 1.5.3 and mike 2.0.0

---
 .../building-blocks/openeo-engine/index.html  | 253 ++++++++----------
 current/sitemap.xml.gz                        | Bin 450 -> 450 bytes
 2 files changed, 114 insertions(+), 139 deletions(-)

diff --git a/current/building-blocks/openeo-engine/index.html b/current/building-blocks/openeo-engine/index.html
index 28f9796..a5fd493 100644
--- a/current/building-blocks/openeo-engine/index.html
+++ b/current/building-blocks/openeo-engine/index.html
@@ -1154,27 +1154,12 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
+  <a href="#components" class="md-nav__link">
     <span class="md-ellipsis">
-      Introduction
+      Components
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Introduction">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#key-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Features
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -1240,15 +1225,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-deploy-openeo-aggregator-using-helm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4: Deploy openEO Aggregator using Helm
-    </span>
-  </a>
-  
 </li>
         
       </ul>
@@ -1315,15 +1291,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#validate-aggregator-response" class="md-nav__link">
-    <span class="md-ellipsis">
-      Validate Aggregator Response
-    </span>
-  </a>
-  
 </li>
         
       </ul>
@@ -1342,27 +1309,36 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#1-submit-a-job-using-the-add-process" class="md-nav__link">
+  <a href="#create-a-keycloak-client" class="md-nav__link">
     <span class="md-ellipsis">
-      1. Submit a Job Using the &ldquo;add&rdquo; Process
+      Create a Keycloak Client
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#2-monitor-the-job-status" class="md-nav__link">
+  <a href="#create-a-keycloak-user" class="md-nav__link">
     <span class="md-ellipsis">
-      2. Monitor the Job Status
+      Create a Keycloak User
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#3-retrieve-the-job-result" class="md-nav__link">
+  <a href="#get-an-accces-token" class="md-nav__link">
     <span class="md-ellipsis">
-      3. Retrieve the Job Result
+      Get an Accces Token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#submit-a-job-using-the-add-process" class="md-nav__link">
+    <span class="md-ellipsis">
+      Submit a Job Using the &ldquo;add&rdquo; Process
     </span>
   </a>
   
@@ -1673,27 +1649,12 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
+  <a href="#components" class="md-nav__link">
     <span class="md-ellipsis">
-      Introduction
+      Components
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Introduction">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#key-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Features
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -1759,15 +1720,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-deploy-openeo-aggregator-using-helm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4: Deploy openEO Aggregator using Helm
-    </span>
-  </a>
-  
 </li>
         
       </ul>
@@ -1834,15 +1786,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#validate-aggregator-response" class="md-nav__link">
-    <span class="md-ellipsis">
-      Validate Aggregator Response
-    </span>
-  </a>
-  
 </li>
         
       </ul>
@@ -1861,27 +1804,36 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#1-submit-a-job-using-the-add-process" class="md-nav__link">
+  <a href="#create-a-keycloak-client" class="md-nav__link">
+    <span class="md-ellipsis">
+      Create a Keycloak Client
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#create-a-keycloak-user" class="md-nav__link">
     <span class="md-ellipsis">
-      1. Submit a Job Using the &ldquo;add&rdquo; Process
+      Create a Keycloak User
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#2-monitor-the-job-status" class="md-nav__link">
+  <a href="#get-an-accces-token" class="md-nav__link">
     <span class="md-ellipsis">
-      2. Monitor the Job Status
+      Get an Accces Token
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#3-retrieve-the-job-result" class="md-nav__link">
+  <a href="#submit-a-job-using-the-add-process" class="md-nav__link">
     <span class="md-ellipsis">
-      3. Retrieve the Job Result
+      Submit a Job Using the &ldquo;add&rdquo; Process
     </span>
   </a>
   
@@ -1932,21 +1884,13 @@
 <h1 id="processing-openeo-engine-deployment-guide-early-access">Processing - OpenEO Engine Deployment Guide (Early Access)<a class="headerlink" href="#processing-openeo-engine-deployment-guide-early-access" title="Permanent link">⚓︎</a></h1>
 <p>The <strong>OpenEO Engine</strong> building block provides early access to a unified processing platform for Earth observation data. It brings together two key components: <strong>openEO Geotrellis</strong> and <strong>openEO Aggregator</strong>. These components work together to offer a standards-based API for connecting to diverse <abbr title="Earth Observation">EO</abbr> cloud back-ends and to federate multiple openEO services into a cohesive processing platform.</p>
 <blockquote>
-<p><strong>Note:</strong> Integration of the openEO Engine is still in early access. The steps provided here are work-in-progress and may evolve in future releases.</p>
+<p><strong>Note:</strong> You must have a valid OIDC Provider to submit jobs to the OpenEO Engine. If you do not have one, refer to the <a href="../iam/main-iam/">IAM Deployment Guide</a> to set up an OIDC Provider.</p>
 </blockquote>
 <hr />
-<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">⚓︎</a></h2>
-<ul>
-<li><strong>openEO Geotrellis:</strong> Provides an API that simplifies connecting to <abbr title="Earth Observation">EO</abbr> cloud back-ends, running on Apache Spark in a Kubernetes environment.</li>
-<li><strong>openEO Aggregator:</strong> Groups multiple openEO back-ends into a unified, federated processing platform.</li>
-</ul>
-<h3 id="key-features">Key Features<a class="headerlink" href="#key-features" title="Permanent link">⚓︎</a></h3>
+<h2 id="components">Components<a class="headerlink" href="#components" title="Permanent link">⚓︎</a></h2>
 <ul>
-<li><strong>Unified API Access:</strong> Standardized endpoints allow clients to connect easily with multiple <abbr title="Earth Observation">EO</abbr> data services.</li>
-<li><strong>Federated Processing:</strong> Seamlessly aggregates back-ends, enabling flexible data processing.</li>
-<li><strong>Standards Compliance:</strong> Follows openEO specifications to maintain broad interoperability.</li>
-<li><strong>Scalability:</strong> Uses Kubernetes and Helm for robust, scalable deployments.</li>
-<li><strong>Early Access Deployment:</strong> Offers raw steps to deploy and experiment with the openEO Engine components.</li>
+<li><strong>openEO Geotrellis:</strong> Provides an API that simplifies connecting to <abbr title="Earth Observation">EO</abbr> cloud back-ends, running on Apache Spark.</li>
+<li><strong>openEO Aggregator:</strong> Groups multiple openEO back-ends into a unified processing platform.</li>
 </ul>
 <hr />
 <h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">⚓︎</a></h2>
@@ -1985,6 +1929,11 @@ <h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites"
 <td>Properly installed</td>
 <td><a href="../../prerequisites/tls/">Installation Guide</a></td>
 </tr>
+<tr>
+<td>OIDC Provider</td>
+<td>Required to submit jobs</td>
+<td><a href="../iam/main-iam/">Installation Guide</a></td>
+</tr>
 </tbody>
 </table>
 <p><strong>Clone the Deployment Guide Repository:</strong></p>
@@ -1998,7 +1947,7 @@ <h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites"
 <hr />
 <h2 id="deployment-steps">Deployment Steps<a class="headerlink" href="#deployment-steps" title="Permanent link">⚓︎</a></h2>
 <h3 id="1-run-the-configuration-script">1. Run the Configuration Script<a class="headerlink" href="#1-run-the-configuration-script" title="Permanent link">⚓︎</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>bash<span class="w"> </span>configure-openeo-geotrellis.sh
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>bash<span class="w"> </span>configure-openeo.sh
 </span></code></pre></div>
 <p>During this process, you will be prompted for:</p>
 <ul>
@@ -2039,19 +1988,11 @@ <h4 id="step-3-deploy-openeo-geotrellis-using-helm">Step 3: Deploy openEO Geotre
 <p>Deploy ingress</p>
 <div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl apply -f openeo-geotrellis/generated-ingress.yaml
 </span></code></pre></div>
-<h4 id="step-4-deploy-openeo-aggregator-using-helm">Step 4: Deploy openEO Aggregator using Helm<a class="headerlink" href="#step-4-deploy-openeo-aggregator-using-helm" title="Permanent link">⚓︎</a></h4>
-<p>The openEO Aggregator federates multiple openEO back-ends into a unified processing platform.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>helm<span class="w"> </span>upgrade<span class="w"> </span>-i<span class="w"> </span>openeofed<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w">  </span>https://artifactory.vgt.vito.be/artifactory/helm-charts/openeo-aggregator-2025.01.10-14.tgz<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">  </span>--namespace<span class="w"> </span>openeo-geotrellis<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span>--create-namespace<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">  </span>--values<span class="w"> </span>openeo-aggregator/generated-values.yaml
-</span></code></pre></div>
 <hr />
 <h2 id="validation">Validation<a class="headerlink" href="#validation" title="Permanent link">⚓︎</a></h2>
 <p>After deploying the OpenEO Engine components, perform the following checks to verify that the system is working as expected.</p>
 <h3 id="1-automated-validation-optional">1. Automated Validation (Optional)<a class="headerlink" href="#1-automated-validation-optional" title="Permanent link">⚓︎</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>bash<span class="w"> </span>validation.sh
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>bash<span class="w"> </span>validation.sh
 </span></code></pre></div>
 <p>This script verifies that:</p>
 <ul>
@@ -2061,57 +2002,92 @@ <h3 id="1-automated-validation-optional">1. Automated Validation (Optional)<a cl
 </ul>
 <h3 id="2-manual-validation">2. Manual Validation<a class="headerlink" href="#2-manual-validation" title="Permanent link">⚓︎</a></h3>
 <p>To easily run these commands, we recommend first setting <code>${INGRESS_HOST}</code> in your environment.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nb">source</span><span class="w"> </span>~/.eoepca/state
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nb">source</span><span class="w"> </span>~/.eoepca/state
 </span></code></pre></div>
 <p>Use the following commands to interact directly with the APIs:</p>
 <h4 id="check-api-metadata">Check API Metadata<a class="headerlink" href="#check-api-metadata" title="Permanent link">⚓︎</a></h4>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
 </span></code></pre></div>
 <p><em>Expected output:</em> A JSON object containing <code>api_version</code>, <code>backend_version</code>, <code>endpoints</code>, etc.</p>
 <h4 id="list-collections">List Collections<a class="headerlink" href="#list-collections" title="Permanent link">⚓︎</a></h4>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/collections<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/collections<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
 </span></code></pre></div>
 <p><em>Expected output:</em> A JSON array listing available collections, such as the sample collection <code>TestCollection-LonLat16x16</code>.</p>
 <h4 id="list-processes">List Processes<a class="headerlink" href="#list-processes" title="Permanent link">⚓︎</a></h4>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/processes<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeo.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/1.2/processes<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
 </span></code></pre></div>
 <p><em>Expected output:</em> A JSON object with an array of processes. Use your terminal’s scroll or <code>jq</code> to inspect the output.</p>
-<h4 id="validate-aggregator-response">Validate Aggregator Response<a class="headerlink" href="#validate-aggregator-response" title="Permanent link">⚓︎</a></h4>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://openeofed.<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span>/openeo/<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
-</span></code></pre></div>
-<p><em>Expected output:</em> A JSON response including federation details and links, confirming that the aggregator is aware of multiple back-ends.</p>
 <h3 id="3-usage">3. Usage<a class="headerlink" href="#3-usage" title="Permanent link">⚓︎</a></h3>
-<p>If your deployment includes sample processes and supports job submissions, you can test job execution as follows:</p>
-<h4 id="1-submit-a-job-using-the-add-process">1. Submit a Job Using the &ldquo;add&rdquo; Process<a class="headerlink" href="#1-submit-a-job-using-the-add-process" title="Permanent link">⚓︎</a></h4>
-<p>Submit a job that adds 5 and 2.5 by sending a process graph to the <code>/jobs</code> endpoint:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="s2">&quot;https://openeofed.</span><span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="s2">/openeo/1.2/jobs&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/json&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w">  </span>-d<span class="w"> </span><span class="s1">&#39;{</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s1">        &quot;process_graph&quot;: {</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s1">          &quot;sum&quot;: {</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s1">            &quot;process_id&quot;: &quot;add&quot;,</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s1">            &quot;arguments&quot;: {</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="s1">              &quot;x&quot;: 5,</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s1">              &quot;y&quot;: 2.5</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s1">            },</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s1">            &quot;result&quot;: true</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s1">          }</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="s1">        }</span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="s1">      }&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<p>Before running any jobs, you must obtain an access token from your OIDC Provider. Use the following command to get an access token if you followed our <a href="../iam/main-iam/">IAM Deployment Guide</a>.</p>
+<h4 id="create-a-keycloak-client">Create a Keycloak Client<a class="headerlink" href="#create-a-keycloak-client" title="Permanent link">⚓︎</a></h4>
+<p>Use the <code>create-client.sh</code> script in the <code>/scripts/utils/</code> directory. This script prompts you for basic details and automatically creates a Keycloak client in your chosen realm:</p>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>bash<span class="w"> </span>../../utils/create-client.sh
+</span></code></pre></div>
+<p>When prompted:</p>
+<ul>
+<li><strong>Keycloak Admin Username and Password</strong>: Enter the credentials of your Keycloak admin user (these are also in <code>~/.eoepca/state</code> if you have them set).</li>
+<li><strong>Keycloak base domain</strong>: e.g. <code>auth.example.com</code></li>
+<li>
+<p><strong>Realm</strong>: Typically <code>eoepca</code>.</p>
+</li>
+<li>
+<p><strong>Client ID</strong>: Use <code>demo-openeo-eoepca</code>.</p>
+</li>
+<li><strong>Client name</strong> and <strong>description</strong>: Provide any helpful text (e.g., &ldquo;OpenEO Client&rdquo;).</li>
+<li><strong>Client secret</strong>: Leave blank and let Keycloak generate one.</li>
+<li><strong>Subdomain</strong>: Use <code>openeo</code>.</li>
+<li><strong>Additional Subdomains</strong>: Leave blank.</li>
+</ul>
+<p>After it completes, you should see a JSON snippet confirming the newly created client.</p>
+<h4 id="create-a-keycloak-user">Create a Keycloak User<a class="headerlink" href="#create-a-keycloak-user" title="Permanent link">⚓︎</a></h4>
+<p>If you have not already created a user, you can do so using the helper scripts or through the Keycloak UI. To create a user using the helper script, run</p>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>bash<span class="w"> </span>../../utils/create-user.sh
 </span></code></pre></div>
-<p>The response should include a <code>job_id</code> (e.g., <code>"job_id": "12345"</code>) along with other job details.</p>
-<h4 id="2-monitor-the-job-status">2. Monitor the Job Status<a class="headerlink" href="#2-monitor-the-job-status" title="Permanent link">⚓︎</a></h4>
-<p>Replace <code>&lt;JOB_ID&gt;</code> with the actual job ID from the previous step and run:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>GET<span class="w"> </span><span class="s2">&quot;https://openeo.</span><span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="s2">/openeo/1.2/jobs/&lt;JOB_ID&gt;&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<h4 id="get-an-accces-token">Get an Accces Token<a class="headerlink" href="#get-an-accces-token" title="Permanent link">⚓︎</a></h4>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nb">source</span><span class="w"> </span>~/.eoepca/state
+</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>
+</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>
+</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w">    </span>curl<span class="w"> </span>--silent<span class="w"> </span>--show-error<span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w">         </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="w">         </span>-d<span class="w"> </span><span class="s2">&quot;username=&lt;YOUR-USERNAME&gt;&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="w">         </span>--data-urlencode<span class="w"> </span><span class="s2">&quot;password=&lt;YOUR-PASSWORD&gt;&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="w">         </span>-d<span class="w"> </span><span class="s2">&quot;grant_type=password&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="w">         </span>-d<span class="w"> </span><span class="s2">&quot;client_id=demo-openeo-eoepca&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="w">         </span>-d<span class="w"> </span><span class="s2">&quot;client_secret=&lt;CLIENT-SECRET&gt;&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="w">         </span>-d<span class="w"> </span><span class="s2">&quot;scope=openid profile email&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="w">         </span><span class="s2">&quot;https://</span><span class="si">${</span><span class="nv">KEYCLOAK_HOST</span><span class="si">}</span><span class="s2">/realms/</span><span class="si">${</span><span class="nv">REALM</span><span class="si">}</span><span class="s2">/protocol/openid-connect/token&quot;</span><span class="w"> </span><span class="p">|</span>
+</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="w">         </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;.access_token&#39;</span>
+</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="k">)</span>
+</span><span id="__span-14-15"><a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a>
+</span><span id="__span-14-16"><a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="nv">AUTH_TOKEN</span><span class="o">=</span><span class="s2">&quot;oidc/eoepca/</span><span class="si">${</span><span class="nv">ACCESS_TOKEN</span><span class="si">}</span><span class="s2">&quot;</span>
 </span></code></pre></div>
-<p>Check that the job’s status changes from <code>submitted</code> to <code>running</code> and eventually to <code>successful</code>.</p>
-<h4 id="3-retrieve-the-job-result">3. Retrieve the Job Result<a class="headerlink" href="#3-retrieve-the-job-result" title="Permanent link">⚓︎</a></h4>
-<p>Once the job has completed, retrieve the output:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>GET<span class="w"> </span><span class="s2">&quot;https://openeo.</span><span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="s2">/openeo/1.2/jobs/&lt;JOB_ID&gt;/results&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.
+<p>Make sure that you replace the following values:
+- <YOUR-USERNAME> with your username
+- <YOUR-PASSWORD> with your password
+- <CLIENT-SECRET> with your client secret</p>
+<p>We need to format the token as <code>oidc/eoepca/${ACCESS_TOKEN}</code> to comply with the <code>oidc_providers</code> variable seen in the Helm values.</p>
+<h4 id="submit-a-job-using-the-add-process">Submit a Job Using the &ldquo;add&rdquo; Process<a class="headerlink" href="#submit-a-job-using-the-add-process" title="Permanent link">⚓︎</a></h4>
+<p>Submit a job that adds 5 and 6.5 by sending a process graph to the <code>/jobs</code> endpoint:</p>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="s2">&quot;https://openeo.</span><span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="s2">/openeo/1.2/result&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/json&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="si">${</span><span class="nv">AUTH_TOKEN</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
+</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="w">  </span>-d<span class="w"> </span><span class="s1">&#39;{</span>
+</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s1">        &quot;process&quot;: {</span>
+</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s1">          &quot;process_graph&quot;: {</span>
+</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s1">            &quot;arccos_node&quot;: {</span>
+</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="s1">              &quot;process_id&quot;: &quot;sum&quot;,</span>
+</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s1">              &quot;arguments&quot;: {</span>
+</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s1">                &quot;data&quot;: [5,6.5]</span>
+</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s1">              },</span>
+</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s1">              &quot;result&quot;: true</span>
+</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s1">            }</span>
+</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="s1">          }</span>
+</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s1">        }</span>
+</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s1">      }&#39;</span>
 </span></code></pre></div>
 <p><strong>Expected output:</strong><br />
 A simple numeric result:</p>
-<div class="language-json highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="mf">7.5</span>
+<div class="language-json highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="mf">11.5</span>
 </span></code></pre></div>
 <p>This confirms that the &ldquo;add&rdquo; process is operational and returning the correct computed sum.</p>
 <hr />
@@ -2120,7 +2096,6 @@ <h2 id="further-reading-official-docs">Further Reading &amp; Official Docs<a cla
 <li><a href="https://open-eo.github.io/openeo-api/">openEO Documentation</a></li>
 <li><a href="https://github.com/Open-EO/openeo-geotrellis-kubernetes">openEO Geotrellis GitHub Repository</a></li>
 <li><a href="https://open-eo.github.io/openeo-aggregator/">openEO Aggregator Documentation</a></li>
-<li><a href="https://eoepca.readthedocs.io/"><abbr title="EO Exploitation Platform Common Architecture">EOEPCA</abbr>+ Documentation</a></li>
 </ul>
 
 
diff --git a/current/sitemap.xml.gz b/current/sitemap.xml.gz
index 4dbe76801b5cd2d14ed5ff123a06cb80f7b4f419..b7220c8641e3e40c2e0b31c5d1ecddd8258b3039 100644
GIT binary patch
delta 15
WcmX@ae2AG%zMF%CXX!?^J&XV(I0SG2

delta 15
WcmX@ae2AG%zMF$%d-6uMJ&XV*@C4Za