Documentation
¶
Index ¶
- type Store
- func (s *Store) AcquireNextOperation(ctx context.Context) (*control.Operation, error)
- func (s *Store) ActivateOperation(ctx context.Context, kind control.OperationKind, id string) error
- func (s *Store) ActivateProjectImage(ctx context.Context, principal control.Principal, projectID, image string) (control.Project, error)
- func (s *Store) ActiveResourceScope(ctx context.Context) (control.ResourceScope, bool, error)
- func (s *Store) AddProjectMember(ctx context.Context, principal control.Principal, ...) error
- func (s *Store) AppendResourceSample(ctx context.Context, sample control.ResourceSample) error
- func (s *Store) Audit(ctx context.Context, principal control.Principal, ...) error
- func (s *Store) Authenticate(ctx context.Context, token string) (control.Principal, error)
- func (s *Store) AuthorizeProject(ctx context.Context, principal control.Principal, selector string) (control.Project, error)
- func (s *Store) Backup(ctx context.Context, output string) error
- func (s *Store) BeginOperationCleanup(ctx context.Context, kind control.OperationKind, id string) error
- func (s *Store) Bootstrap(ctx context.Context, input control.Bootstrap) (control.BootstrapResult, error)
- func (s *Store) Build(ctx context.Context, id string) (control.Build, error)
- func (s *Store) CancelQueuedOperation(ctx context.Context, kind control.OperationKind, id string) (bool, error)
- func (s *Store) CapacityImagePolicies(ctx context.Context) ([]capacity.ImagePolicy, error)
- func (s *Store) ChangesAfter(ctx context.Context, revision int64) ([]control.ControlChange, error)
- func (s *Store) Check(ctx context.Context) error
- func (s *Store) ClaimOperationCleanup(ctx context.Context) (*control.Operation, error)
- func (s *Store) Close() error
- func (s *Store) CompactResourceSamples(ctx context.Context, rawBefore, rollupBefore time.Time) error
- func (s *Store) CompleteOperationCleanup(ctx context.Context, kind control.OperationKind, id string) error
- func (s *Store) CreateBuild(ctx context.Context, projectID string, idempotency control.Idempotency) (control.Build, bool, error)
- func (s *Store) CreateDeviceToken(ctx context.Context, principal control.Principal, ...) (control.IssuedDeviceToken, error)
- func (s *Store) CreateEnrollmentCode(ctx context.Context, principal control.Principal, userID, deviceName string, ...) (control.IssuedEnrollmentCode, error)
- func (s *Store) CreateGitHubTrust(ctx context.Context, principal control.Principal, trust control.GitHubTrust) (control.GitHubTrust, error)
- func (s *Store) CreatePreparedJob(ctx context.Context, input control.PrepareJob, idempotency control.Idempotency) (control.Job, bool, error)
- func (s *Store) CreateProject(ctx context.Context, principal control.Principal, slug, name string) (control.Project, error)
- func (s *Store) CreateProjectSession(ctx context.Context, projectID, subject string, expiresAt time.Time) (control.IssuedAccessToken, error)
- func (s *Store) CreateUser(ctx context.Context, principal control.Principal, name string, admin bool) (control.User, error)
- func (s *Store) CurrentRevision(ctx context.Context) (int64, error)
- func (s *Store) EmergencyStopActiveOperation(ctx context.Context, message string) (*control.Operation, error)
- func (s *Store) ExchangeEnrollmentCode(ctx context.Context, code string) (control.IssuedDeviceToken, control.EnrollmentCode, error)
- func (s *Store) FailJob(ctx context.Context, id, message string) (control.Job, error)
- func (s *Store) FinishBuild(ctx context.Context, id string, status control.BuildStatus, exitCode int) (control.Build, error)
- func (s *Store) Initialized(ctx context.Context) (bool, error)
- func (s *Store) Job(ctx context.Context, id string) (control.Job, error)
- func (s *Store) ListAuditEvents(ctx context.Context, principal control.Principal, projectID string, limit int) ([]control.AuditEvent, error)
- func (s *Store) ListBuilds(ctx context.Context, projectID string, limit int) ([]control.Build, error)
- func (s *Store) ListDeviceTokens(ctx context.Context, principal control.Principal) ([]control.DeviceToken, error)
- func (s *Store) ListGitHubTrusts(ctx context.Context, principal control.Principal, projectSelector string) ([]control.GitHubTrust, error)
- func (s *Store) ListJobs(ctx context.Context, projectID string, pageSize int, pageToken string) (control.JobPage, error)
- func (s *Store) ListProjectImageHistory(ctx context.Context, projectID string) ([]control.ProjectImageEvent, error)
- func (s *Store) ListProjects(ctx context.Context, principal control.Principal) ([]control.Project, error)
- func (s *Store) ListQueue(ctx context.Context, principal control.Principal) ([]control.QueueOperation, error)
- func (s *Store) ListResourceRollups(ctx context.Context, filter control.ResourceFilter, limit int) ([]control.ResourceRollup, error)
- func (s *Store) ListResourceSamples(ctx context.Context, filter control.ResourceFilter, limit int) ([]control.ResourceSample, error)
- func (s *Store) ListResourceSummaries(ctx context.Context, projectID string, limit int) ([]control.ResourceSummary, error)
- func (s *Store) MatchGitHubTrust(ctx context.Context, projectSelector string, claims control.GitHubClaims) (control.GitHubTrust, error)
- func (s *Store) Operation(ctx context.Context, kind control.OperationKind, id string) (control.Operation, error)
- func (s *Store) OperationActive(ctx context.Context, kind string, id string) bool
- func (s *Store) OperationState(ctx context.Context, kind control.OperationKind, id string) (control.OperationState, error)
- func (s *Store) ProjectMemberCount(ctx context.Context, projectID string) (int, error)
- func (s *Store) QueueJob(ctx context.Context, id, rootDigest string) (control.Job, error)
- func (s *Store) RecordOperationCleanupFailure(ctx context.Context, kind control.OperationKind, id, message string) error
- func (s *Store) RecordSecretAccess(ctx context.Context, projectID, jobID, name string) error
- func (s *Store) RenewOperationLease(ctx context.Context, kind control.OperationKind, id string) error
- func (s *Store) RequestJobCancellation(ctx context.Context, id string) (control.Job, error)
- func (s *Store) RequeueAdmittingOperation(ctx context.Context, kind control.OperationKind, id string) error
- func (s *Store) ResourceBaseline(ctx context.Context, kind control.OperationKind, id string) (operationcleanup.ResourceSet, error)
- func (s *Store) ResourceSummary(ctx context.Context, filter control.ResourceFilter) (control.ResourceSummary, error)
- func (s *Store) RevokeDeviceToken(ctx context.Context, principal control.Principal, id string) error
- func (s *Store) RevokeGitHubTrust(ctx context.Context, principal control.Principal, id string) error
- func (s *Store) RollbackProjectImage(ctx context.Context, principal control.Principal, projectID string) (control.Project, error)
- func (s *Store) Root() string
- func (s *Store) SaveResourceBaseline(ctx context.Context, kind control.OperationKind, id string, ...) error
- func (s *Store) ScheduledJobs(ctx context.Context) ([]control.Job, error)
- func (s *Store) SetProjectImagePolicy(ctx context.Context, principal control.Principal, projectID string, allow bool) (control.Project, error)
- func (s *Store) StaleBuilds(ctx context.Context, before time.Time) ([]control.Build, error)
- func (s *Store) StalePreparingJobs(ctx context.Context, before time.Time) ([]control.Job, error)
- func (s *Store) StartJob(ctx context.Context, id, rootDigest string) (control.Job, error)
- func (s *Store) SubscribeChanges() (<-chan struct{}, func())
- func (s *Store) SyncJob(ctx context.Context, id string, remote protocol.Job) (control.Job, error)
- func (s *Store) TerminalJobIDsBefore(ctx context.Context, before time.Time) ([]string, error)
- func (s *Store) User(ctx context.Context, id string) (control.User, error)
- func (s *Store) WorkerBusy(ctx context.Context) (bool, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
func (*Store) AcquireNextOperation ¶
func (*Store) ActivateOperation ¶ added in v0.1.7
func (*Store) ActivateProjectImage ¶
func (*Store) ActiveResourceScope ¶
func (*Store) AddProjectMember ¶
func (*Store) AppendResourceSample ¶
func (*Store) Authenticate ¶
func (*Store) AuthorizeProject ¶
func (*Store) BeginOperationCleanup ¶ added in v0.1.12
func (s *Store) BeginOperationCleanup(ctx context.Context, kind control.OperationKind, id string) error
BeginOperationCleanup durably transfers the single worker reservation from execution to teardown. It is idempotent so terminal refreshes, reconciliation, and client retries can all request the same transition safely.
func (*Store) CancelQueuedOperation ¶
func (*Store) CapacityImagePolicies ¶ added in v0.1.7
CapacityImagePolicies protects the active and rollback images for every project and supplies durable job recency for pressure-driven image LRU.
func (*Store) ChangesAfter ¶
func (*Store) ClaimOperationCleanup ¶ added in v0.1.12
ClaimOperationCleanup returns the oldest teardown reservation. A cleanup left in progress by a process crash is deliberately claimed again; cleaners must therefore be idempotent.
func (*Store) CompactResourceSamples ¶
func (*Store) CompleteOperationCleanup ¶ added in v0.1.12
func (*Store) CreateBuild ¶
func (*Store) CreateDeviceToken ¶
func (s *Store) CreateDeviceToken(ctx context.Context, principal control.Principal, input control.CreateDeviceToken) (control.IssuedDeviceToken, error)
func (*Store) CreateEnrollmentCode ¶
func (*Store) CreateGitHubTrust ¶
func (s *Store) CreateGitHubTrust(ctx context.Context, principal control.Principal, trust control.GitHubTrust) (control.GitHubTrust, error)
func (*Store) CreatePreparedJob ¶
func (*Store) CreateProject ¶
func (*Store) CreateProjectSession ¶
func (*Store) CreateUser ¶
func (*Store) EmergencyStopActiveOperation ¶ added in v0.1.7
func (s *Store) EmergencyStopActiveOperation(ctx context.Context, message string) (*control.Operation, error)
EmergencyStopActiveOperation atomically protects the control plane from a worker-wide capacity emergency. It terminalizes the single admitting/active operation and releases the durable FIFO lease without admitting another job.
func (*Store) ExchangeEnrollmentCode ¶
func (s *Store) ExchangeEnrollmentCode(ctx context.Context, code string) (control.IssuedDeviceToken, control.EnrollmentCode, error)
func (*Store) FinishBuild ¶
func (*Store) ListAuditEvents ¶
func (*Store) ListBuilds ¶
func (*Store) ListDeviceTokens ¶
func (*Store) ListGitHubTrusts ¶
func (*Store) ListProjectImageHistory ¶
func (*Store) ListProjects ¶
func (*Store) ListResourceRollups ¶
func (s *Store) ListResourceRollups(ctx context.Context, filter control.ResourceFilter, limit int) ([]control.ResourceRollup, error)
func (*Store) ListResourceSamples ¶
func (s *Store) ListResourceSamples(ctx context.Context, filter control.ResourceFilter, limit int) ([]control.ResourceSample, error)
func (*Store) ListResourceSummaries ¶
func (*Store) MatchGitHubTrust ¶
func (s *Store) MatchGitHubTrust(ctx context.Context, projectSelector string, claims control.GitHubClaims) (control.GitHubTrust, error)
func (*Store) OperationActive ¶
func (*Store) OperationState ¶
func (s *Store) OperationState(ctx context.Context, kind control.OperationKind, id string) (control.OperationState, error)
func (*Store) ProjectMemberCount ¶
func (*Store) RecordOperationCleanupFailure ¶ added in v0.1.12
func (*Store) RecordSecretAccess ¶ added in v0.1.12
RecordSecretAccess records only the reference name and job identity. Secret material must never enter the control database or its backups.
func (*Store) RenewOperationLease ¶ added in v0.1.7
func (*Store) RequestJobCancellation ¶
func (*Store) RequeueAdmittingOperation ¶ added in v0.1.12
func (*Store) ResourceBaseline ¶ added in v0.1.12
func (s *Store) ResourceBaseline(ctx context.Context, kind control.OperationKind, id string) (operationcleanup.ResourceSet, error)
func (*Store) ResourceSummary ¶
func (s *Store) ResourceSummary(ctx context.Context, filter control.ResourceFilter) (control.ResourceSummary, error)
func (*Store) RevokeDeviceToken ¶
func (*Store) RevokeGitHubTrust ¶
func (*Store) RollbackProjectImage ¶
func (*Store) SaveResourceBaseline ¶ added in v0.1.12
func (s *Store) SaveResourceBaseline(ctx context.Context, kind control.OperationKind, id string, resources operationcleanup.ResourceSet) error
func (*Store) ScheduledJobs ¶
func (*Store) SetProjectImagePolicy ¶
func (*Store) StaleBuilds ¶
func (*Store) StalePreparingJobs ¶ added in v0.1.12
func (*Store) SubscribeChanges ¶
func (s *Store) SubscribeChanges() (<-chan struct{}, func())
SubscribeChanges wakes the caller after a transaction that appended at least one control change commits. Delivery is deliberately coalesced.
func (*Store) TerminalJobIDsBefore ¶ added in v0.1.7
TerminalJobIDsBefore returns only durable terminal job records whose retained workspace may be removed. Runtime state is deliberately selected from SQLite rather than inferred from directory timestamps.