Conditions Reference

Conditions Reference#

Every AIM resource reports its state through standard Kubernetes conditions. This page catalogs all conditions, their reasons, and what triggers them.

Reading Conditions#

kubectl get aimservice <name> -o jsonpath='{.status.conditions}' | jq

Each condition has:

  • type — The condition name (e.g., Ready)

  • status — True, False, or Unknown

  • reason — Machine-readable cause

  • message — Human-readable description

  • lastTransitionTime — When the status last changed

Framework Conditions#

These conditions are managed by the reconciliation framework and appear on all AIM resources.

DependenciesReachable#

Whether upstream dependencies (referenced models, templates, configs) can be fetched.

Status

Reason

Description

True

Reachable

All dependencies are reachable

False

InfrastructureError

Cannot reach one or more dependencies

AuthValid#

Whether authentication and authorization for referenced secrets and registries are valid.

Status

Reason

Description

True

AuthenticationValid

Authentication and authorization successful

False

AuthError

Authentication or authorization failure

ConfigValid#

Whether the resource’s spec is valid and all referenced resources exist.

Status

Reason

Description

True

ConfigurationValid

Configuration is valid

False

InvalidSpec

Configuration validation failed

False

ReferenceNotFound

A referenced resource does not exist

Ready#

Overall readiness — the aggregate of all other conditions and component health.

Status

Reason

Description

True

AllComponentsReady

All components are ready

False

ComponentsNotReady

One or more components are not ready

False

Progressing

Waiting for components to become ready

AIMService Conditions#

In addition to the framework conditions, AIMService reports component-specific conditions.

ModelReady#

Status

Reason

Description

True

ModelResolved

Model found and ready

False

ModelNotFound

Referenced model does not exist

False

ModelNotReady

Model exists but is not ready

False

CreatingModel

Auto-creating a model from image

TemplateReady#

Status

Reason

Description

True

Resolved

Template found and ready

False

TemplateNotFound

No matching template found

False

TemplateNotReady

Template exists but is not ready

False

TemplateSelectionAmbiguous

Multiple templates scored equally

RuntimeConfigReady#

Status

Reason

Description

True

RuntimeConfigResolved

Runtime config found

False

ReferenceNotFound

Referenced runtime config does not exist

CacheReady#

Status

Reason

Description

True

CacheReady

Model cache is populated

False

CacheNotReady

Cache exists but download is incomplete

False

CacheFailed

Cache download failed

False

CacheLost

Previously-ready cache is no longer available

False

CacheCreating

Creating template cache

InferenceServiceReady#

Status

Reason

Description

True

RuntimeReady

KServe InferenceService is serving

False

CreatingRuntime

Creating or updating InferenceService

InferenceServicePodsReady#

Tracks whether the predictor pods are running and ready.

HTTPRouteReady#

Status

Reason

Description

True

HTTPRouteAccepted

HTTPRoute accepted by the Gateway

False

HTTPRoutePending

HTTPRoute exists but is still pending acceptance

False

PathTemplateInvalid

Path template failed to resolve

False

GatewayNotConfigured

Routing enabled but no gatewayRef configured

HPAReady#

Status

Reason

Description

True

HPAOperational

HPA is active and metrics are available

False

HPANotFound

Waiting for KEDA to create HPA

False

WaitingForMetrics

InferenceService not ready yet; metrics unavailable

AIMModel / AIMClusterModel Conditions#

Ready#

Status

Reason

Description

True

AllTemplatesReady

All discovered templates are ready

True

SomeTemplatesReady

At least one template is ready

True

NoTemplatesExpected

Model has no templates (by design)

False

SomeTemplatesDegraded

Some templates are degraded

False

TemplatesProgressing

Templates are still being discovered

False

AllTemplatesFailed

All templates failed

False

NoTemplatesAvailable

No templates available for this model

False

AwaitingMetadata

Waiting for model metadata extraction

False

CreatingTemplates

Creating service templates

False

MetadataExtractionFailed

Failed to extract model metadata

AIMServiceTemplate / AIMClusterServiceTemplate Conditions#

Discovered#

Status

Reason

Description

True

DiscoveryComplete

Profiles successfully discovered

True

InlineModelSources

Template has inline model sources (no discovery needed)

False

AwaitingDiscovery

Discovery job not yet complete

False

DiscoveryFailed

Discovery job failed

CacheReady#

Status

Reason

Description

True

AllCachesReady

All template caches are ready

False

CreatingCaches

Creating caches

False

CachesNotReady

Some caches are not ready

False

NoCaches

No caches exist

ModelFound#

Whether the referenced model exists and is accessible.

AIMTemplateCache Conditions#

TemplateFound#

Whether the parent template exists and is accessible.

ArtifactsReady#

Status

Reason

Description

True

AllCachesReady

All artifacts downloaded

False

CreatingCaches

Creating artifact resources

False

CachesNotReady

Some artifacts not ready

AIMArtifact Conditions#

Ready#

Status

Reason

Description

True

Verified

Download complete and verified

False

Downloading

Download in progress

False

Verifying

Verifying downloaded data

Condition Polarity#

All conditions follow positive polarity — status: True means healthy. When building dashboards or alerting:

  • Green: condition status: True

  • Yellow: condition status: False with reason containing Progressing, Creating, Awaiting

  • Red: condition status: False with reason containing Failed, Error, NotFound, Invalid