#VirtualMachineInstanceMigration [virtualmachineinstancemigrations.kubevirt.io/v1]

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

VirtualMachineInstanceMigration reprents information pertaining to a VMI's migration.

AddedNodeSelector is an additional selector that can be used to complement a NodeSelector or NodeAffinity as set on the VM to restrict the set of allowed target nodes for a migration. In case of key collisions, values set on the VM objects are going to be preserved to ensure that addedNodeSelector can only restrict but not bypass constraints already set on the VM object.

Priority of the migration. This can be one of 'system-critical', 'user-triggered', 'system-maintenance'.

If receieve is specified, this VirtualMachineInstanceMigration will be considered the target

If sendTo is specified, this VirtualMachineInstanceMigration will be considered the source

The name of the VMI to perform the migration on. VMI must exist in the migration objects namespace

A unique identifier to identify this migration.

The synchronization controller URL to connect to.

A unique identifier to identify this migration.

Represents the status of a live migration

VirtualMachineInstanceMigrationPhase is a label for the condition of a VirtualMachineInstanceMigration at the current time.

PhaseTransitionTimestamp is the timestamp of when the last phase change occurred

The synchronization addresses one can use to connect to the synchronization controller, includes the port, if multiple addresses are available, the first one is reported in the synchronizationAddress field.

Indicates that the migration has been requested to abort

Indicates the final status of the live migration abortion

Indicates the migration completed

The time the migration action ended

Indicates that the migration failed

Contains the reason why the migration failed

Migration configurations to apply

The type of migration network, either 'pod' or 'migration'

Name of the migration policy. If string is empty, no policy is matched

The VirtualMachineInstanceMigration object associated with this migration

Lets us know if the vmi is currently running pre or post copy migration

The source node that the VMI originated on

If the VMI being migrated uses persistent features (backend-storage), its source PVC name is saved here

SourceState contains migration state managed by the source virt handler

The time the migration action began

The UID of the target attachment pod for hotplug volumes

If the VMI requires dedicated CPUs, this field will hold the dedicated CPU set on the target node

The list of ports opened for live migration on the destination node

The target node that the VMI is moving to

The address of the target node to use for the migration

The Target Node has seen the Domain Start Event

The timestamp at which the target node detects the domain is active

If the VMI requires dedicated CPUs, this field will hold the numa topology on the target node

If the VMI being migrated uses persistent features (backend-storage), its target PVC name is saved here

The target pod that the VMI is moving to

TargetState contains migration state managed by the target virt handler

AllowAutoConverge allows the platform to compromise performance/availability of VMIs to guarantee successful VMI live migrations. Defaults to false

AllowPostCopy enables post-copy live migrations. Such migrations allow even the busiest VMIs to successfully live-migrate. However, events like a network failure can cause a VMI crash. If set to true, migrations will still start in pre-copy, but switch to post-copy when CompletionTimeoutPerGiB triggers. Defaults to false

AllowWorkloadDisruption indicates that the migration shouldn't be canceled after acceptableCompletionTime is exceeded. Instead, if permitted, migration will be switched to post-copy or the VMI will be paused to allow the migration to complete

BandwidthPerMigration limits the amount of network bandwidth live migrations are allowed to use. The value is in quantity per second. Defaults to 0 (no limit)

CompletionTimeoutPerGiB is the maximum number of seconds per GiB a migration is allowed to take. If the timeout is reached, the migration will be either paused, switched to post-copy or cancelled depending on other settings. Defaults to 150

When set to true, DisableTLS will disable the additional layer of live migration encryption provided by KubeVirt. This is usually a bad idea. Defaults to false

By default, the SELinux level of target virt-launcher pods is forced to the level of the source virt-launcher. When set to true, MatchSELinuxLevelOnMigration lets the CRI auto-assign a random level to the target. That will ensure the target virt-launcher doesn't share categories with another pod on the node. However, migrations will fail when using RWX volumes that don't automatically deal with SELinux levels.

Network is the name of the CNI network to use for live migrations. By default, migrations go through the pod network.

NodeDrainTaintKey defines the taint key that indicates a node should be drained. Note: this option relies on the deprecated node taint feature. Default: kubevirt.io/drain

ParallelMigrationsPerCluster is the total number of concurrent live migrations allowed cluster-wide. Defaults to 5

ParallelOutboundMigrationsPerNode is the maximum number of concurrent outgoing live migrations allowed per node. Defaults to 2

ProgressTimeout is the maximum number of seconds a live migration is allowed to make no progress. Hitting this timeout means a migration transferred 0 data for that many seconds. The migration is then considered stuck and therefore cancelled. Defaults to 150

UnsafeMigrationOverride allows live migrations to occur even if the compatibility check indicates the migration will be unsafe to the guest. Defaults to false

The name of the domain on the source libvirt domain

Namespace used in the name of the source libvirt domain. Can be used to find and modify paths in the domain

The Source VirtualMachineInstanceMigration object associated with this migration

The source node that the VMI originated on

Node selectors needed by the target to start the receiving pod.

If the VMI being migrated uses persistent features (backend-storage), its source PVC name is saved here

The source pod that the VMI is originated on

SELinuxContext is the actual SELinux context of the pod

The ip address/fqdn:port combination to use to synchronize the VMI with the target.

VirtualMachineInstanceUID is the UID of the target virtual machine instance

The UID of the target attachment pod for hotplug volumes

If the VMI requires dedicated CPUs, this field will hold the dedicated CPU set on the target node

The list of ports opened for live migration on the destination node

The Target Node has seen the Domain Start Event

The name of the domain on the source libvirt domain

Namespace used in the name of the source libvirt domain. Can be used to find and modify paths in the domain

The timestamp at which the target node detects the domain is active

The Source VirtualMachineInstanceMigration object associated with this migration

The source node that the VMI originated on

The address of the target node to use for the migration

If the VMI requires dedicated CPUs, this field will hold the numa topology on the target node

If the VMI being migrated uses persistent features (backend-storage), its source PVC name is saved here

The source pod that the VMI is originated on

SELinuxContext is the actual SELinux context of the pod

The ip address/fqdn:port combination to use to synchronize the VMI with the target.

VirtualMachineInstanceUID is the UID of the target virtual machine instance

Phase is the status of the VirtualMachineInstanceMigrationPhase in kubernetes world. It is not the VirtualMachineInstanceMigrationPhase status, but partially correlates to it.

PhaseTransitionTimestamp is the timestamp of when the phase change occurred