Skip to content

The v1 docs follow nauthera-server's main branch and its 0.x releases on the way to 1.0, so fields and APIs can still change.

v1

Operator failure reasons

Docs version v1 (main)Nauthera is pre-1.0, in a design-partner program

One runbook per reason the Kubernetes operator leaves on a resource's Ready condition when it cannot reconcile it, as kubectl describe shows it.

ReasonWhat it means
CredentialUnavailableThe operator cannot use its own client certificate or key; its pod is not ready, and a resource it reconciles is Ready=False, Pending.
TrustAnchorUnavailableThe operator has no usable CA to verify the server with; its pod is not ready, and a resource it reconciles is Ready=False, Pending.
UnreachableNo answer came back from the server's control plane; the operator's pod is not ready, and a resource it reconciles is Ready=False, Pending.
RefusedThe server answered and refused the call; a resource is Ready=False (Error, or Pending while retried), or the operator's pod is not ready.
UnsupportedThe server serves a control-plane contract outside the operator's range; the operator's pod is not ready, and a resource it reconciles is Ready=False, Pending.
SecretUndeliverableThe server holds an OIDCClient's secret, and the operator could not write it into the Secret; the OIDCClient is Ready=False, Error or Pending.
StatusNotWrittenAn outcome could not be written to the resource's status; a Warning event on the resource, with no condition of its own.
ClientNotRemovedAn OIDCClient being deleted under deletionPolicy Delete is still registered on the server; it is Ready=False in phase Deleting.
DriftedAn OIDCClient or Branding was changed, or removed, on the server by something other than the operator; it is Ready=False, Error, and the change is not written over.
NamespaceNotCoveredA namespaced resource is in a namespace the operator's connection does not carry; it is Ready=False, Error, and nothing is sent to the server.
NamespaceNotAdmittedA namespaced resource is in a namespace no organization admits, or spec.organization names one that does not admit it; it is Ready=False, Error, and nothing is sent to the server.
OrganizationAmbiguousA namespaced resource names no organization in a namespace that several organizations admit; it is Ready=False, Error, and nothing is sent to the server.
OrganizationNotReadyA namespaced resource belongs to an Organization that has no issuer yet; it is Ready=False, Pending, and is sent once the organization is.
OrganizationChangedA namespaced resource is held by the server in one organization and its namespace now configures another; it is Ready=False, Error, and nothing is sent.
AwaitingBrokerA BrokerMembership on the member's side names a broker that has not invited the member; it is Ready=False, Pending, and is sent again every minute.
MembershipNotEndedA BrokerMembership is being deleted and the server has not ended the membership; it stays in phase Deleting until it does.
FixedAtCreationAn Organization differs from its resource in FIPS mode, which is fixed at creation; it is Ready=False, Error, and nothing is written.
OrganizationNotRemovedAn Organization being deleted under deletionPolicy Delete is still on the server; it is Ready=False in phase Deleting.
BrandingNotRemovedA Branding being deleted is still on the server; it is Ready=False in phase Deleting.
SecretNotFoundThe Secret an IdentityProvider, LDAPDirectory or OIDCClient names does not exist; the resource is Ready=False, Error, and nothing is sent.
SecretKeyMissingThe Secret an IdentityProvider, LDAPDirectory or OIDCClient names holds nothing under the key it names; the resource is Ready=False, Error, and nothing is sent.
SecretPaddedAn IdentityProvider's or OIDCClient's client secret, or an LDAPDirectory's bind password, begins or ends with whitespace; the resource is Ready=False, Error, and nothing is sent.
ProviderNotRemovedAn IdentityProvider being deleted under deletionPolicy Delete is still registered on the server; it is Ready=False in phase Deleting.
ConfigMapNotFoundThe ConfigMap an LDAPDirectory's spec.caBundleRef names does not exist; the LDAPDirectory is Ready=False, Error, and nothing is sent.
ConfigMapKeyMissingThe ConfigMap an LDAPDirectory names holds nothing under the key spec.caBundleRef names; the LDAPDirectory is Ready=False, Error, and nothing is sent.
DirectoryNotRemovedAn LDAPDirectory being deleted under deletionPolicy Delete is still registered on the server; it is Ready=False in phase Deleting.