Skip to content

Commit d31bec7

Browse files
Deployed 62cb4e7 to dev with MkDocs 1.6.1 and mike 2.1.3
1 parent b2628ca commit d31bec7

File tree

25 files changed

+108
-108
lines changed

25 files changed

+108
-108
lines changed

dev/404.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1008,7 +1008,7 @@
10081008
<span class="md-ellipsis">
10091009

10101010

1011-
MaaSModel Kinds (future)
1011+
MaaSModelRef Kinds (future)
10121012

10131013

10141014

dev/advanced-administration/limitador-persistence/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1035,7 +1035,7 @@
10351035
<span class="md-ellipsis">
10361036

10371037

1038-
MaaSModel Kinds (future)
1038+
MaaSModelRef Kinds (future)
10391039

10401040

10411041

dev/advanced-administration/observability/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1035,7 +1035,7 @@
10351035
<span class="md-ellipsis">
10361036

10371037

1038-
MaaSModel Kinds (future)
1038+
MaaSModelRef Kinds (future)
10391039

10401040

10411041

dev/advanced-administration/storage-configuration/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1035,7 +1035,7 @@
10351035
<span class="md-ellipsis">
10361036

10371037

1038-
MaaSModel Kinds (future)
1038+
MaaSModelRef Kinds (future)
10391039

10401040

10411041

dev/architecture/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1196,7 +1196,7 @@
11961196
<span class="md-ellipsis">
11971197

11981198

1199-
MaaSModel Kinds (future)
1199+
MaaSModelRef Kinds (future)
12001200

12011201

12021202

dev/configuration-and-management/group-membership-known-issues/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1035,7 +1035,7 @@
10351035
<span class="md-ellipsis">
10361036

10371037

1038-
MaaSModel Kinds (future)
1038+
MaaSModelRef Kinds (future)
10391039

10401040

10411041

dev/configuration-and-management/maas-controller-overview/index.html

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1015,7 +1015,7 @@
10151015
<span class="md-ellipsis">
10161016

10171017

1018-
MaaSModel Kinds (future)
1018+
MaaSModelRef Kinds (future)
10191019

10201020

10211021

@@ -1579,7 +1579,7 @@ <h1 id="maas-controller-overview">MaaS Controller Overview</h1>
15791579
<h2 id="1-what-is-the-maas-controller">1. What Is the MaaS Controller?</h2>
15801580
<p>The <strong>MaaS Controller</strong> is a Kubernetes controller that provides a <strong>subscription-style control plane</strong> for Models-as-a-Service. It lets platform operators define:</p>
15811581
<ul>
1582-
<li><strong>Which models</strong> are exposed through MaaS (via <strong>MaaSModel</strong>).</li>
1582+
<li><strong>Which models</strong> are exposed through MaaS (via <strong>MaaSModelRef</strong>).</li>
15831583
<li><strong>Who can access</strong> those models (via <strong>MaaSAuthPolicy</strong>).</li>
15841584
<li><strong>Per-user/per-group token rate limits</strong> for those models (via <strong>MaaSSubscription</strong>).</li>
15851585
</ul>
@@ -1588,13 +1588,13 @@ <h2 id="1-what-is-the-maas-controller">1. What Is the MaaS Controller?</h2>
15881588
<h2 id="2-high-level-architecture">2. High-Level Architecture</h2>
15891589
<pre class="mermaid"><code>flowchart TB
15901590
subgraph Operator["Platform operator"]
1591-
MaaSModel["MaaSModel"]
1591+
MaaSModelRef["MaaSModelRef"]
15921592
MaaSAuthPolicy["MaaSAuthPolicy"]
15931593
MaaSSubscription["MaaSSubscription"]
15941594
end
15951595

15961596
subgraph Controller["maas-controller"]
1597-
ModelReconciler["MaaSModel\nReconciler"]
1597+
ModelReconciler["MaaSModelRef\nReconciler"]
15981598
AuthReconciler["MaaSAuthPolicy\nReconciler"]
15991599
SubReconciler["MaaSSubscription\nReconciler"]
16001600
end
@@ -1609,7 +1609,7 @@ <h2 id="2-high-level-architecture">2. High-Level Architecture</h2>
16091609
LLMIS["LLMInferenceService\n(KServe)"]
16101610
end
16111611

1612-
MaaSModel --&gt; ModelReconciler
1612+
MaaSModelRef --&gt; ModelReconciler
16131613
MaaSAuthPolicy --&gt; AuthReconciler
16141614
MaaSSubscription --&gt; SubReconciler
16151615

@@ -1621,7 +1621,7 @@ <h2 id="2-high-level-architecture">2. High-Level Architecture</h2>
16211621
HTTPRoute --&gt; TokenRateLimitPolicy
16221622
HTTPRoute --&gt; LLMIS</code></pre>
16231623
<p><strong>Summary:</strong> You declare intent with MaaS CRs; the controller turns that into Gateway/Kuadrant resources that attach to the same HTTPRoute and backend (e.g. KServe LLMInferenceService).</p>
1624-
<p>The <strong>MaaS API</strong> GET /v1/models endpoint uses MaaSModel CRs as its primary source: it lists them in the API namespace, then <strong>validates access</strong> by probing each model’s <code>/v1/models</code> endpoint with the client’s <strong>Authorization header</strong> (passed through as-is). Only models that return 2xx or 405 are included. So the catalogue returned to the client is the set of MaaSModel objects the controller reconciles, filtered to those the client can actually access. No token exchange is performed; the header is forwarded as-is. (Once minting is in place, this may be revisited.)</p>
1624+
<p>The <strong>MaaS API</strong> GET /v1/models endpoint uses MaaSModelRef CRs as its primary source: it lists them in the API namespace, then <strong>validates access</strong> by probing each model’s <code>/v1/models</code> endpoint with the client’s <strong>Authorization header</strong> (passed through as-is). Only models that return 2xx or 405 are included. So the catalogue returned to the client is the set of MaaSModelRef objects the controller reconciles, filtered to those the client can actually access. No token exchange is performed; the header is forwarded as-is. (Once minting is in place, this may be revisited.)</p>
16251625
<hr />
16261626
<h2 id="3-request-flow-end-to-end">3. Request Flow (End-to-End)</h2>
16271627
<pre class="mermaid"><code>sequenceDiagram
@@ -1667,7 +1667,7 @@ <h2 id="4-the-string-trick-authpolicy-tokenratelimitpolicy">4. The “String Tri
16671667
<h2 id="5-what-the-controller-creates-runtime-view">5. What the Controller Creates (Runtime View)</h2>
16681668
<pre class="mermaid"><code>flowchart LR
16691669
subgraph MaaS["MaaS CRs (your intent)"]
1670-
MM["MaaSModel\n(model ref)"]
1670+
MM["MaaSModelRef\n(model ref)"]
16711671
MAP["MaaSAuthPolicy\n(modelRefs + subjects)"]
16721672
MS["MaaSSubscription\n(owner + modelRefs + limits)"]
16731673
end
@@ -1692,7 +1692,7 @@ <h2 id="5-what-the-controller-creates-runtime-view">5. What the Controller Creat
16921692
</thead>
16931693
<tbody>
16941694
<tr>
1695-
<td><strong>MaaSModel</strong></td>
1695+
<td><strong>MaaSModelRef</strong></td>
16961696
<td><strong>HTTPRoute</strong> (or validates KServe-created route for llmisvc)</td>
16971697
</tr>
16981698
<tr>
@@ -1712,12 +1712,12 @@ <h2 id="6-component-diagram-controller-internals">6. Component Diagram (Controll
17121712
subgraph Cluster["Kubernetes cluster"]
17131713
subgraph maas_controller["maas-controller (Deployment)"]
17141714
Manager["Controller Manager"]
1715-
ModelReconciler["MaaSModel\nReconciler"]
1715+
ModelReconciler["MaaSModelRef\nReconciler"]
17161716
AuthReconciler["MaaSAuthPolicy\nReconciler"]
17171717
SubReconciler["MaaSSubscription\nReconciler"]
17181718
end
17191719

1720-
CRDs["CRDs: MaaSModel,\nMaaSAuthPolicy,\nMaaSSubscription"]
1720+
CRDs["CRDs: MaaSModelRef,\nMaaSAuthPolicy,\nMaaSSubscription"]
17211721
RBAC["RBAC: ClusterRole,\nServiceAccount, etc."]
17221722
end
17231723

@@ -1738,17 +1738,17 @@ <h2 id="6-component-diagram-controller-internals">6. Component Diagram (Controll
17381738
<hr />
17391739
<h2 id="7-data-model-simplified">7. Data Model (Simplified)</h2>
17401740
<pre class="mermaid"><code>erDiagram
1741-
MaaSModel ||--o{ HTTPRoute : "creates or validates"
1742-
MaaSModel }o--|| LLMInferenceService : "references (llmisvc)"
1741+
MaaSModelRef ||--o{ HTTPRoute : "creates or validates"
1742+
MaaSModelRef }o--|| LLMInferenceService : "references (llmisvc)"
17431743
MaaSAuthPolicy ||--o{ AuthPolicy : "one per model"
1744-
MaaSAuthPolicy }o--o{ MaaSModel : "modelRefs"
1744+
MaaSAuthPolicy }o--o{ MaaSModelRef : "modelRefs"
17451745
MaaSSubscription ||--o{ TokenRateLimitPolicy : "one per model"
1746-
MaaSSubscription }o--o{ MaaSModel : "modelRefs"
1746+
MaaSSubscription }o--o{ MaaSModelRef : "modelRefs"
17471747
AuthPolicy }o--|| HTTPRoute : "targetRef"
17481748
TokenRateLimitPolicy }o--|| HTTPRoute : "targetRef"
17491749
HTTPRoute }o--|| Gateway : "parentRef"</code></pre>
17501750
<ul>
1751-
<li><strong>MaaSModel</strong>: <code>spec.modelRef</code> = llmisvc or ExternalModel (name, namespace).</li>
1751+
<li><strong>MaaSModelRef</strong>: <code>spec.modelRef</code> = llmisvc or ExternalModel (name, namespace).</li>
17521752
<li><strong>MaaSAuthPolicy</strong>: <code>spec.modelRefs</code> (list of model names), <code>spec.subjects</code> (groups, users).</li>
17531753
<li><strong>MaaSSubscription</strong>: <code>spec.owner</code> (groups, users), <code>spec.modelRefs</code> (model name + token rate limits per model).</li>
17541754
</ul>
@@ -1771,7 +1771,7 @@ <h2 id="8-deployment-and-prerequisites">8. Deployment and Prerequisites</h2>
17711771
Deploy --&gt; Examples</code></pre>
17721772
<ul>
17731773
<li><strong>Namespace</strong>: Controller and default MaaS CRs live in <strong>opendatahub</strong> (configurable).</li>
1774-
<li><strong>Install</strong>: <code>./scripts/deploy.sh</code> installs the full stack including the controller. Optionally run <code>./scripts/install-examples.sh</code> for sample MaaSModel, MaaSAuthPolicy, and MaaSSubscription.</li>
1774+
<li><strong>Install</strong>: <code>./scripts/deploy.sh</code> installs the full stack including the controller. Optionally run <code>./scripts/install-examples.sh</code> for sample MaaSModelRef, MaaSAuthPolicy, and MaaSSubscription.</li>
17751775
</ul>
17761776
<hr />
17771777
<h2 id="9-authentication-current-behavior">9. Authentication (Current Behavior)</h2>
@@ -1792,7 +1792,7 @@ <h2 id="10-summary">10. Summary</h2>
17921792
<tbody>
17931793
<tr>
17941794
<td><strong>What</strong></td>
1795-
<td>MaaS Controller = control plane that reconciles MaaSModel, MaaSAuthPolicy, and MaaSSubscription into Gateway API and Kuadrant resources.</td>
1795+
<td>MaaS Controller = control plane that reconciles MaaSModelRef, MaaSAuthPolicy, and MaaSSubscription into Gateway API and Kuadrant resources.</td>
17961796
</tr>
17971797
<tr>
17981798
<td><strong>Where</strong></td>
@@ -1835,7 +1835,7 @@ <h2 id="10-summary">10. Summary</h2>
18351835
<span class="md-icon" title="Last update">
18361836
<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>
18371837
</span>
1838-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="February 27, 2026 17:58:09 UTC">February 27, 2026</span>
1838+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="March 3, 2026 21:33:09 UTC">March 3, 2026</span>
18391839
</span>
18401840

18411841

0 commit comments

Comments
 (0)