AzureMachinePool

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

AzureMachinePoolSpec defines the desired state of AzureMachinePool.

AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.

Identity is the type of identity used for the Virtual Machine Scale Set. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM

Location is the Azure region location e.g. westus2

ProviderID is the identification ID of the Virtual Machine Scale Set

ProviderIDList are the identification IDs of machine instances provided by the provider. This field must match the provider IDs as seen on the node objects corresponding to a machine pool’s machine instances.

RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.

Template contains the details used to build a replica virtual machine within the Machine Pool.

AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.

DataDisks specifies the list of data disks to be created for a Virtual Machine

DataDisk specifies the parameters that are used to add one or more data disks to the machine.

DiskSizeGB is the size in GB to assign to the data disk.

Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.

ManagedDisk defines the managed disk options for a VM.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format _.

Image is used to provide details of an image to use during Virtual Machine creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.

ID specifies an image to use by ID

Marketplace specifies an image to use from the Azure Marketplace

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer

Publisher is the name of the organization that created the image

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter

ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.

Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

SharedGallery specifies an image to use from an Azure Shared Image Gallery

Gallery specifies the name of the shared image gallery that contains the image

Name is the name of the image

ResourceGroup specifies the resource group containing the shared image gallery

SubscriptionID is the identifier of the subscription that contains the shared image gallery

Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

OSDisk contains the operating system disk information for a Virtual Machine

DiffDiskSettings describe ephemeral disk settings for the os disk.

Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details

ManagedDisk defines the managed disk options for a VM.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

SecurityProfile specifies the Security profile settings for a virtual machine.

This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.

SpotVMOptions allows the ability to specify the Machine should use a Spot VM

MaxPrice defines the maximum price the user is willing to pay for Spot VM instances

SSHPublicKey is the SSH public key string base64 encoded to add to a Virtual Machine

TerminateNotificationTimeout enables or disables VMSS scheduled events termination notification with specified timeout allowed values are between 5 and 15 (mins)

VMSize is the size of the Virtual Machine to build. See https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines/createorupdate#virtualmachinesizetypes

UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachinePool. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli

UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.

ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’

AzureMachinePoolStatus defines the observed state of AzureMachinePool.

Conditions defines current service state of the AzureMachinePool.

Condition defines an observation of a Cluster API resource operational state.

Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.

A human readable message indicating details about the transition. This field may be empty.

The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.

Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.

Status of the condition, one of True, False, Unknown.

Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.

FailureMessage will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

FailureReason will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

Instances is the VM instance status for each VM in the VMSS

AzureMachinePoolInstanceStatus provides status information for each instance in the VMSS.

InstanceID is the identification of the Machine Instance within the VMSS

InstanceName is the name of the Machine Instance within the VMSS

LatestModelApplied indicates the instance is running the most up-to-date VMSS model. A VMSS model describes the image version the VM is running. If the instance is not running the latest model, it means the instance may not be running the version of Kubernetes the Machine Pool has specified and needs to be updated.

ProviderID is the provider identification of the VMSS Instance

ProvisioningState is the provisioning state of the Azure virtual machine instance.

Version defines the Kubernetes version for the VM Instance

LongRunningOperationState saves the state for an Azure long running operations so it can be continued on the next reconciliation loop.

FutureData is the base64 url encoded json Azure AutoRest Future.

Name is the name of the Azure resource.

ResourceGroup is the Azure resource group for the resource.

Type describes the type of future, update, create, delete, etc.

ProvisioningState is the provisioning state of the Azure virtual machine.

Ready is true when the provider resource is ready.

Replicas is the most recently observed number of replicas.

Version is the Kubernetes version for the current VMSS model

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

AzureMachinePoolSpec defines the desired state of AzureMachinePool.

AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.

Identity is the type of identity used for the Virtual Machine Scale Set. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM

Location is the Azure region location e.g. westus2

NodeDrainTimeout is the total amount of time that the controller will spend on draining a node. The default value is 0, meaning that the node can be drained without any time limitations. NOTE: NodeDrainTimeout is different from kubectl drain --timeout

ProviderID is the identification ID of the Virtual Machine Scale Set

ProviderIDList are the identification IDs of machine instances provided by the provider. This field must match the provider IDs as seen on the node objects corresponding to a machine pool’s machine instances.

RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.

The deployment strategy to use to replace existing AzureMachinePoolMachines with new ones.

Rolling update config params. Present only if MachineDeploymentStrategyType = RollingUpdate.

DeletePolicy defines the policy used by the MachineDeployment to identify nodes to delete when downscaling. Valid values are “Random, “Newest”, “Oldest” When no value is supplied, the default is Oldest

The maximum number of machines that can be scheduled above the desired number of machines. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up. Defaults to 1. Example: when this is set to 30%, the new MachineSet can be scaled up immediately when the rolling update starts, such that the total number of old and new machines do not exceed 130% of desired machines. Once old machines have been killed, new MachineSet can be scaled up further, ensuring that total number of machines running at any time during the update is at most 130% of desired machines.

The maximum number of machines that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). Absolute number is calculated from percentage by rounding down. This can not be 0 if MaxSurge is 0. Defaults to 0. Example: when this is set to 30%, the old MachineSet can be scaled down to 70% of desired machines immediately when the rolling update starts. Once new machines are ready, old MachineSet can be scaled down further, followed by scaling up the new MachineSet, ensuring that the total number of machines available at all times during the update is at least 70% of desired machines.

Type of deployment. Currently the only supported strategy is RollingUpdate

Template contains the details used to build a replica virtual machine within the Machine Pool

AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.

DataDisks specifies the list of data disks to be created for a Virtual Machine

DataDisk specifies the parameters that are used to add one or more data disks to the machine.

CachingType specifies the caching requirements.

DiskSizeGB is the size in GB to assign to the data disk.

Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.

ManagedDisk specifies the Managed Disk parameters for the data disk.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format _.

Image is used to provide details of an image to use during VM creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.

ID specifies an image to use by ID

Marketplace specifies an image to use from the Azure Marketplace

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer

Publisher is the name of the organization that created the image

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter

ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.

Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

SharedGallery specifies an image to use from an Azure Shared Image Gallery

Gallery specifies the name of the shared image gallery that contains the image

Name is the name of the image

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

ResourceGroup specifies the resource group containing the shared image gallery

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

SubscriptionID is the identifier of the subscription that contains the shared image gallery

Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

OSDisk contains the operating system disk information for a Virtual Machine

CachingType specifies the caching requirements.

DiffDiskSettings describe ephemeral disk settings for the os disk.

Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details

DiskSizeGB is the size in GB to assign to the OS disk. Will have a default of 30GB if not provided

ManagedDisk specifies the Managed Disk parameters for the OS disk.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

SecurityProfile specifies the Security profile settings for a virtual machine.

This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.

SpotVMOptions allows the ability to specify the Machine should use a Spot VM

MaxPrice defines the maximum price the user is willing to pay for Spot VM instances

SSHPublicKey is the SSH public key string base64 encoded to add to a Virtual Machine

SubnetName selects the Subnet where the VMSS will be placed

TerminateNotificationTimeout enables or disables VMSS scheduled events termination notification with specified timeout allowed values are between 5 and 15 (mins)

VMSize is the size of the Virtual Machine to build. See https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines/createorupdate#virtualmachinesizetypes

UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachinePool. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli

UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.

ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’

AzureMachinePoolStatus defines the observed state of AzureMachinePool.

Conditions defines current service state of the AzureMachinePool.

Condition defines an observation of a Cluster API resource operational state.

Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.

A human readable message indicating details about the transition. This field may be empty.

The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.

Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.

Status of the condition, one of True, False, Unknown.

Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.

FailureMessage will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

FailureReason will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

Image is the current image used in the AzureMachinePool. When the spec image is nil, this image is populated with the details of the defaulted Azure Marketplace “capi” offer.

ID specifies an image to use by ID

Marketplace specifies an image to use from the Azure Marketplace

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer

Publisher is the name of the organization that created the image

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter

ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.

Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

SharedGallery specifies an image to use from an Azure Shared Image Gallery

Gallery specifies the name of the shared image gallery that contains the image

Name is the name of the image

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

ResourceGroup specifies the resource group containing the shared image gallery

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

SubscriptionID is the identifier of the subscription that contains the shared image gallery

Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

Instances is the VM instance status for each VM in the VMSS

AzureMachinePoolInstanceStatus provides status information for each instance in the VMSS.

InstanceID is the identification of the Machine Instance within the VMSS

InstanceName is the name of the Machine Instance within the VMSS

LatestModelApplied indicates the instance is running the most up-to-date VMSS model. A VMSS model describes the image version the VM is running. If the instance is not running the latest model, it means the instance may not be running the version of Kubernetes the Machine Pool has specified and needs to be updated.

ProviderID is the provider identification of the VMSS Instance

ProvisioningState is the provisioning state of the Azure virtual machine instance.

Version defines the Kubernetes version for the VM Instance

LongRunningOperationStates saves the state for Azure long-running operations so they can be continued on the next reconciliation loop.

Future contains the data needed for an Azure long-running operation to continue across reconcile loops.

Data is the base64 url encoded json Azure AutoRest Future.

Name is the name of the Azure resource. Together with the service name, this forms the unique identifier for the future.

ResourceGroup is the Azure resource group for the resource.

ServiceName is the name of the Azure service. Together with the name of the resource, this forms the unique identifier for the future.

Type describes the type of future, such as update, create, delete, etc.

ProvisioningState is the provisioning state of the Azure virtual machine.

Ready is true when the provider resource is ready.

Replicas is the most recently observed number of replicas.

Version is the Kubernetes version for the current VMSS model

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

AzureMachinePoolSpec defines the desired state of AzureMachinePool.

AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.

Identity is the type of identity used for the Virtual Machine Scale Set. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM

Location is the Azure region location e.g. westus2

NodeDrainTimeout is the total amount of time that the controller will spend on draining a node. The default value is 0, meaning that the node can be drained without any time limitations. NOTE: NodeDrainTimeout is different from kubectl drain --timeout

ProviderID is the identification ID of the Virtual Machine Scale Set

ProviderIDList are the identification IDs of machine instances provided by the provider. This field must match the provider IDs as seen on the node objects corresponding to a machine pool’s machine instances.

RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.

The deployment strategy to use to replace existing AzureMachinePoolMachines with new ones.

Rolling update config params. Present only if MachineDeploymentStrategyType = RollingUpdate.

DeletePolicy defines the policy used by the MachineDeployment to identify nodes to delete when downscaling. Valid values are “Random, “Newest”, “Oldest” When no value is supplied, the default is Oldest

The maximum number of machines that can be scheduled above the desired number of machines. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up. Defaults to 1. Example: when this is set to 30%, the new MachineSet can be scaled up immediately when the rolling update starts, such that the total number of old and new machines do not exceed 130% of desired machines. Once old machines have been killed, new MachineSet can be scaled up further, ensuring that total number of machines running at any time during the update is at most 130% of desired machines.

The maximum number of machines that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). Absolute number is calculated from percentage by rounding down. This can not be 0 if MaxSurge is 0. Defaults to 0. Example: when this is set to 30%, the old MachineSet can be scaled down to 70% of desired machines immediately when the rolling update starts. Once new machines are ready, old MachineSet can be scaled down further, followed by scaling up the new MachineSet, ensuring that the total number of machines available at all times during the update is at least 70% of desired machines.

Type of deployment. Currently the only supported strategy is RollingUpdate

Template contains the details used to build a replica virtual machine within the Machine Pool

AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.

DataDisks specifies the list of data disks to be created for a Virtual Machine

DataDisk specifies the parameters that are used to add one or more data disks to the machine.

CachingType specifies the caching requirements.

DiskSizeGB is the size in GB to assign to the data disk.

Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.

ManagedDisk specifies the Managed Disk parameters for the data disk.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format _.

Image is used to provide details of an image to use during VM creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.

ID specifies an image to use by ID

Marketplace specifies an image to use from the Azure Marketplace

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer

Publisher is the name of the organization that created the image

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter

ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.

Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

SharedGallery specifies an image to use from an Azure Shared Image Gallery

Gallery specifies the name of the shared image gallery that contains the image

Name is the name of the image

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

ResourceGroup specifies the resource group containing the shared image gallery

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

SubscriptionID is the identifier of the subscription that contains the shared image gallery

Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

OSDisk contains the operating system disk information for a Virtual Machine

CachingType specifies the caching requirements.

DiffDiskSettings describe ephemeral disk settings for the os disk.

Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details

DiskSizeGB is the size in GB to assign to the OS disk. Will have a default of 30GB if not provided

ManagedDisk specifies the Managed Disk parameters for the OS disk.

DiskEncryptionSetParameters defines disk encryption options.

ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription

SecurityProfile specifies the Security profile settings for a virtual machine.

This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.

SpotVMOptions allows the ability to specify the Machine should use a Spot VM

MaxPrice defines the maximum price the user is willing to pay for Spot VM instances

SSHPublicKey is the SSH public key string base64 encoded to add to a Virtual Machine

SubnetName selects the Subnet where the VMSS will be placed

TerminateNotificationTimeout enables or disables VMSS scheduled events termination notification with specified timeout allowed values are between 5 and 15 (mins)

VMSize is the size of the Virtual Machine to build. See https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines/createorupdate#virtualmachinesizetypes

UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachinePool. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli

UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.

ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’

AzureMachinePoolStatus defines the observed state of AzureMachinePool.

Conditions defines current service state of the AzureMachinePool.

Condition defines an observation of a Cluster API resource operational state.

Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.

A human readable message indicating details about the transition. This field may be empty.

The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.

Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.

Status of the condition, one of True, False, Unknown.

Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.

FailureMessage will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

FailureReason will be set in the event that there is a terminal problem reconciling the MachinePool and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the MachinePool’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of MachinePools can be added as events to the MachinePool object and/or logged in the controller’s output.

Image is the current image used in the AzureMachinePool. When the spec image is nil, this image is populated with the details of the defaulted Azure Marketplace “capi” offer.

ID specifies an image to use by ID

Marketplace specifies an image to use from the Azure Marketplace

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer

Publisher is the name of the organization that created the image

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter

ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.

Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

SharedGallery specifies an image to use from an Azure Shared Image Gallery

Gallery specifies the name of the shared image gallery that contains the image

Name is the name of the image

Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

ResourceGroup specifies the resource group containing the shared image gallery

SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.

SubscriptionID is the identifier of the subscription that contains the shared image gallery

Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.

Instances is the VM instance status for each VM in the VMSS

AzureMachinePoolInstanceStatus provides status information for each instance in the VMSS.

InstanceID is the identification of the Machine Instance within the VMSS

InstanceName is the name of the Machine Instance within the VMSS

LatestModelApplied indicates the instance is running the most up-to-date VMSS model. A VMSS model describes the image version the VM is running. If the instance is not running the latest model, it means the instance may not be running the version of Kubernetes the Machine Pool has specified and needs to be updated.

ProviderID is the provider identification of the VMSS Instance

ProvisioningState is the provisioning state of the Azure virtual machine instance.

Version defines the Kubernetes version for the VM Instance

LongRunningOperationStates saves the state for Azure long-running operations so they can be continued on the next reconciliation loop.

Future contains the data needed for an Azure long-running operation to continue across reconcile loops.

Data is the base64 url encoded json Azure AutoRest Future.

Name is the name of the Azure resource. Together with the service name, this forms the unique identifier for the future.

ResourceGroup is the Azure resource group for the resource.

ServiceName is the name of the Azure service. Together with the name of the resource, this forms the unique identifier for the future.

Type describes the type of future, such as update, create, delete, etc.

ProvisioningState is the provisioning state of the Azure virtual machine.

Ready is true when the provider resource is ready.

Replicas is the most recently observed number of replicas.

Version is the Kubernetes version for the current VMSS model