Kibotos
API referencekibotos.operator.v1

ArtifactRetentionService

This page lists the methods of ArtifactRetentionService in kibotos.operator.v1 with the messages and enums each one uses, generated from operator.proto and its comments. Those that several services use are on kibotos.operator.v1 types.

ctrl APICalled with an Operator certificate.How to call it

ArtifactRetentionService is the Operator-only reclamation surface for the artifact store. It derives, from the catalog alone, which manifests and blobs nothing can reach any more, records that as a reviewable plan, and applies a plan whole. It never calls a node, and it never mounts on the Native Workspace endpoint.

PlanArtifactReclamation

POST/kibotos.operator.v1.ArtifactRetentionService/PlanArtifactReclamationUnary
RequestPlanArtifactReclamationRequest

No fields.

ResponsePlanArtifactReclamationResponse

ApplyArtifactReclamation

POST/kibotos.operator.v1.ArtifactRetentionService/ApplyArtifactReclamationUnary
RequestApplyArtifactReclamationRequest

ApplyArtifactReclamationRequest applies one planned run whole. The same command_id with the same run_id replays the result; with a different run_id it is a conflict.

ResponseApplyArtifactReclamationResponse

GetArtifactReclamation

POST/kibotos.operator.v1.ArtifactRetentionService/GetArtifactReclamationUnary
RequestGetArtifactReclamationRequest
ResponseGetArtifactReclamationResponse

ListArtifactReclamations

POST/kibotos.operator.v1.ArtifactRetentionService/ListArtifactReclamationsUnary
RequestListArtifactReclamationsRequest
ResponseListArtifactReclamationsResponse

RetainLaunchRevision

POST/kibotos.operator.v1.ArtifactRetentionService/RetainLaunchRevisionUnary
RequestRetainLaunchRevisionRequest

RetainLaunchRevisionRequest extends the retention of one Launch revision. Retention only ever grows: a retained_until earlier than the one on record is refused. A retained Launch keeps itself and both of its upstream revisions out of every plan.

ResponseRetainLaunchRevisionResponse

Messages and enums

Several methods of ArtifactRetentionService use these messages and enums.

ArtifactBlob

ArtifactBlob is one content-addressed object; size is what the manifest declares for it. No locator is ever returned.

ArtifactReclamationEntry

ArtifactReclamationEntry is one manifest a plan proposes to delete.

ArtifactReclamationPlan

ArtifactReclamationPlan is what a run proposes. digest identifies entries and blobs; the counts are derived.

ArtifactReclamationSkip

ArtifactReclamationSkip is one entry the execution left alone because it was alive again when its turn came.

ArtifactReclamationResult

ArtifactReclamation

ArtifactReclamationTrigger

ArtifactReclamationTrigger says who started a run: an Operator through this service, or ctrl's own periodic reclamation.

  • ARTIFACT_RECLAMATION_TRIGGER_UNSPECIFIED= 0
  • ARTIFACT_RECLAMATION_TRIGGER_OPERATOR= 1
  • ARTIFACT_RECLAMATION_TRIGGER_AUTOMATIC= 2

ArtifactReclamationStatus

ArtifactReclamationStatus is the life of one run. PLANNED is a reviewed plan nobody has applied; RUNNING holds the single execution slot; the other three are final. ABANDONED means the executing ctrl let its lease expire and a later run took the slot over.

  • ARTIFACT_RECLAMATION_STATUS_UNSPECIFIED= 0
  • ARTIFACT_RECLAMATION_STATUS_PLANNED= 1
  • ARTIFACT_RECLAMATION_STATUS_RUNNING= 2
  • ARTIFACT_RECLAMATION_STATUS_COMPLETED= 3
  • ARTIFACT_RECLAMATION_STATUS_FAILED= 4
  • ARTIFACT_RECLAMATION_STATUS_ABANDONED= 5

ArtifactManifestKind

  • ARTIFACT_MANIFEST_KIND_UNSPECIFIED= 0
  • ARTIFACT_MANIFEST_KIND_TEMPLATE= 1
  • ARTIFACT_MANIFEST_KIND_PLATFORM= 2
  • ARTIFACT_MANIFEST_KIND_LAUNCH= 3

ArtifactReclamationReason

ArtifactReclamationReason says why a manifest is reclaimable. A Template or Platform revision only ever because it was withdrawn; a Launch only because one of its upstream revisions was.

  • ARTIFACT_RECLAMATION_REASON_UNSPECIFIED= 0
  • ARTIFACT_RECLAMATION_REASON_WITHDRAWN= 1
  • ARTIFACT_RECLAMATION_REASON_UPSTREAM_WITHDRAWN= 2

On this page