Kibotos
API 参考kibotos.operator.v1

ArtifactRetentionService

本页列出 kibotos.operator.v1 中 ArtifactRetentionService 的方法及每个方法用到的消息与枚举,由 operator.proto 及其注释生成,注释保持英文。多个服务共用的消息与枚举见 kibotos.operator.v1 类型。

ctrl API使用 Operator 证书调用。调用方式

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/PlanArtifactReclamation一元调用
请求PlanArtifactReclamationRequest

无字段。

响应PlanArtifactReclamationResponse

ApplyArtifactReclamation

POST/kibotos.operator.v1.ArtifactRetentionService/ApplyArtifactReclamation一元调用
请求ApplyArtifactReclamationRequest

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.

响应ApplyArtifactReclamationResponse

GetArtifactReclamation

POST/kibotos.operator.v1.ArtifactRetentionService/GetArtifactReclamation一元调用
请求GetArtifactReclamationRequest
响应GetArtifactReclamationResponse

ListArtifactReclamations

POST/kibotos.operator.v1.ArtifactRetentionService/ListArtifactReclamations一元调用
请求ListArtifactReclamationsRequest
响应ListArtifactReclamationsResponse

RetainLaunchRevision

POST/kibotos.operator.v1.ArtifactRetentionService/RetainLaunchRevision一元调用
请求RetainLaunchRevisionRequest

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.

响应RetainLaunchRevisionResponse

消息与枚举

ArtifactRetentionService 的多个方法用到以下消息与枚举。

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

本页内容