Linux VM

---

This module will create a linux virtual machine, a network interface and associates the network interface to the target subnet. Optionally one or more data disks and a public ip can be created and additional network interfaces.

Usage

It's very easy to use!

provider "azurerm" {
  features {}
}

module "virtual_machine" {
  source = "../.."

  virtual_machine_config = {
    hostname       = "CUSTAPP001"
    location       = azurerm_resource_group.this.location
    size           = "Standard_B1ms"
    os_sku         = "22_04-lts-gen2"
    os_offer       = "0001-com-ubuntu-server-jammy"
    os_version     = "latest"
    os_publisher   = "Canonical"
    severity_group = "01-second-monday-0300-XCSUFEDTG-reboot"
  }
  admin_username = "local_admin"
  admin_credential = {
    admin_password = "H3ll0W0rld!"
  }

  resource_group_name = azurerm_resource_group.this.name
  subnet              = azurerm_subnet.this
}

resource "azurerm_resource_group" "this" {
  name     = "rg-TestLinuxBasic-tst-01"
  location = "westeurope"
}

resource "azurerm_virtual_network" "this" {
  name                = "vnet-10-0-0-0-24-${azurerm_resource_group.this.location}"
  address_space       = ["10.0.0.0/24"]
  location            = azurerm_resource_group.this.location
  resource_group_name = azurerm_resource_group.this.name
}

resource "azurerm_subnet" "this" {
  name                 = "snet-10-0-0-0-24-Test"
  resource_group_name  = azurerm_resource_group.this.name
  virtual_network_name = azurerm_virtual_network.this.name
  address_prefixes     = ["10.0.0.0/24"]
}

Requirements

Name	Version
terraform	>=1.5.0
azurerm	>= 3.7.0

Inputs

Name	Description	Type	Default	Required
admin_credential	Specify either admin_password or public_key: admin_password: Password of the local administrator. public_key: SSH public key file (e.g. file(id_rsa.pub))	object({ admin_password = optional(string) public_key = optional(string) })	n/a	yes
resource_group_name	Name of the resource group where the resources will be created.	string	n/a	yes
subnet	The variable takes the subnet as input and takes the id and the address prefix for further configuration.	object({ id = string address_prefixes = list(string) })	n/a	yes
virtual_machine_config	hostname: Name of system hostname. size: The size of the vm. Possible values can be seen here: https://learn.microsoft.com/en-us/azure/virtual-machines/sizes location: The location of the virtual machine. os_sku: (Required) The os that will be running on the vm. os_offer: (Required) Specifies the offer of the image used to create the virtual machines. Changing this forces a new resource to be created. os_version: (Required) Optionally specify an os version for the chosen sku. os_publisher: (Required) Specifies the Publisher of the Marketplace Image this Virtual Machine should be created from. Changing this forces a new resource to be created. os_disk_caching: Optionally change the caching option of the os disk. Defaults to ReadWrite. os_disk_size_gb: Optionally change the size of the os disk. Defaults to be specified by image. os_disk_storage_type: Optionally change the os_disk_storage_type. Defaults to StandardSSD_LRS. zone: Optionally specify an availibility zone for the vm. Values 1, 2 or 3. availability_set_id: Optionally specify an availibility set for the vm. Not compatible with zone. os_disk_write_accelerator_enabled: Optionally activate write accelaration for the os disk. Can only be activated on Premium disks and caching deactivated. Defaults to false. proximity_placement_group_id: (Optional) The ID of the Proximity Placement Group which the Virtual Machine should be assigned to. severity_group: (Required) Sets tag 'Severity Group Monthly' to a specific time and date when an update will be done automatically. update_allowed: Sets tag 'Update allowed' to yes or no to specify if this VM should currently receive updates. enable_plan: When using marketplace images, sending plan information might be required. Also accepts the terms of the marketplace product.	object({ hostname = string size = string location = string os_sku = string os_offer = string os_version = string os_publisher = string os_disk_caching = optional(string, "ReadWrite") os_disk_size_gb = optional(number) os_disk_storage_type = optional(string, "Premium_LRS") os_disk_write_accelerator_enabled = optional(bool, false) zone = optional(number) availability_set_id = optional(string) proximity_placement_group_id = optional(string) severity_group = string update_allowed = optional(bool, true) enable_plan = optional(bool, false) })	n/a	yes
additional_network_interface_ids	List of ids for additional azurerm_network_interface.	list(string)	[]	no
admin_username	Optionally choose the admin_username of the vm. Defaults to loc_sysadmin.	string	"loc_sysadmin"	no
data_disks	= { lun: Number of the lun. disk_size_gb: The size of the data disk. storage_account_type: Optionally change the storage_account_type. Defaults to StandardSSD_LRS. caching: Optionally activate disk caching. Defaults to None. create_option: Optionally change the create option. Defaults to Empty disk. source_resource_id: (Optional) The ID of an existing Managed Disk or Snapshot to copy when create_option is Copy or the recovery point to restore when create_option is Restore. Changing this forces a new resource to be created. write_accelerator_enabled: Optionally activate write accelaration for the data disk. Can only be activated on Premium disks and caching deactivated. Defaults to false. on_demand_bursting_enabled: Optionally activate disk bursting. Only for Premium disk. Default false. }	map(object({ lun = number disk_size_gb = number caching = optional(string, "ReadWrite") create_option = optional(string, "Empty") source_resource_id = optional(string) storage_account_type = optional(string, "Premium_LRS") write_accelerator_enabled = optional(bool, false) on_demand_bursting_enabled = optional(bool, false) }))	{}	no
name_overrides	Possibility to override names that will be generated according to q.beyond naming convention.	object({ nic = optional(string) nic_ip_config = optional(string) public_ip = optional(string) virtual_machine = optional(string) os_disk = optional(string) data_disks = optional(map(string), {}) })	{}	no
nic_config	private_ip: Optioanlly specify a private ip to use. Otherwise it will be allocated dynamically. dns_servers: Optionally specify a list of dns servers for the nic. enable_accelerated_networking: Enabled Accelerated networking (SR-IOV) on the NIC. The machine SKU must support this feature. nsg: Although it is discouraged you can optionally assign an NSG to the NIC. Optionally specify a NSG object.	object({ private_ip = optional(string) dns_servers = optional(list(string)) enable_accelerated_networking = optional(bool, false) nsg = optional(object({ id = string })) })	{}	no
public_ip_config	allocation_method: The allocation method of the public ip that will be created. Defaults to static. stage: The stage of this PIP. Ex: prd, dev, tst, ...	object({ allocation_method = optional(string, "Static") stage = string })	null	no
tags	A map of tags that will be set on every resource this module creates.	map(string)	{}	no

Outputs

Name	Description
data_disks	n/a
network_interface	n/a
virtual_machine	n/a

  ## Resource types

  | Type | Used |
  |------|-------|
    | [azurerm_linux_virtual_machine](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/linux_virtual_machine) | 1 |
    | [azurerm_managed_disk](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/managed_disk) | 1 |
    | [azurerm_marketplace_agreement](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/marketplace_agreement) | 1 |
    | [azurerm_network_interface](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/network_interface) | 1 |
    | [azurerm_network_interface_security_group_association](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/network_interface_security_group_association) | 1 |
    | [azurerm_public_ip](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/public_ip) | 1 |
    | [azurerm_virtual_machine_data_disk_attachment](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/virtual_machine_data_disk_attachment) | 1 |

  **`Used` only includes resource blocks.** `for_each` and `count` meta arguments, as well as resource blocks of modules are not considered.

Modules

No modules.

    ## Resources by Files

        ### data_disk.tf

        | Name | Type |
        |------|------|
              | [azurerm_managed_disk.data_disk](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/managed_disk) | resource |
              | [azurerm_virtual_machine_data_disk_attachment.data_disk](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/virtual_machine_data_disk_attachment) | resource |

        ### main.tf

        | Name | Type |
        |------|------|
              | [azurerm_linux_virtual_machine.this](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/linux_virtual_machine) | resource |
              | [azurerm_marketplace_agreement.default](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/marketplace_agreement) | resource |
              | [azurerm_network_interface.this](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/network_interface) | resource |
              | [azurerm_network_interface_security_group_association.this](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/network_interface_security_group_association) | resource |
              | [azurerm_public_ip.this](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/public_ip) | resource |

Contribute

Please use Pull requests to contribute.

When a new Feature or Fix is ready to be released, create a new Github release and adhere to Semantic Versioning 2.0.0.