Documentation ¶
Index ¶
- type AWATClient
- type BackupProvisioner
- type BackupSupervisor
- type Cloudflarer
- type ClusterInstallationSupervisor
- type ClusterSupervisor
- type DBMigrationSupervisor
- type Doer
- type GroupSupervisor
- type ImportSupervisor
- type InstallationDBRestorationSupervisor
- type InstallationSupervisor
- type InstallationSupervisorCache
- type InstallationSupervisorSchedulingOptions
- type MultiDoer
- type Scheduler
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AWATClient ¶ added in v0.45.0
type AWATClient interface { CreateTranslation(translationRequest *awat.TranslationRequest) (*awat.TranslationStatus, error) GetTranslationStatus(translationID string) (*awat.TranslationStatus, error) GetTranslationStatusesByInstallation(installationID string) ([]*awat.TranslationStatus, error) GetAllTranslations() ([]*awat.TranslationStatus, error) GetTranslationReadyToImport(request *awat.ImportWorkRequest) (*awat.ImportStatus, error) GetImportStatusesByInstallation(installationID string) ([]*awat.ImportStatus, error) GetImportStatusesByTranslation(translationID string) ([]*awat.ImportStatus, error) ListImports() ([]*awat.ImportStatus, error) GetImportStatus(importID string) (*awat.ImportStatus, error) CompleteImport(completed *awat.ImportCompletedWorkRequest) error ReleaseLockOnImport(importID string) error }
AWATClient is the programmatic interface to the AWAT API.
type BackupProvisioner ¶ added in v0.44.0
type BackupProvisioner interface { TriggerBackup(backupMeta *model.InstallationBackup, cluster *model.Cluster, installation *model.Installation) (*model.S3DataResidence, error) CheckBackupStatus(backupMeta *model.InstallationBackup, cluster *model.Cluster) (int64, error) CleanupBackupJob(backup *model.InstallationBackup, cluster *model.Cluster) error }
BackupProvisioner provisions backup jobs on a cluster.
type BackupSupervisor ¶ added in v0.44.0
type BackupSupervisor struct {
// contains filtered or unexported fields
}
BackupSupervisor finds backup pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewBackupSupervisor ¶ added in v0.44.0
func NewBackupSupervisor( store installationBackupStore, backupOperator BackupProvisioner, aws aws.AWS, instanceID string, logger log.FieldLogger) *BackupSupervisor
NewBackupSupervisor creates a new BackupSupervisor.
func (*BackupSupervisor) Do ¶ added in v0.44.0
func (s *BackupSupervisor) Do() error
Do looks for work to be done on any pending backups and attempts to schedule the required work.
func (*BackupSupervisor) Shutdown ¶ added in v0.44.0
func (s *BackupSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the backup supervisor.
func (*BackupSupervisor) Supervise ¶ added in v0.44.0
func (s *BackupSupervisor) Supervise(backup *model.InstallationBackup)
Supervise schedules the required work on the given backup.
type Cloudflarer ¶ added in v0.54.1
type Cloudflarer interface { CreateDNSRecords(customerDNSName []string, dnsEndpoints []string, logger logrus.FieldLogger) error DeleteDNSRecords(customerDNSName []string, logger logrus.FieldLogger) error }
Cloudflarer interface that holds Cloudflare functions
type ClusterInstallationSupervisor ¶
type ClusterInstallationSupervisor struct {
// contains filtered or unexported fields
}
ClusterInstallationSupervisor finds cluster installations pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewClusterInstallationSupervisor ¶
func NewClusterInstallationSupervisor(store clusterInstallationStore, clusterInstallationProvisioner clusterInstallationProvisioner, aws aws.AWS, eventsProducer eventProducer, instanceID string, logger log.FieldLogger, metrics *metrics.CloudMetrics) *ClusterInstallationSupervisor
NewClusterInstallationSupervisor creates a new ClusterInstallationSupervisor.
func (*ClusterInstallationSupervisor) Do ¶
func (s *ClusterInstallationSupervisor) Do() error
Do looks for work to be done on any pending cluster installations and attempts to schedule the required work.
func (*ClusterInstallationSupervisor) Shutdown ¶ added in v0.20.0
func (s *ClusterInstallationSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the cluster installation supervisor.
func (*ClusterInstallationSupervisor) Supervise ¶
func (s *ClusterInstallationSupervisor) Supervise(clusterInstallation *model.ClusterInstallation)
Supervise schedules the required work on the given cluster installation.
type ClusterSupervisor ¶
type ClusterSupervisor struct {
// contains filtered or unexported fields
}
ClusterSupervisor finds clusters pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewClusterSupervisor ¶
func NewClusterSupervisor(store clusterStore, clusterProvisioner clusterProvisioner, aws aws.AWS, eventProducer eventProducer, instanceID string, logger log.FieldLogger) *ClusterSupervisor
NewClusterSupervisor creates a new ClusterSupervisor.
func (*ClusterSupervisor) Do ¶
func (s *ClusterSupervisor) Do() error
Do looks for work to be done on any pending clusters and attempts to schedule the required work.
func (*ClusterSupervisor) Shutdown ¶ added in v0.20.0
func (s *ClusterSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the cluster supervisor.
func (*ClusterSupervisor) Supervise ¶
func (s *ClusterSupervisor) Supervise(cluster *model.Cluster)
Supervise schedules the required work on the given cluster.
type DBMigrationSupervisor ¶ added in v0.45.0
type DBMigrationSupervisor struct {
// contains filtered or unexported fields
}
DBMigrationSupervisor finds pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewInstallationDBMigrationSupervisor ¶ added in v0.45.0
func NewInstallationDBMigrationSupervisor( store installationDBMigrationStore, aws aws.AWS, dbProvider databaseProvider, instanceID string, provisioner dbMigrationCIProvisioner, eventsProducer eventProducer, logger log.FieldLogger) *DBMigrationSupervisor
NewInstallationDBMigrationSupervisor creates a new DBMigrationSupervisor.
func (*DBMigrationSupervisor) Do ¶ added in v0.45.0
func (s *DBMigrationSupervisor) Do() error
Do looks for work to be done on any pending backups and attempts to schedule the required work.
func (*DBMigrationSupervisor) Shutdown ¶ added in v0.45.0
func (s *DBMigrationSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the supervisor.
func (*DBMigrationSupervisor) Supervise ¶ added in v0.45.0
func (s *DBMigrationSupervisor) Supervise(migration *model.InstallationDBMigrationOperation)
Supervise schedules the required work on the given backup.
type GroupSupervisor ¶ added in v0.18.0
type GroupSupervisor struct {
// contains filtered or unexported fields
}
GroupSupervisor finds installations belonging to groups that need to have their configuration reconciled to match a new group configuration setting.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewGroupSupervisor ¶ added in v0.18.0
func NewGroupSupervisor(store groupStore, eventsProducer eventProducer, instanceID string, logger log.FieldLogger) *GroupSupervisor
NewGroupSupervisor creates a new GroupSupervisor.
func (*GroupSupervisor) Do ¶ added in v0.18.0
func (s *GroupSupervisor) Do() error
Do looks for work to be done on any pending groups and attempts to schedule the required work.
func (*GroupSupervisor) Shutdown ¶ added in v0.20.0
func (s *GroupSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the group supervisor.
func (*GroupSupervisor) Supervise ¶ added in v0.18.0
func (s *GroupSupervisor) Supervise(group *model.Group)
Supervise schedules the required work on the given group.
type ImportSupervisor ¶ added in v0.45.0
type ImportSupervisor struct { ID string // contains filtered or unexported fields }
ImportSupervisor is a supervisor which performs Workspace Imports from ready Imports produced by the AWAT. It periodically queries the AWAT for Imports waiting to be performed and then performs imports serially
func NewImportSupervisor ¶ added in v0.45.0
func NewImportSupervisor(awsClient toolsAWS.AWS, awat AWATClient, store importStore, provisioner importProvisioner, eventsProducer eventProducer, logger logrus.FieldLogger) *ImportSupervisor
NewImportSupervisor creates a new Import Supervisor
func (*ImportSupervisor) Do ¶ added in v0.45.0
func (s *ImportSupervisor) Do() error
Do checks to see if there is an Import that is ready to be imported, and if so, does that. Otherwise, it does nothing.
func (*ImportSupervisor) Shutdown ¶ added in v0.45.0
func (s *ImportSupervisor) Shutdown()
Shutdown is called when the ImportSupervisor is stopped. TODO change Shutdown from a no-op to allowing it to unlock ongoing Imports so that they are detected as interrupted by the AWAT and can be re-served to another Provisioner instance as a cleaner retry pattern
type InstallationDBRestorationSupervisor ¶ added in v0.45.0
type InstallationDBRestorationSupervisor struct {
// contains filtered or unexported fields
}
InstallationDBRestorationSupervisor finds pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewInstallationDBRestorationSupervisor ¶ added in v0.45.0
func NewInstallationDBRestorationSupervisor( store installationDBRestorationStore, aws aws.AWS, restoreOperator restoreOperator, eventsProducer eventProducer, instanceID string, logger log.FieldLogger) *InstallationDBRestorationSupervisor
NewInstallationDBRestorationSupervisor creates a new InstallationDBRestorationSupervisor.
func (*InstallationDBRestorationSupervisor) Do ¶ added in v0.45.0
func (s *InstallationDBRestorationSupervisor) Do() error
Do looks for work to be done on any pending restoration operations and attempts to schedule the required work.
func (*InstallationDBRestorationSupervisor) Shutdown ¶ added in v0.45.0
func (s *InstallationDBRestorationSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the supervisor.
func (*InstallationDBRestorationSupervisor) Supervise ¶ added in v0.45.0
func (s *InstallationDBRestorationSupervisor) Supervise(restoration *model.InstallationDBRestorationOperation)
Supervise schedules the required work on the given restoration.
type InstallationSupervisor ¶
type InstallationSupervisor struct {
// contains filtered or unexported fields
}
InstallationSupervisor finds installations pending work and effects the required changes.
The degree of parallelism is controlled by a weighted semaphore, intended to be shared with other clients needing to coordinate background jobs.
func NewInstallationSupervisor ¶
func NewInstallationSupervisor( store installationStore, installationProvisioner installationProvisioner, aws aws.AWS, instanceID string, keepDatabaseData, keepFilestoreData bool, scheduling InstallationSupervisorSchedulingOptions, resourceUtil *utils.ResourceUtil, logger log.FieldLogger, metrics *metrics.CloudMetrics, eventsProducer eventProducer, forceCRUpgrade bool, cloudflareClient Cloudflarer) *InstallationSupervisor
NewInstallationSupervisor creates a new InstallationSupervisor.
func (*InstallationSupervisor) Do ¶
func (s *InstallationSupervisor) Do() error
Do looks for work to be done on any pending installations and attempts to schedule the required work.
func (*InstallationSupervisor) Shutdown ¶ added in v0.20.0
func (s *InstallationSupervisor) Shutdown()
Shutdown performs graceful shutdown tasks for the installation supervisor.
func (*InstallationSupervisor) Supervise ¶
func (s *InstallationSupervisor) Supervise(installation *model.Installation)
Supervise schedules the required work on the given installation.
type InstallationSupervisorCache ¶ added in v0.54.1
type InstallationSupervisorCache struct {
// contains filtered or unexported fields
}
InstallationSupervisorCache contains configuration and cached data for cluster resources.
type InstallationSupervisorSchedulingOptions ¶ added in v0.35.0
type InstallationSupervisorSchedulingOptions struct {
// contains filtered or unexported fields
}
InstallationSupervisorSchedulingOptions are the various options that control how installation scheduling occurs.
func NewInstallationSupervisorSchedulingOptions ¶ added in v0.35.0
func NewInstallationSupervisorSchedulingOptions(balanceInstallations bool, clusterResourceThreshold, clusterResourceThresholdScaleValue int) InstallationSupervisorSchedulingOptions
NewInstallationSupervisorSchedulingOptions creates a new InstallationSupervisorSchedulingOptions.
type MultiDoer ¶
type MultiDoer []Doer
MultiDoer is a slice of doers.
type Scheduler ¶
type Scheduler struct {
// contains filtered or unexported fields
}
Scheduler schedules a doer for periodic, serial execution.
func NewScheduler ¶
NewScheduler creates a new scheduler.
If the period is zero, the scheduler is never run, even if manually run. Otherwise, the period specifies how long to wait after its last successful execution.
func (*Scheduler) Close ¶
Close waits for any active doer to finish, terminates the main thread of the scheduler, and ensures the doer is no longer invoked.
Source Files ¶
- backup.go
- backup_lock.go
- cluster.go
- cluster_installation.go
- cluster_installation_lock.go
- cluster_lock.go
- common.go
- db_migration.go
- db_migration_lock.go
- doer.go
- group.go
- group_lock.go
- import.go
- installation.go
- installation_db_restoration.go
- installation_db_restoration_lock.go
- installation_lock.go
- scheduler.go