azurerm_virtual_machine_scale_sets

Create a virtual machine scale set.

Example Usage

resource "azurerm_resource_group" "test" {
    name = "acctestrg"
    location = "West US"
}

resource "azurerm_virtual_network" "test" {
    name = "acctvn"
    address_space = ["10.0.0.0/16"]
    location = "West US"
    resource_group_name = "${azurerm_resource_group.test.name}"
}

resource "azurerm_subnet" "test" {
    name = "acctsub"
    resource_group_name = "${azurerm_resource_group.test.name}"
    virtual_network_name = "${azurerm_virtual_network.test.name}"
    address_prefix = "10.0.2.0/24"
}

resource "azurerm_storage_account" "test" {
    name = "accsa"
    resource_group_name = "${azurerm_resource_group.test.name}"
    location = "westus"
    account_type = "Standard_LRS"

    tags {
        environment = "staging"
    }
}

resource "azurerm_storage_container" "test" {
    name = "vhds"
    resource_group_name = "${azurerm_resource_group.test.name}"
    storage_account_name = "${azurerm_storage_account.test.name}"
    container_access_type = "private"
}

resource "azurerm_virtual_machine_scale_set" "test" {
  name = "mytestscaleset-1"
  location = "West US"
  resource_group_name = "${azurerm_resource_group.test.name}"
  upgrade_policy_mode = "Manual"

  sku {
    name = "Standard_A0"
    tier = "Standard"
    capacity = 2
  }

  os_profile {
    computer_name_prefix = "testvm"
    admin_username = "myadmin"
    admin_password = "Passwword1234"
  }

  os_profile_linux_config {
    disable_password_authentication = true
    ssh_keys {
      path = "/home/myadmin/.ssh/authorized_keys"
      key_data = "${file("~/.ssh/demo_key.pub")}"
    }
  }

  network_profile {
      name = "TestNetworkProfile"
      primary = true
      ip_configuration {
        name = "TestIPConfiguration"
        subnet_id = "${azurerm_subnet.test.id}"
      }
  }

  storage_profile_os_disk {
    name = "osDiskProfile"
    caching       = "ReadWrite"
    create_option = "FromImage"
    vhd_containers = ["${azurerm_storage_account.test.primary_blob_endpoint}${azurerm_storage_container.test.name}"]
  }

  storage_profile_image_reference {
    publisher = "Canonical"
    offer     = "UbuntuServer"
    sku       = "14.04.2-LTS"
    version   = "latest"
  }
}

Argument Reference

The following arguments are supported:

  • name - (Required) Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
  • resource_group_name - (Required) The name of the resource group in which to create the virtual machine scale set.
  • location - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
  • sku - (Required) A sku block as documented below.
  • upgrade_policy_mode - (Required) Specifies the mode of an upgrade to virtual machines in the scale set. Possible values, Manual or Automatic.
  • os_profile - (Required) A Virtual Machine OS Profile block as documented below.
  • os_profile_secrets - (Optional) A collection of Secret blocks as documented below.
  • os_profile_windows_config - (Required, when a windows machine) A Windows config block as documented below.
  • os_profile_linux_config - (Required, when a linux machine) A Linux config block as documented below.
  • network_profile - (Required) A collection of network profile block as documented below.
  • storage_profile_os_disk - (Required) A storage profile os disk block as documented below
  • storage_profile_image_reference - (Optional) A storage profile image reference block as documented below.
  • tags - (Optional) A mapping of tags to assign to the resource.

sku supports the following:

  • name - (Required) Specifies the size of virtual machines in a scale set.
  • tier - (Optional) Specifies the tier of virtual machines in a scale set. Possible values, standard or basic.
  • capacity - (Required) Specifies the number of virtual machines in the scale set.

os_profile supports the following:

  • computer_name_prefix - (Required) Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 15 characters long.
  • admin_username - (Required) Specifies the administrator account name to use for all the instances of virtual machines in the scale set.
  • admin_password - (Required) Specifies the administrator password to use for all the instances of virtual machines in a scale set..
  • custom_data - (Optional) Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on all the Virtual Machines in the scale set. The maximum length of the binary array is 65535 bytes.

os_profile_secrets supports the following:

  • source_vault_id - (Required) Specifies the key vault to use.
  • vault_certificates - (Required, on windows machines) A collection of Vault Certificates as documented below

vault_certificates support the following:

  • certificate_url - (Required) It is the Base64 encoding of a JSON Object that which is encoded in UTF-8 of which the contents need to be data, dataType and password.
  • certificate_store - (Required, on windows machines) Specifies the certificate store on the Virtual Machine where the certificate should be added to.

os_profile_windows_config supports the following:

  • provision_vm_agent - (Optional) Indicates whether virtual machine agent should be provisioned on the virtual machines in the scale set.
  • enable_automatic_upgrades - (Optional) Indicates whether virtual machines in the scale set are enabled for automatic updates.
  • winrm - (Optional) A collection of WinRM configuration blocks as documented below.
  • additional_unattend_config - (Optional) An Additional Unattended Config block as documented below.

winrm supports the following:

  • protocol - (Required) Specifies the protocol of listener
  • certificate_url - (Optional) Specifies URL of the certificate with which new Virtual Machines is provisioned.

additional_unattend_config supports the following:

  • pass - (Required) Specifies the name of the pass that the content applies to. The only allowable value is oobeSystem.
  • component - (Required) Specifies the name of the component to configure with the added content. The only allowable value is Microsoft-Windows-Shell-Setup.
  • setting_name - (Required) Specifies the name of the setting to which the content applies. Possible values are: FirstLogonCommands and AutoLogon.
  • content - (Optional) Specifies the base-64 encoded XML formatted content that is added to the unattend.xml file for the specified path and component.

os_profile_linux_config supports the following:

  • disable_password_authentication - (Required) Specifies whether password authentication should be disabled.
  • ssh_keys - (Optional) Specifies a collection of path and key_data to be placed on the virtual machine.

~> Note: Please note that the only allowed path is /home/<username>/.ssh/authorized_keys due to a limitation of Azure_

network_profile supports the following:

  • name - (Required) Specifies the name of the network interface configuration.
  • primary - (Required) Indicates whether network interfaces created from the network interface configuration will be the primary NIC of the VM.
  • ip_configuration - (Required) An ip_configuration block as documented below

ip_configuration supports the following:

  • name - (Required) Specifies name of the IP configuration.
  • subnet_id - (Required) Specifies the identifier of the subnet.
  • load_balancer_backend_address_pool_ids - (Optional) Specifies an array of references to backend address pools of load balancers. A scale set can reference backend address pools of one public and one internal load balancer. Multiple scale sets cannot use the same load balancer.

storage_profile_os_disk supports the following:

  • name - (Required) Specifies the disk name.
  • vhd_containers - (Required) Specifies the vhd uri.
  • create_option - (Required) Specifies how the virtual machine should be created. The only possible option is FromImage.
  • caching - (Required) Specifies the caching requirements.
  • image - (Optional) Specifies the blob uri for user image. A virtual machine scale set creates an os disk in the same container as the user image.
                     Updating the osDisk image causes the existing disk to be deleted and a new one created with the new image. If the VM scale set is in Manual upgrade mode then the virtual machines are not updated until they have manualUpgrade applied to them.
    
  • os_type - (Optional) Specifies the operating system Type, valid values are windows, linux.

storage_profile_image_reference supports the following:

  • publisher - (Required) Specifies the publisher of the image used to create the virtual machines
  • offer - (Required) Specifies the offer of the image used to create the virtual machines.
  • sku - (Required) Specifies the SKU of the image used to create the virtual machines.
  • version - (Optional) Specifies the version of the image used to create the virtual machines.

Attributes Reference

The following attributes are exported:

  • id - The virtual machine scale set ID.