Skip to content

README.md

Latest commit

 

History

History
77 lines (60 loc) · 2.47 KB

README.md

File metadata and controls

77 lines (60 loc) · 2.47 KB
Raw

compute

Reusable module to launch one or more identical OpenStack (Nova) compute instances on an existing tenant network.

Usage

module "compute" {
  source = "github.com/devopsaitoolkit/terraform-openstack-examples//modules/compute"

  name                 = "web"
  instance_count       = 3
  flavor_name          = "m1.small"
  image_name           = "ubuntu-22.04"
  network_id           = "11111111-1111-1111-1111-111111111111"
  key_pair_name        = "ops-key"
  security_group_names = ["default", "web"]
  metadata             = { role = "web" }
  tags                 = ["managed-by:terraform"]
}

Requirements

Name Version
terraform >= 1.3
openstack (terraform-provider-openstack/openstack) ~> 3.0

Inputs

Name Description Type Default Required
name Base name; index-suffixed when instance_count > 1 string n/a yes
instance_count Number of identical instances number 1 no
flavor_name Nova flavor (size) string n/a yes
image_name Glance image to boot string n/a yes
network_id UUID of the network to attach string n/a yes
key_pair_name Existing key pair for SSH (optional) string "" no
security_group_names Security groups to attach list(string) ["default"] no
metadata Per-instance metadata map(string) {} no
user_data Cloud-init user data (optional) string "" no
availability_zone AZ to schedule in (optional) string "" no
tags Instance tags list(string) [] no

Outputs

Name Description
instance_ids UUIDs of the created instances
instance_names Names of the created instances
access_ips First IPv4 address of each instance

Architecture

flowchart LR
    TF[Terraform] -->|count| VM["openstack_compute_instance_v2[*]"]
    NID[network_id] -->|network.uuid| VM
    VM -->|boots from| IMG[(Glance image)]
    VM -->|sized by| FLV[(Nova flavor)]
    SG[security_group_names] -->|security_groups| VM
Loading

Testing

terraform test runs the suite in tests/ using mock_provider "openstack" {}, so no cloud, credentials, or terraform apply are required. From the module directory:

terraform init
terraform test

Further reading