reservations

type ContextKey string

type DBVMSource struct {
	NovaReader external.NovaReaderInterface
}

type DeletedVMInfo struct {
	ProjectID        string
	AvailabilityZone string
	FlavorName       string
	RAMMiB           uint64
	VCPUs            uint64
}

type FlavorGroupKnowledgeClient struct {
	client.Client
}

type HypervisorDiffHandler struct {
	// OnUpdate is called with (ctx, oldHV, newHV) on every Hypervisor Update event.
	OnUpdate func(ctx context.Context, oldHV, newHV *hv1.Hypervisor) error
}

type Monitor struct {
	// Client for the kubernetes API.
	client.Client
	// contains filtered or unexported fields
}

type ScheduleReservationRequest struct {
	// InstanceUUID is the unique identifier for the reservation (usually the reservation name).
	InstanceUUID string
	// ProjectID is the OpenStack project ID.
	ProjectID string
	// FlavorName is the name of the flavor.
	FlavorName string
	// FlavorExtraSpecs are extra specifications for the flavor.
	FlavorExtraSpecs map[string]string
	// MemoryMB is the memory in MB.
	MemoryMB uint64
	// VCPUs is the number of virtual CPUs.
	VCPUs uint64
	// EligibleHosts is the list of hosts that can be considered for placement.
	EligibleHosts []api.ExternalSchedulerHost
	// IgnoreHosts is a list of hosts to ignore during scheduling.
	// This is used for failover reservations to avoid placing on the same host as the VMs.
	IgnoreHosts []string
	// Pipeline is the name of the pipeline to execute.
	// If empty, the default pipeline will be used.
	Pipeline string
	// AvailabilityZone is the availability zone to schedule in.
	// This is used by the filter_correct_az filter to ensure hosts are in the correct AZ.
	AvailabilityZone string
	// SchedulerHints are hints passed to the scheduler pipeline.
	// Used to set _nova_check_type for evacuation intent detection.
	SchedulerHints map[string]any
	// ImageProperties are Glance-style image properties (e.g., "img_hv_type", "hypervisor_type")
	// forwarded on Spec.Data.Image.Data.Properties.Data. Optional; when empty the outgoing
	// request leaves the image field at its zero value. Used by FilterImagePropertiesStep.
	ImageProperties map[string]any
}

type ScheduleReservationResponse struct {
	// Hosts is the ordered list of hosts that the reservation can be placed on.
	// The first host is the best choice.
	Hosts []string
}

type SchedulerClient struct {
	// URL of the external scheduler API.
	URL string
	// HTTP client to use for requests.
	HTTPClient *http.Client
}

type VM struct {
	// UUID is the unique identifier of the VM.
	UUID string
	// Name is the display name of the VM in Nova.
	Name string
	// Status is the Nova status of the VM (e.g. ACTIVE, SHUTOFF).
	Status string
	// FlavorName is the name of the flavor used by the VM.
	FlavorName string
	// ProjectID is the OpenStack project ID that owns the VM.
	ProjectID string
	// CurrentHypervisor is the hypervisor where the VM is currently running.
	CurrentHypervisor string
	// AvailabilityZone is the availability zone where the VM is located.
	// This is used to ensure failover reservations are created in the same AZ.
	AvailabilityZone string
	// CreatedAt is the ISO 8601 timestamp when the VM was created in Nova.
	// Used by the quota controller to distinguish new VMs from migrations.
	CreatedAt string
	// Resources contains the VM's resource allocations (e.g., "memory", "vcpus").
	Resources map[string]resource.Quantity
	// FlavorExtraSpecs contains the flavor's extra specifications (e.g., traits, capabilities).
	// This is used by filters like filter_has_requested_traits and filter_capabilities.
	FlavorExtraSpecs map[string]string
	// DiskGB is the flavor's root disk size in GiB.
	DiskGB uint64
	// OSType is the operating system type pre-computed from Glance image properties.
	// "unknown" when not found or for volume-booted instances.
	OSType string
}

type VMSource interface {
	// ListVMs returns all VMs across all projects.
	ListVMs(ctx context.Context) ([]VM, error)
	// ListVMsByProject returns all VMs belonging to a specific project.
	ListVMsByProject(ctx context.Context, projectID string) ([]VM, error)
	// ListVMsOnHypervisors returns VMs that are on the given hypervisors.
	// If trustHypervisorLocation is true, uses hypervisor CRD as source of truth for VM location.
	// If trustHypervisorLocation is false, uses postgres as source of truth but filters to VMs on known hypervisors.
	ListVMsOnHypervisors(ctx context.Context, hypervisorList *hv1.HypervisorList, trustHypervisorLocation bool) ([]VM, error)
	// GetVM returns a specific VM by UUID.
	// Returns nil, nil if the VM is not found.
	GetVM(ctx context.Context, vmUUID string) (*VM, error)
	// IsServerActive returns true if the server exists in the servers table and is not DELETED.
	// Returns false if not found. Used by quota controller to determine if a removed HV instance was deleted vs migrated.
	IsServerActive(ctx context.Context, vmUUID string) (bool, error)
	// GetDeletedVMInfo returns metadata about a deleted VM (from deleted_servers table),
	// including resolved flavor resources. Returns nil, nil if not found.
	GetDeletedVMInfo(ctx context.Context, vmUUID string) (*DeletedVMInfo, error)
}