ccluster-py 0.0.1__py3-none-any.whl

ccluster/__init__.py

@@ -0,0 +1,19 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Pydantic models for the ccluster.nvidia.com API and the catalog's chart values.
+
+Everything under ccluster.v1alpha1 and ccluster.catalogs.cluster_base is generated by
+`make python-generate` from the CRDs and the catalog's Go packages; see python/README.md.
+"""

ccluster/catalogs/__init__.py

@@ -0,0 +1,65 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Helm chart catalog, as typed values.
+
+Each chart under ccluster.catalogs.cluster_base has a Values model and a CHART path,
+generated from the Go package beside the chart. entry() turns one of those into the
+ComponentEntry fields of a CCLComponentSet component, as catalogs.Entry does in Go.
+"""
+
+from typing import Any
+
+from pydantic import BaseModel
+
+from ccluster.v1alpha1 import ComponentSpec, LocalObjectReference
+
+__all__ = ["component", "entry"]
+
+
+def entry(chart: str, namespace: str, values: BaseModel | None) -> dict[str, Any]:
+    """Return the chart, namespace and values fields of a component.
+
+    values is dumped by alias with None fields left out, which is the shape Helm
+    expects and the shape the Go catalog produces. An empty result is dropped rather
+    than stored: the operator omits the Application's helm block when values is unset,
+    and an empty object would defeat that. The required values of a chart (only
+    teleport-kube-agent has any) are checked when its Values is constructed.
+    """
+    out: dict[str, Any] = {"chart": chart, "namespace": namespace}
+    if values is not None:
+        dumped = values.model_dump(by_alias=True, exclude_none=True)
+        if dumped:
+            out["values"] = dumped
+    return out
+
+
+def component(
+    name: str,
+    infra_plane: str,
+    chart: str,
+    namespace: str,
+    values: BaseModel | None = None,
+) -> ComponentSpec:
+    """Build one CCLComponentSet component from a chart's typed values.
+
+    chart is the module's CHART constant. The component's name and the infra plane it
+    is deployed to are the caller's, as is the namespace it installs into: none of
+    those are facts about the chart.
+    """
+    return ComponentSpec(
+        name=name,
+        infra_plane_ref=LocalObjectReference(name=infra_plane),
+        **entry(chart, namespace, values),
+    )

ccluster/catalogs/cluster_base/__init__.py

@@ -0,0 +1,41 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""The cluster_base catalog: one subpackage per chart, each with a Values
+model and its CHART path."""
+
+from . import argo_rollouts, cert_manager, external_dns, final_stack, fluent_bit, gpu_operator, ingress_nginx, istio, keda, kube_prometheus_stack, longhorn, metrics_server, network_operator, opentelemetry_collector, prometheus_adapter, spire, spire_crds, teleport_kube_agent
+
+__all__ = [
+    "argo_rollouts",
+    "cert_manager",
+    "external_dns",
+    "final_stack",
+    "fluent_bit",
+    "gpu_operator",
+    "ingress_nginx",
+    "istio",
+    "keda",
+    "kube_prometheus_stack",
+    "longhorn",
+    "metrics_server",
+    "network_operator",
+    "opentelemetry_collector",
+    "prometheus_adapter",
+    "spire",
+    "spire_crds",
+    "teleport_kube_agent",
+]

ccluster/catalogs/cluster_base/argo_rollouts/__init__.py

@@ -0,0 +1,37 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""Values of the catalogs/cluster_base/argo_rollouts chart, generated from its Go package."""
+
+from typing import Final
+
+from .values import (
+    ChartValues,
+    Controller,
+    Dashboard,
+    Values,
+)
+
+__all__ = [
+    "CHART",
+    "ChartValues",
+    "Controller",
+    "Dashboard",
+    "Values",
+]
+
+# CHART is the chart's directory, relative to the root of the catalog repository.
+CHART: Final = "catalogs/cluster_base/argo_rollouts"

ccluster/catalogs/cluster_base/argo_rollouts/values.py

@@ -0,0 +1,79 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Controller(BaseModel):
+    """
+    Controller configures the rollouts controller.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    replicas: int | None = None
+    """
+    Replicas is the controller replica count. The chart ships 2.
+    """
+
+
+class Dashboard(BaseModel):
+    """
+    Dashboard configures the rollouts dashboard.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    enabled: bool | None = None
+    """
+    Enabled turns the dashboard on. The chart ships it off.
+    """
+
+
+class ChartValues(BaseModel):
+    """
+    ChartValues are the upstream argo-rollouts values worth setting per cluster.
+    Anything not set here comes from catalogs/cluster_base/argo_rollouts/values.yaml.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    controller: Controller | None = None
+    dashboard: Dashboard | None = None
+
+
+class Values(BaseModel):
+    """
+    Values is the top-level values document for catalogs/cluster_base/argo_rollouts.
+    Its single key is the upstream chart's alias, because this chart wraps it as a
+    dependency — which is the only reason the nesting exists.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    argo_rollouts: Annotated[ChartValues | None, Field(alias="argo-rollouts")] = None

ccluster/catalogs/cluster_base/cert_manager/__init__.py

@@ -0,0 +1,37 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""Values of the catalogs/cluster_base/cert_manager chart, generated from its Go package."""
+
+from typing import Final
+
+from .values import (
+    ChartValues,
+    PrometheusValues,
+    Toggle,
+    Values,
+)
+
+__all__ = [
+    "CHART",
+    "ChartValues",
+    "PrometheusValues",
+    "Toggle",
+    "Values",
+]
+
+# CHART is the chart's directory, relative to the root of the catalog repository.
+CHART: Final = "catalogs/cluster_base/cert_manager"

ccluster/catalogs/cluster_base/cert_manager/values.py

@@ -0,0 +1,85 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Toggle(BaseModel):
+    """
+    Toggle is a subchart's enable flag.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    enabled: bool | None = None
+    """
+    Enabled turns the feature on.
+    """
+
+
+class PrometheusValues(BaseModel):
+    """
+    PrometheusValues configures cert-manager's metrics scraping.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    enabled: bool | None = None
+    servicemonitor: Toggle | None = None
+    """
+    ServiceMonitor is spelled lower-case in this chart, unlike every other
+    chart in the catalog.
+    """
+
+
+class ChartValues(BaseModel):
+    """
+    ChartValues are the upstream cert-manager values worth setting per cluster.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    replica_count: Annotated[int | None, Field(alias="replicaCount")] = None
+    """
+    ReplicaCount is the controller replica count. The chart ships 2.
+    """
+    prometheus: PrometheusValues | None = None
+    """
+    Prometheus scraping is shipped off, because the ServiceMonitor CRD only
+    exists once kube-prometheus-stack is deployed. Enable it after that.
+    """
+
+
+class Values(BaseModel):
+    """
+    Values is the top-level values document for catalogs/cluster_base/cert_manager.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    cert_manager: Annotated[ChartValues | None, Field(alias="cert-manager")] = None

ccluster/catalogs/cluster_base/external_dns/__init__.py

@@ -0,0 +1,39 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""Values of the catalogs/cluster_base/external_dns chart, generated from its Go package."""
+
+from typing import Final
+
+from .values import (
+    ChartValues,
+    Provider,
+    ServiceAccount,
+    Toggle,
+    Values,
+)
+
+__all__ = [
+    "CHART",
+    "ChartValues",
+    "Provider",
+    "ServiceAccount",
+    "Toggle",
+    "Values",
+]
+
+# CHART is the chart's directory, relative to the root of the catalog repository.
+CHART: Final = "catalogs/cluster_base/external_dns"

ccluster/catalogs/cluster_base/external_dns/values.py

@@ -0,0 +1,115 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Provider(BaseModel):
+    """
+    Provider is the DNS provider external-dns talks to.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    name: str | None = None
+
+
+class ServiceAccount(BaseModel):
+    """
+    ServiceAccount configures the identity external-dns runs as.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    create: bool | None = None
+    """
+    Create is shipped true for standalone testing. Set it false and
+    pre-create the account, with IRSA for instance, in production.
+    """
+    name: str | None = None
+
+
+class Toggle(BaseModel):
+    """
+    Toggle is a subchart's enable flag.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    enabled: bool | None = None
+    """
+    Enabled turns the feature on.
+    """
+
+
+class ChartValues(BaseModel):
+    """
+    ChartValues are the upstream external-dns values worth setting per cluster.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    provider: Provider | None = None
+    """
+    Provider is the DNS provider. The chart ships aws; switch it and supply
+    the matching credentials through the service account.
+    """
+    domain_filters: Annotated[list[str] | None, Field(alias="domainFilters")] = None
+    """
+    DomainFilters constrains external-dns to these zones. Unset, it manages
+    every zone the credentials can reach.
+    """
+    txt_owner_id: Annotated[str | None, Field(alias="txtOwnerId")] = None
+    """
+    TxtOwnerID identifies this instance's TXT ownership records. Two
+    clusters sharing a zone must not share it.
+    """
+    extra_args: Annotated[list[str] | None, Field(alias="extraArgs")] = None
+    """
+    ExtraArgs is where --zone-id-filter goes to constrain Route53 changes
+    to a single hosted zone.
+    """
+    service_account: Annotated[ServiceAccount | None, Field(alias="serviceAccount")] = (
+        None
+    )
+    service_monitor: Annotated[Toggle | None, Field(alias="serviceMonitor")] = None
+    """
+    ServiceMonitor requires the kube-prometheus-stack CRDs.
+    """
+
+
+class Values(BaseModel):
+    """
+    Values is the top-level values document for catalogs/cluster_base/external_dns.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )
+    external_dns: Annotated[ChartValues | None, Field(alias="external-dns")] = None

ccluster/catalogs/cluster_base/final_stack/__init__.py

@@ -0,0 +1,31 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""Values of the catalogs/cluster_base/final_stack chart, generated from its Go package."""
+
+from typing import Final
+
+from .values import (
+    Values,
+)
+
+__all__ = [
+    "CHART",
+    "Values",
+]
+
+# CHART is the chart's directory, relative to the root of the catalog repository.
+CHART: Final = "catalogs/cluster_base/final_stack"

ccluster/catalogs/cluster_base/final_stack/values.py

@@ -0,0 +1,41 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict
+
+
+class Values(BaseModel):
+    """
+    Values is the top-level values document for catalogs/cluster_base/final_stack.
+
+    It is empty, and that is a known gap rather than a chart with nothing to configure.
+    This chart wraps no upstream dependency and has no chart-level values: its templates
+    consume only .Values.global.cluster.domain, which every one of its five resources
+    interpolates — the cluster issuers, the OIDC discovery Ingress, and the four
+    ClusterSPIFFEIDs.
+
+    Global values are not modelled by this catalog yet. Until they are, this component
+    renders against the chart's own defaults and the resources it produces will carry
+    the placeholder domain, so a caller that needs a real one has to set
+    global.cluster.domain on the CCLComponentSet component's values by hand.
+    """
+
+    model_config = ConfigDict(
+        extra="forbid",
+        populate_by_name=True,
+    )

ccluster/catalogs/cluster_base/fluent_bit/__init__.py

@@ -0,0 +1,37 @@
+# Copyright 2026 NVIDIA CORPORATION & AFFILIATES.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Code generated by `make python-generate`. DO NOT EDIT.
+
+"""Values of the catalogs/cluster_base/fluent_bit chart, generated from its Go package."""
+
+from typing import Final
+
+from .values import (
+    ChartValues,
+    Config,
+    ServiceAccount,
+    Values,
+)
+
+__all__ = [
+    "CHART",
+    "ChartValues",
+    "Config",
+    "ServiceAccount",
+    "Values",
+]
+
+# CHART is the chart's directory, relative to the root of the catalog repository.
+CHART: Final = "catalogs/cluster_base/fluent_bit"