Skip to content

Latest commit

 

History

History
179 lines (111 loc) · 5.08 KB

README.md

File metadata and controls

179 lines (111 loc) · 5.08 KB

simple_azure

Creates a bunch of virtual machines on Azure. It makes use of https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs.

Example Usage

module "simple_azure" {

  # Path to the module.
  source = "git::https://github.com/scmschmidt/simple_deployment.git//modules/simple_azure"
  
  # Region and used subnet.
  location = "westeurope"
  subnet   = "172.31.0.0/16"
  
  # The name prefix for our resources.
  name = "sschmidt-spielwiese"

  # Map of the machines to create. Each machine has a unique id with a tuple of 'size' and 'image'.
  machines = {
    1    = ["standard_b1", "sles4sap_15"],
    2    = ["standard_b1", "sles4sap_15.1"],
    "3a" = ["standard_b1", "sles4sap_15.1"],
    "3b" = ["standard_b1", "sles4sap_15.2"],
    4    = ["standard_b1", "sles4sap_15.3"]
  }

  # We need a German keyboard.
  keymap = "de-latin1-nodeadkeys"

  # Our logon user with SSH public key.
  admin_user     = "enter"
  admin_user_key = "ssh-rsa ..." 

  # Server and key to register the SLES.
  subscription_registration_key = "..."
  registration_server           = "https://scc.suse.com"

  # We also want to logon as root.
  enable_root_login = true
}

# Return the Name, size/image and IP address of each instance, eg.:
#   test_machines_B = [
#     "sschmidt-testlandscape-B-0 : standard_b1/sles4sap_15 -> 137.116.221.168",
#     "sschmidt-testlandscape-B-1 : standard_b1/sles4sap_15 -> 20.224.248.88",
#     ...
output "test_machines" {
  value = [
    for name, info in module.test_landscape_B.machine_info :
    "${name} : ${info.size}/${info.image} -> ${info.ip_address}"
  ]
  description = "Information about the instances."
  sensitive   = false
}

Argument Reference

The following arguments are supported:

  • source (mandatory)

    Points to the module directory either local (relative to the project folder or remote (GitHub). See https://www.terraform.io/language/modules/sources for details.

  • location (mandatory)

    The Azure location where everything gets created. To get a list, run: az account list-locations -o table

  • subnet (optional)

    Network for Azure's virtual network.

    Default: 172.31.0.0/16

  • name (mandatory)

    Name of the environment. It is used throughout the installation as prefix for the resources.

  • owner_tag (optional)

    Owner of the environment. Used as tag for resources.

    Default: ""

  • managed_by_tag (optional)

    Describes what manages the environment. Used as tag for resources.

    Default: terraform

  • application_tag (optional) Application which uses the resources. Used as tag for resources.

    Default: ""

  • machines (mandatory)

    Map with unique id as key and tuples with the size and image data for the instance: [size, image] as data.

    Id is used as an identifier for various resources. The machine name is a catenation of name and id. Take care, that the key is unique! Terraform will always take silently the last hit. "Renaming" of machines can lead to strange effects and might brake your environment!

    Size is an identifier to select the sizing for the virtual machine. The identifiers must be provided by the file sizing_azure.yaml in the project root directory, which must contain the identifiers you want to use, which point to the identifiers used by Azure..

    An example can be found in the modules directory.

    Image is an identifier to select the correct source image for the virtual machine. The identifiers and the images must be provided by the file images_azure.yaml in the project root directory, which must contain the identifiers you want to use, which point to the image description used by Azure.

    An example can be found in the modules directory.

    Having a mapping allows the usage of the same identifier with all three modules. The mapping resolves them into the correct names for AWS, Azure and libvirt.

  • keymap (optional)

    The keymap used on the machines.

    Default: de-latin1-nodeadkeys

  • admin_user (optional)

    The unprivileged user to logon to the deployed machine.

    Default: enter

  • admin_user_key (mandatory)

    The SSH public key for the admin user to logon to the machine.

  • subscription_registration_key (optional)

    Subscription registration code to register SLES.

    Default: "-"

  • registration_server (optional)

    URL to the registration server. A "-" as value skips the registration.

    Default: https://scc.suse.com

  • enable_root_login (optional)

    Enable or disable the SSH root login (with admin user key).

    Default: false

  • amount (optional)

    So many instances of this machine description get created.

    Default: 1

Output

The module outputs the following variables:

  • machines (list)

    The azurerm_linux_virtual_machine data for each instance.

  • machine_info (object)

    Aggregated information for each instance. The instance names get used as keys and the value is an object with:

    • id - The instance id.
    • size - The sizing identifier used in the plan.
    • image - The image identifier used in the plan.
    • ip_address - The public IP for the instance.