Directories
¶
| Path | Synopsis |
|---|---|
|
Package allocpolicy is the canonical, dependency-neutral owner of the #1327 GPU allocation-policy descriptor and the shared advertiser vocabulary and tuple-coherence rules (ADR-015, "GKE amendment to the #1327 allocation-policy model").
|
Package allocpolicy is the canonical, dependency-neutral owner of the #1327 GPU allocation-policy descriptor and the shared advertiser vocabulary and tuple-coherence rules (ADR-015, "GKE amendment to the #1327 allocation-policy model"). |
|
Package artifact defines the neutral release inventory and catalog bindings.
|
Package artifact defines the neutral release inventory and catalog bindings. |
|
Package bom builds CycloneDX 1.6 software bills-of-materials describing the container images AICR can deploy.
|
Package bom builds CycloneDX 1.6 software bills-of-materials describing the container images AICR can deploy. |
|
Package bundler provides orchestration for generating deployment bundles from recipes.
|
Package bundler provides orchestration for generating deployment bundles from recipes. |
|
attestation
Package attestation provides bundle attestation using Sigstore signing.
|
Package attestation provides bundle attestation using Sigstore signing. |
|
bundleinfo
Package bundleinfo defines bundle-info.yaml, the bundle-root build record written at the root of every generated deployment bundle.
|
Package bundleinfo defines bundle-info.yaml, the bundle-root build record written at the root of every generated deployment bundle. |
|
checksum
Package checksum provides closed-world SHA256 bundle inventories.
|
Package checksum provides closed-world SHA256 bundle inventories. |
|
config
Package config provides configuration options for bundler implementations.
|
Package config provides configuration options for bundler implementations. |
|
deployer
Package deployer defines the shared interface and types for bundle deployers.
|
Package deployer defines the shared interface and types for bundle deployers. |
|
deployer/argocd
Package argocd provides Argo CD Application generation for recipes.
|
Package argocd provides Argo CD Application generation for recipes. |
|
deployer/argocd/argocdtest
Package argocdtest provides child Application name fixtures shared by the argocd and argocd-helm deployer tests.
|
Package argocdtest provides child Application name fixtures shared by the argocd and argocd-helm deployer tests. |
|
deployer/argocdhelm
Package argocdhelm generates a Helm chart app-of-apps for Argo CD with dynamic install-time values.
|
Package argocdhelm generates a Helm chart app-of-apps for Argo CD with dynamic install-time values. |
|
deployer/deployertest
Package deployertest provides recipe fixtures shared by the deployer tests.
|
Package deployertest provides recipe fixtures shared by the deployer tests. |
|
deployer/fleet
Package fleet generates a Rancher Fleet bundle from AICR recipes, as a GitRepo (ModeGitRepo, the default) or as HelmOps (ModeHelmOp).
|
Package fleet generates a Rancher Fleet bundle from AICR recipes, as a GitRepo (ModeGitRepo, the default) or as HelmOps (ModeHelmOp). |
|
deployer/flux
Package flux provides Flux manifest generation for AICR recipes.
|
Package flux provides Flux manifest generation for AICR recipes. |
|
deployer/helm
Package helm generates per-component Helm bundles from recipe results.
|
Package helm generates per-component Helm bundles from recipe results. |
|
deployer/helmfile
Package helmfile generates a helmfile.yaml release graph from a configured recipe.
|
Package helmfile generates a helmfile.yaml release graph from a configured recipe. |
|
deployer/localformat
Package localformat writes the uniform numbered local-chart bundle layout.
|
Package localformat writes the uniform numbered local-chart bundle layout. |
|
deployer/localformat/localformattest
Package localformattest provides a localformat.ChartPuller for tests.
|
Package localformattest provides a localformat.ChartPuller for tests. |
|
deployer/terraform
Package terraform generates a Terraform module from an AICR recipe: a root module by default, or a child module to call from a configuration that owns the helm provider.
|
Package terraform generates a Terraform module from an AICR recipe: a root module by default, or a child module to call from a configuration that owns the helm provider. |
|
drainscope
Package drainscope owns what NVSentinel's node-drainer may evict and how long it waits: the namespaces a drain never evicts from, and the default drain mode.
|
Package drainscope owns what NVSentinel's node-drainer may evict and how long it waits: the namespaces a drain never evicts from, and the default drain mode. |
|
gatemanifest
Package gatemanifest synthesizes the Kubernetes manifests for a component readiness gate Job (ServiceAccount, RBAC, ConfigMap, Job).
|
Package gatemanifest synthesizes the Kubernetes manifests for a component readiness gate Job (ServiceAccount, RBAC, ConfigMap, Job). |
|
registry
Package registry provides thread-safe registration and retrieval of bundler implementations.
|
Package registry provides thread-safe registration and retrieval of bundler implementations. |
|
result
Package result provides types for tracking bundle generation results.
|
Package result provides types for tracking bundle generation results. |
|
types
Package types defines the type system for bundler implementations.
|
Package types defines the type system for bundler implementations. |
|
verifier
Package verifier implements offline bundle verification with a four-level trust model.
|
Package verifier implements offline bundle verification with a four-level trust model. |
|
Package chainsaw executes Chainsaw-style assertions against a live Kubernetes cluster, in-process.
|
Package chainsaw executes Chainsaw-style assertions against a live Kubernetes cluster, in-process. |
|
validation
Package validation checks Chainsaw YAML without executing assertions.
|
Package validation checks Chainsaw YAML without executing assertions. |
|
chainsawgate
|
|
|
runner
Package runner contains the chainsaw-test evaluation machinery used by the standalone `gate` CLI.
|
Package runner contains the chainsaw-test evaluation machinery used by the standalone `gate` CLI. |
|
Package cli implements the command-line interface for the AICR aicr tool.
|
Package cli implements the command-line interface for the AICR aicr tool. |
|
client
|
|
|
v1
Package aicr is the public, compatibility-reviewed Go library surface for external consumers of the AI Cluster Runtime.
|
Package aicr is the public, compatibility-reviewed Go library surface for external consumers of the AI Cluster Runtime. |
|
Package collector provides interfaces and implementations for collecting system configuration data.
|
Package collector provides interfaces and implementations for collecting system configuration data. |
|
file
Package file provides a configurable parser for line-oriented configuration files (e.g., /etc/default/grub, /etc/os-release, /proc/sys entries).
|
Package file provides a configurable parser for line-oriented configuration files (e.g., /etc/default/grub, /etc/os-release, /proc/sys entries). |
|
gpu
Package gpu collects GPU hardware data via driver-free NFD/PCI enumeration.
|
Package gpu collects GPU hardware data via driver-free NFD/PCI enumeration. |
|
k8s
Package k8s collects Kubernetes cluster configuration data.
|
Package k8s collects Kubernetes cluster configuration data. |
|
network
Package network collects per-hardware-group network topology by ingesting k8s-launch-kit (l8k) cluster-config data and translating it into the NetworkTopology Measurement shape documented in docs/integrator/measurement-api.md.
|
Package network collects per-hardware-group network topology by ingesting k8s-launch-kit (l8k) cluster-config data and translating it into the NetworkTopology Measurement shape documented in docs/integrator/measurement-api.md. |
|
os
Package os collects operating system configuration data.
|
Package os collects operating system configuration data. |
|
systemd
Package systemd collects systemd service configuration data.
|
Package systemd collects systemd service configuration data. |
|
talos
Package talos provides Talos-specific collector implementations used in place of the systemd D-Bus and /proc-based OS collectors when the recipe criteria declares os: talos.
|
Package talos provides Talos-specific collector implementations used in place of the systemd D-Bus and /proc-based OS collectors when the recipe criteria declares os: talos. |
|
Package component provides shared bundler utilities used by pkg/bundler and its deployers.
|
Package component provides shared bundler utilities used by pkg/bundler and its deployers. |
|
Package config defines the AICRConfig file schema accepted by the aicr CLI's --config flag on the snapshot, recipe, bundle, validate, and verify commands.
|
Package config defines the AICRConfig file schema accepted by the aicr CLI's --config flag on the snapshot, recipe, bundle, validate, and verify commands. |
|
Package constraints parses and evaluates constraint expressions (e.g.
|
Package constraints parses and evaluates constraint expressions (e.g. |
|
expr
Package expr parses constraint expressions ("<operator> <value>") and evaluates them against a single actual value.
|
Package expr parses constraint expressions ("<operator> <value>") and evaluates them against a single actual value. |
|
Package corroborate computes the recipe corroboration consensus model and emits the deterministic interim-evidence dashboard (GP4, #1404; user guide docs/user/evidence-dashboard.md).
|
Package corroborate computes the recipe corroboration consensus model and emits the deterministic interim-evidence dashboard (GP4, #1404; user guide docs/user/evidence-dashboard.md). |
|
Package defaults provides centralized configuration constants for the AICR system.
|
Package defaults provides centralized configuration constants for the AICR system. |
|
Package deprecation implements the runtime half of the AICR deprecation channel.
|
Package deprecation implements the runtime half of the AICR deprecation channel. |
|
Package diff compares AICR snapshots to detect configuration drift.
|
Package diff compares AICR snapshots to detect configuration drift. |
|
Package errors provides structured error types for better observability and programmatic error handling across the application.
|
Package errors provides structured error types for better observability and programmatic error handling across the application. |
|
errorstest
Package errorstest provides test assertions on the error code a pkg/errors chain reports.
|
Package errorstest provides test assertions on the error code a pkg/errors chain reports. |
|
Package evidence is an umbrella for AICR's evidence kinds.
|
Package evidence is an umbrella for AICR's evidence kinds. |
|
allowlist
Package allowlist loads and validates the maintained signer allowlist at recipes/evidence/allowlist.yaml.
|
Package allowlist loads and validates the maintained signer allowlist at recipes/evidence/allowlist.yaml. |
|
attestation
Package attestation implements the recipe-test-attestation evidence kind defined in ADR-007 (docs/design/007-recipe-evidence.md).
|
Package attestation implements the recipe-test-attestation evidence kind defined in ADR-007 (docs/design/007-recipe-evidence.md). |
|
canonical
Package canonical holds the recipe YAML canonicalization and subject digest that recipe evidence is built and verified against.
|
Package canonical holds the recipe YAML canonicalization and subject digest that recipe evidence is built and verified against. |
|
cncf
Package cncf renders CNCF AI Conformance evidence markdown from CTRF reports against a published upstream checklist version.
|
Package cncf renders CNCF AI Conformance evidence markdown from CTRF reports against a published upstream checklist version. |
|
cncf/upstreamvalidator
Package upstreamvalidator runs the CNCF AI Conformance submission validator, cncf/k8s-ai-conformance scripts/validate.go, in process at a pinned revision.
|
Package upstreamvalidator runs the CNCF AI Conformance submission validator, cncf/k8s-ai-conformance scripts/validate.go, in process at a pinned revision. |
|
index
Package index is the build-time inventory of committed recipe-evidence pointers.
|
Package index is the build-time inventory of committed recipe-evidence pointers. |
|
internal/boundedio
Package boundedio puts blocking local-filesystem work behind a cancellation boundary so the evidence publish/sign/verify paths cannot hang indefinitely on a dead NFS/FUSE mount.
|
Package boundedio puts blocking local-filesystem work behind a cancellation boundary so the evidence publish/sign/verify paths cannot hang indefinitely on a dead NFS/FUSE mount. |
|
project
Package project synthesizes the source-keyed evidence tree that the GP4 corroborate consensus generator consumes.
|
Package project synthesizes the source-keyed evidence tree that the GP4 corroborate consensus generator consumes. |
|
redact
Package redact minimizes the sensitive operational detail an evidence bundle physically ships, while leaving the cryptographic verification story intact.
|
Package redact minimizes the sensitive operational detail an evidence bundle physically ships, while leaving the cryptographic verification story intact. |
|
verifier
Package verifier implements `aicr evidence verify`: offline verification of a recipe-evidence bundle (v1 or v2) produced by `aicr validate --emit-attestation`.
|
Package verifier implements `aicr evidence verify`: offline verification of a recipe-evidence bundle (v1 or v2) produced by `aicr validate --emit-attestation`. |
|
Package fingerprint extracts a structured cluster identity from a snapshot's collector measurements and compares it against a recipe's criteria.
|
Package fingerprint extracts a structured cluster identity from a snapshot's collector measurements and compares it against a recipe's criteria. |
|
Package header provides common header types for AICR data structures.
|
Package header provides common header types for AICR data structures. |
|
Package health computes per-recipe structural health across the whole criteria matrix, as specified by ADR-009 (Recipe Health Tracking).
|
Package health computes per-recipe structural health across the whole criteria matrix, as specified by ADR-009 (Recipe Health Tracking). |
|
Package helm runs the helm CLI and renders charts with helm template.
|
Package helm runs the helm CLI and renders charts with helm template. |
|
helmtest
Package helmtest provides test helpers for consumers of pkg/helm.
|
Package helmtest provides test helpers for consumers of pkg/helm. |
|
Package inventory reads the installed component inventory from a live cluster and returns it as the component-to-version table an upgrade comparison consumes.
|
Package inventory reads the installed component inventory from a live cluster and returns it as the component-to-version table an upgrade comparison consumes. |
|
Package k8s provides Kubernetes integration for AI Cluster Runtime.
|
Package k8s provides Kubernetes integration for AI Cluster Runtime. |
|
agent
Package agent provides Kubernetes Job deployment for automated snapshot capture.
|
Package agent provides Kubernetes Job deployment for automated snapshot capture. |
|
client
Package client provides a singleton Kubernetes client for efficient cluster interactions.
|
Package client provides a singleton Kubernetes client for efficient cluster interactions. |
|
k8stest
Package k8stest provides test helpers that run against an envtest API server.
|
Package k8stest provides test helpers that run against an envtest API server. |
|
labels
Package labels provides shared Kubernetes label constants used by both the validator (pkg/validator) and the snapshot agent (pkg/k8s/agent), so neither has to import the other to agree on label keys and values.
|
Package labels provides shared Kubernetes label constants used by both the validator (pkg/validator) and the snapshot agent (pkg/k8s/agent), so neither has to import the other to agree on label keys and values. |
|
pod
Package pod provides shared utilities for Kubernetes Job and Pod operations.
|
Package pod provides shared utilities for Kubernetes Job and Pod operations. |
|
Package logging provides structured logging utilities for AICR components.
|
Package logging provides structured logging utilities for AICR components. |
|
Package manifest provides Helm-compatible template rendering for manifest files.
|
Package manifest provides Helm-compatible template rendering for manifest files. |
|
Package measurement provides types and utilities for collecting, comparing, and filtering system measurements from various sources (Kubernetes, GPU, OS, SystemD, NodeTopology, NetworkTopology).
|
Package measurement provides types and utilities for collecting, comparing, and filtering system measurements from various sources (Kubernetes, GPU, OS, SystemD, NodeTopology, NetworkTopology). |
|
Package mirror discovers container images and Helm charts referenced by a recipe and emits the list in formats consumable by air-gap tools (Hauler, Zarf) and general-purpose formats (JSON, YAML).
|
Package mirror discovers container images and Helm charts referenced by a recipe and emits the list in formats consumable by air-gap tools (Hauler, Zarf) and general-purpose formats (JSON, YAML). |
|
Package netutil holds small, dependency-free networking helpers shared across packages that have no other reason to depend on one another (e.g.
|
Package netutil holds small, dependency-free networking helpers shared across packages that have no other reason to depend on one another (e.g. |
|
Package oci provides functionality for packaging and pushing artifacts to OCI-compliant registries.
|
Package oci provides functionality for packaging and pushing artifacts to OCI-compliant registries. |
|
operator
|
|
|
aicrjob
Package aicrjob runs AICR as pinned-image Jobs and parses its frozen artifacts: Job specs, run IDs, the version gate, exit-code mapping, and operator-owned types for Snapshot, RecipeResult, the Helm bundle layout and the upgrade-check report, validated against AICR's published schemas.
|
Package aicrjob runs AICR as pinned-image Jobs and parses its frozen artifacts: Job specs, run IDs, the version gate, exit-code mapping, and operator-owned types for Snapshot, RecipeResult, the Helm bundle layout and the upgrade-check report, validated against AICR's published schemas. |
|
config
Package config holds the operator's installation configuration: the infrastructure the chart sets as values and passes as flags (api.md installation values).
|
Package config holds the operator's installation configuration: the infrastructure the chart sets as values and passes as flags (api.md installation values). |
|
controller
Package controller hosts the resolver, rollout and credentials controllers as thin adapters over the functional packages.
|
Package controller hosts the resolver, rollout and credentials controllers as thin adapters over the functional packages. |
|
defaults
Package defaults holds the operator's named defaults and limits, so no timeout or bound is an unexplained literal at a call site.
|
Package defaults holds the operator's named defaults and limits, so no timeout or bound is an unexplained literal at a call site. |
|
discovery
Package discovery observes Nodes for group membership and homogeneity and orchestrates AICR snapshot and recipe Jobs.
|
Package discovery observes Nodes for group membership and homogeneity and orchestrates AICR snapshot and recipe Jobs. |
|
engine/argocd
Package argocd implements the engine adapter contract for Argo CD, including current-revision readiness without observedGeneration.
|
Package argocd implements the engine adapter contract for Argo CD, including current-revision readiness without observedGeneration. |
|
engine/flux
Package flux implements the engine adapter contract for Flux, a follow-on to the Argo CD adapter.
|
Package flux implements the engine adapter contract for Flux, a follow-on to the Argo CD adapter. |
|
errors
Package errors provides the operator's structured errors.
|
Package errors provides the operator's structured errors. |
|
evidence
Package evidence binds AICR's deployment validation evidence to what the operator rolled out.
|
Package evidence binds AICR's deployment validation evidence to what the operator rolled out. |
|
lifecycle
Package lifecycle implements transition assessment, approval and revocation, removal, orphaning and re-adoption.
|
Package lifecycle implements transition assessment, approval and revocation, removal, orphaning and re-adoption. |
|
manager
Package manager builds the controller-runtime manager that hosts the operator's controllers.
|
Package manager builds the controller-runtime manager that hosts the operator's controllers. |
|
plan
Package plan parses rendered AICR output into plan documents, computes desiredStateDigest and inputDigest, rebuilds plans from live engine objects, and constructs rollout steps.
|
Package plan parses rendered AICR output into plan documents, computes desiredStateDigest and inputDigest, rebuilds plans from live engine objects, and constructs rollout steps. |
|
plugin
Package plugin implements the kubectl aicr plugin: describe, approve, acknowledge and revoke rollouts (api.md#approval), and reproduce a plan's bundle with the AICR CLI.
|
Package plugin implements the kubectl aicr plugin: describe, approve, acknowledge and revoke rollouts (api.md#approval), and reproduce a plan's bundle with the AICR CLI. |
|
registry
Package registry mirrors pinned upstream charts, packages wrapper charts deterministically, and brokers registry credentials.
|
Package registry mirrors pinned upstream charts, packages wrapper charts deterministically, and brokers registry credentials. |
|
registry/registrytest
Package registrytest serves in-memory OCI registries, and fakes ECR's token API, for tests.
|
Package registrytest serves in-memory OCI registries, and fakes ECR's token API, for tests. |
|
resolver
Package resolver turns runtime intent into a plan: it maps ClusterRuntime fields onto AICR recipe and bundle arguments, computes the resolution inputDigest, and assembles the plan from a rendered bundle.
|
Package resolver turns runtime intent into a plan: it maps ClusterRuntime fields onto AICR recipe and bundle arguments, computes the resolution inputDigest, and assembles the plan from a rendered bundle. |
|
version
Package version reports the build identity stamped into the operator binaries at link time.
|
Package version reports the build identity stamped into the operator binaries at link time. |
|
Package recipe provides recipe building and matching functionality.
|
Package recipe provides recipe building and matching functionality. |
|
catalog
Package catalog provides signing and verification for the AICR recipe catalog (registry.yaml + validators/catalog.yaml).
|
Package catalog provides signing and verification for the AICR recipe catalog (registry.yaml + validators/catalog.yaml). |
|
ocisource
Package ocisource provides an owned recipe.DataProvider backed by one immutable-digest-selected OCI recipe artifact.
|
Package ocisource provides an owned recipe.DataProvider backed by one immutable-digest-selected OCI recipe artifact. |
|
oskind
Package oskind is the single source of truth for the string values of the OS recipe criterion.
|
Package oskind is the single source of truth for the string values of the OS recipe criterion. |
|
providertest
Package providertest provides a recipe.DataProvider over an fs.FS and a writer for --data directories, for tests.
|
Package providertest provides a recipe.DataProvider over an fs.FS and a writer for --data directories, for tests. |
|
recipetest
Package recipetest provides recipe-data fixtures for tests in other packages.
|
Package recipetest provides recipe-data fixtures for tests in other packages. |
|
Package runid generates unique run identifiers shared by the validator and the snapshot agent so both subsystems use one format and one generator.
|
Package runid generates unique run identifiers shared by the validator and the snapshot agent so both subsystems use one format and one generator. |
|
Package schema derives JSON Schema documents from the Go types that define AICR's published artifacts.
|
Package schema derives JSON Schema documents from the Go types that define AICR's published artifacts. |
|
Package serializer provides encoding and decoding of measurement data in multiple formats.
|
Package serializer provides encoding and decoding of measurement data in multiple formats. |
|
Package server implements the aicrd HTTP server: the AICR System Configuration Recommendation API defined in api/aicr/v1/server.yaml.
|
Package server implements the aicrd HTTP server: the AICR System Configuration Recommendation API defined in api/aicr/v1/server.yaml. |
|
Package snapshotter captures comprehensive system configuration snapshots.
|
Package snapshotter captures comprehensive system configuration snapshots. |
|
Package testgrid maps a recipe's canonical coordinate to the AICR evidence dashboard (validation.aicr.run) and answers "does this coordinate have a dashboard presence?" — the two facts RQ1 (#1283) and RQ2 (#1284) share.
|
Package testgrid maps a recipe's canonical coordinate to the AICR evidence dashboard (validation.aicr.run) and answers "does this coordinate have a dashboard presence?" — the two facts RQ1 (#1283) and RQ2 (#1284) share. |
|
Package trust manages Sigstore trusted root material for offline attestation verification.
|
Package trust manages Sigstore trusted root material for offline attestation verification. |
|
Package tuning computes the nodewright tuning-status matrix: for each (service, accelerator) the catalog resolves, which tuning profile is applied and the pinned versions of the nodewright nvidia-setup / nvidia-tuned / nvidia-tuning-gke packages.
|
Package tuning computes the nodewright tuning-status matrix: for each (service, accelerator) the catalog resolves, which tuning profile is applied and the pinned versions of the nodewright nvidia-setup / nvidia-tuned / nvidia-tuning-gke packages. |
|
Package uatbroker resolves the UAT reservation registry (infra/uat/reservations.yaml) and expands the nightly version-matrix schedule for the day/night UAT broker (#1274).
|
Package uatbroker resolves the UAT reservation registry (infra/uat/reservations.yaml) and expands the nightly version-matrix schedule for the day/night UAT broker (#1274). |
|
Package upgrade implements ADR-021 component upgrade transition records.
|
Package upgrade implements ADR-021 component upgrade transition records. |
|
Package validator evaluates a recipe's constraints and validation checks against a cluster snapshot and the live cluster.
|
Package validator evaluates a recipe's constraints and validation checks against a cluster snapshot and the live cluster. |
|
catalog
Package catalog provides the declarative validator catalog.
|
Package catalog provides the declarative validator catalog. |
|
ctrf
Package ctrf provides Go types and utilities for the Common Test Report Format (CTRF).
|
Package ctrf provides Go types and utilities for the Common Test Report Format (CTRF). |
|
labels
Package labels provides shared label constants for validation resources.
|
Package labels provides shared label constants for validation resources. |
|
v1
Package v1 defines AICR's validator input format (v1alpha1).
|
Package v1 defines AICR's validator input format (v1alpha1). |
|
Package version provides semantic version parsing and comparison with flexible precision support.
|
Package version provides semantic version parsing and comparison with flexible precision support. |
Click to show internal directories.
Click to hide internal directories.