Skip to content

Commit 4d1e40f

Browse files
Deployed d7242c7 to dev with MkDocs 1.6.1 and mike 2.1.3
1 parent 651649c commit 4d1e40f

File tree

3 files changed

+51
-14
lines changed

3 files changed

+51
-14
lines changed

dev/configuration-and-management/tls-configuration/index.html

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2066,22 +2066,26 @@ <h2 id="kustomize-overlays">Kustomize Overlays</h2>
20662066
<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kustomize<span class="w"> </span>build<span class="w"> </span>deployment/overlays/tls-backend<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
20672067
</code></pre></div>
20682068
<h2 id="verifying-tls-configuration">Verifying TLS Configuration</h2>
2069+
<div class="admonition note">
2070+
<p class="admonition-title">Application namespace</p>
2071+
<p>The <code>maas-api</code> service is deployed to the platform's application namespace: <code>redhat-ods-applications</code> for RHOAI or <code>opendatahub</code> for ODH. Adjust the namespace in the commands below accordingly.</p>
2072+
</div>
20692073
<h3 id="check-certificate">Check Certificate</h3>
20702074
<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="c1"># View certificate details</span>
2071-
<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>kubectl<span class="w"> </span>get<span class="w"> </span>secret<span class="w"> </span>maas-api-serving-cert<span class="w"> </span>-n<span class="w"> </span>maas-api<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.data.tls\.crt}&#39;</span><span class="w"> </span><span class="se">\</span>
2075+
<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>kubectl<span class="w"> </span>get<span class="w"> </span>secret<span class="w"> </span>maas-api-serving-cert<span class="w"> </span>-n<span class="w"> </span>&lt;application-namespace&gt;<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.data.tls\.crt}&#39;</span><span class="w"> </span><span class="se">\</span>
20722076
<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w"> </span><span class="p">|</span><span class="w"> </span>base64<span class="w"> </span>-d<span class="w"> </span><span class="p">|</span><span class="w"> </span>openssl<span class="w"> </span>x509<span class="w"> </span>-text<span class="w"> </span>-noout
20732077
<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>
20742078
<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="c1"># Check expiry</span>
2075-
<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>kubectl<span class="w"> </span>get<span class="w"> </span>secret<span class="w"> </span>maas-api-serving-cert<span class="w"> </span>-n<span class="w"> </span>maas-api<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.data.tls\.crt}&#39;</span><span class="w"> </span><span class="se">\</span>
2079+
<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>kubectl<span class="w"> </span>get<span class="w"> </span>secret<span class="w"> </span>maas-api-serving-cert<span class="w"> </span>-n<span class="w"> </span>&lt;application-namespace&gt;<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.data.tls\.crt}&#39;</span><span class="w"> </span><span class="se">\</span>
20762080
<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w"> </span><span class="p">|</span><span class="w"> </span>base64<span class="w"> </span>-d<span class="w"> </span><span class="p">|</span><span class="w"> </span>openssl<span class="w"> </span>x509<span class="w"> </span>-enddate<span class="w"> </span>-noout
20772081
</code></pre></div>
20782082
<h3 id="test-https-endpoint">Test HTTPS Endpoint</h3>
20792083
<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="c1"># From within the cluster</span>
20802084
<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>kubectl<span class="w"> </span>run<span class="w"> </span>curl<span class="w"> </span>--rm<span class="w"> </span>-it<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span><span class="se">\</span>
2081-
<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span>curl<span class="w"> </span>-vk<span class="w"> </span>https://maas-api.maas-api.svc:8443/health
2085+
<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span>curl<span class="w"> </span>-vk<span class="w"> </span>https://maas-api.&lt;application-namespace&gt;.svc:8443/health
20822086
<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>
20832087
<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="c1"># Check certificate chain</span>
2084-
<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>openssl<span class="w"> </span>s_client<span class="w"> </span>-connect<span class="w"> </span>maas-api.maas-api.svc:8443<span class="w"> </span>-servername<span class="w"> </span>maas-api.maas-api.svc
2088+
<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>openssl<span class="w"> </span>s_client<span class="w"> </span>-connect<span class="w"> </span>maas-api.&lt;application-namespace&gt;.svc:8443<span class="w"> </span>-servername<span class="w"> </span>maas-api.&lt;application-namespace&gt;.svc
20852089
</code></pre></div>
20862090

20872091

@@ -2105,7 +2109,7 @@ <h3 id="test-https-endpoint">Test HTTPS Endpoint</h3>
21052109
<span class="md-icon" title="Last update">
21062110
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
21072111
</span>
2108-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="January 17, 2026 10:40:44 UTC">January 17, 2026</span>
2112+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="February 4, 2026 18:22:11 UTC">February 4, 2026</span>
21092113
</span>
21102114

21112115

dev/quickstart/index.html

Lines changed: 41 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,17 @@
480480
</span>
481481
</a>
482482

483+
</li>
484+
485+
<li class="md-nav__item">
486+
<a href="#configure-authorino-tls" class="md-nav__link">
487+
<span class="md-ellipsis">
488+
489+
Configure Authorino TLS
490+
491+
</span>
492+
</a>
493+
483494
</li>
484495

485496
<li class="md-nav__item">
@@ -534,15 +545,15 @@
534545
<ul class="md-nav__list">
535546

536547
<li class="md-nav__item">
537-
<a href="#deploy-sample-models-optional" class="md-nav__link">
548+
<a href="#deploy-sample-models" class="md-nav__link">
538549
<span class="md-ellipsis">
539550

540-
Deploy Sample Models (Optional)
551+
Deploy Sample Models
541552

542553
</span>
543554
</a>
544555

545-
<nav class="md-nav" aria-label="Deploy Sample Models (Optional)">
556+
<nav class="md-nav" aria-label="Deploy Sample Models">
546557
<ul class="md-nav__list">
547558

548559
<li class="md-nav__item">
@@ -1599,6 +1610,17 @@
15991610
</span>
16001611
</a>
16011612

1613+
</li>
1614+
1615+
<li class="md-nav__item">
1616+
<a href="#configure-authorino-tls" class="md-nav__link">
1617+
<span class="md-ellipsis">
1618+
1619+
Configure Authorino TLS
1620+
1621+
</span>
1622+
</a>
1623+
16021624
</li>
16031625

16041626
<li class="md-nav__item">
@@ -1653,15 +1675,15 @@
16531675
<ul class="md-nav__list">
16541676

16551677
<li class="md-nav__item">
1656-
<a href="#deploy-sample-models-optional" class="md-nav__link">
1678+
<a href="#deploy-sample-models" class="md-nav__link">
16571679
<span class="md-ellipsis">
16581680

1659-
Deploy Sample Models (Optional)
1681+
Deploy Sample Models
16601682

16611683
</span>
16621684
</a>
16631685

1664-
<nav class="md-nav" aria-label="Deploy Sample Models (Optional)">
1686+
<nav class="md-nav" aria-label="Deploy Sample Models">
16651687
<ul class="md-nav__list">
16661688

16671689
<li class="md-nav__item">
@@ -1781,6 +1803,7 @@ <h2 id="prerequisites">Prerequisites</h2>
17811803
<li>RHCL 1.2 +</li>
17821804
</ul>
17831805
</li>
1806+
<li><strong>Authorino TLS</strong>: Listener TLS must be enabled on Authorino (see <a href="#configure-authorino-tls">Configure Authorino TLS</a>)</li>
17841807
<li><strong>Cluster admin</strong> or equivalent permissions</li>
17851808
<li><strong>Required tools</strong>:<ul>
17861809
<li><code>oc</code> (OpenShift CLI)</li>
@@ -1791,6 +1814,16 @@ <h2 id="prerequisites">Prerequisites</h2>
17911814
</ul>
17921815
</li>
17931816
</ul>
1817+
<h2 id="configure-authorino-tls">Configure Authorino TLS</h2>
1818+
<p>Before deploying MaaS, Authorino's listener TLS must be enabled. This is a platform prerequisite for secure <code>LLMInferenceService</code> communication:</p>
1819+
<ul>
1820+
<li><strong>Gateway → Authorino (Listener TLS)</strong>: Enable TLS on Authorino's gRPC listener for incoming authentication requests</li>
1821+
</ul>
1822+
<p>For step-by-step commands, see <a href="../configuration-and-management/tls-configuration/#authorino-tls-configuration">TLS Configuration: Authorino TLS Configuration</a>.</p>
1823+
<div class="admonition tip">
1824+
<p class="admonition-title">Automated configuration</p>
1825+
<p>The <code>deploy-rhoai-stable.sh</code> script automatically configures all remaining TLS settings after deployment, including Gateway TLS bootstrap and Authorino → maas-api outbound TLS.</p>
1826+
</div>
17941827
<h2 id="quick-start">Quick Start</h2>
17951828
<h3 id="automated-openshift-deployment-recommended">Automated OpenShift Deployment (Recommended)</h3>
17961829
<p>For OpenShift clusters, use the automated deployment script:</p>
@@ -1839,7 +1872,7 @@ <h3 id="verify-deployment">Verify Deployment</h3>
18391872
<a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a>kubectl<span class="w"> </span>get<span class="w"> </span>pods<span class="w"> </span>-n<span class="w"> </span>redhat-ods-applications
18401873
</code></pre></div>
18411874
<h2 id="model-setup-optional">Model Setup (Optional)</h2>
1842-
<h3 id="deploy-sample-models-optional">Deploy Sample Models (Optional)</h3>
1875+
<h3 id="deploy-sample-models">Deploy Sample Models</h3>
18431876
<h4 id="simulator-model-cpu">Simulator Model (CPU)</h4>
18441877
<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nv">PROJECT_DIR</span><span class="o">=</span><span class="k">$(</span>git<span class="w"> </span>rev-parse<span class="w"> </span>--show-toplevel<span class="k">)</span>
18451878
<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>kustomize<span class="w"> </span>build<span class="w"> </span><span class="si">${</span><span class="nv">PROJECT_DIR</span><span class="si">}</span>/docs/samples/models/simulator/<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
@@ -1910,7 +1943,7 @@ <h2 id="next-steps">Next Steps</h2>
19101943
<span class="md-icon" title="Last update">
19111944
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
19121945
</span>
1913-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="January 16, 2026 16:50:32 UTC">January 16, 2026</span>
1946+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="February 4, 2026 18:22:11 UTC">February 4, 2026</span>
19141947
</span>
19151948

19161949

dev/search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)