Differences

This shows you the differences between two versions of the page.

--- guide:cloud:advanced [2025/10/21 14:50]
sfebruary [Single, generic, VM project]
+++ guide:cloud:advanced [2025/10/22 10:21] (current)
sfebruary [Single, generic, VM project]
@@ Line 144: / Line 144: @@
 ==== Single, generic, VM project ====
-Now that we have some base resources defined, we can proceed to creating an OpenStack instance via the IAC approach. Start by
+Now that we have some base resources defined, we can proceed to creating an OpenStack instance via the IAC approach. To illustrate the concept, we can again draw on a [[https://github.com/sfebruary/terraform-module-openstack-instance|pre-defined module for an instance]]. NB! This particular example assumes that an SSH key-pair already exists as a resource within your OpenStack project space, as well as a Security Group that allows SSH access to your instances, so be sure to create those first as they will be referenced below.
+Begin by [[https://docs.gitlab.com/user/project/#create-a-blank-project|creating a new, blank project in GitLab]].
+Next, we want to create a few files:
+**main.tf**:
+  terraform {
+    backend "http" {
+    }
+    required_providers {
+      openstack = {
+        source  = "terraform-provider-openstack/openstack"
+        version = "3.0.0"
+      }
+    }
+  }
+  provider "openstack" {
+    # Configuration options
+  }
+  module "instance-project" {
+    source = "git::git@github.com:sfebruary/terraform-module-openstack-instance.git?ref=main"
+    image_name               = var.image_name
+    flavor_name              = var.flavor_name
+    shortname                = var.shortname
+    key_pair_name            = var.key_pair_name
+    volume_name              = var.volume_name
+    volume_size              = var.volume_size
+    volume_type              = var.volume_type
+    volume_device_path       = var.volume_device_path
+    enable_online_resize     = var.enable_online_resize
+    public_network_name      = var.public_network_name
+    private_network_name     = var.private_network_name
+    private_subnet_name      = var.private_subnet_name
+    server_private_port_name = var.server_private_port_name
+    server_private_ip        = var.server_private_ip
+    ssh_security_group_name  = var.ssh_security_group_name
+    admin_username           = var.admin_username
+  }
+**settings.tfvars**:
+  # general instance settings
+  image_name           = "Rocky 9"
+  flavor_name          = "C4.small"
+  shortname            = "instance-project"
+  volume_name          = "SSD-volume-128"
+  volume_size          = "128"
+  volume_type          = "SSD"
+  volume_device_path   = "/dev/vdc"
+  enable_online_resize = "true"
+  admin_username       = "rocky"
+  # network settings
+  public_network_name      = "Public Internet"
+  private_network_name     = "Private Research Network"
+  private_subnet_name      = "Private Subnet"
+  server_private_port_name = "instance-private-port"
+  server_private_ip        = "10.0.0.11"
+  ssh_security_group_name  = "ssh-secgroup"
+  key_pair_name            = "instance-keypair"
+**variables.tf**:
+  variable "public_network_name" {
+    type        = string
+    description = "The name of the public network"
+    default     = null
+  }
+  variable "private_network_name" {
+    type        = string
+    description = "The name of the private network"
+    default     = null
+  }
+  variable "private_subnet_name" {
+    type        = string
+    description = "The name of the private subnet"
+    default     = null
+  }
+  variable "server_private_port_name" {
+    type        = string
+    description = "The name of the private network port for the instance"
+    default     = null
+  }
+  variable "server_private_ip" {
+    type        = string
+    description = "The fixed IP address of the instance on the private network"
+    default     = null
+  }
+  variable "image_name" {
+    type        = string
+    description = "The image to be used for the instance"
+    default     = null
+  }
+  variable "admin_username" {
+    type        = string
+    description = "The admin username to be used for the instance"
+    default     = null
+  }
+  variable "shortname" {
+    type        = string
+    description = "The shortname to assign to the instance"
+    default     = null
+  }
+  variable "flavor_name" {
+    type        = string
+    description = "The flavor for the instance"
+    default     = null
+  }
+  variable "volume_name" {
+    type        = string
+    description = "The volume name to assign to the device"
+    default     = null
+  }
+  variable "volume_size" {
+    type        = string
+    description = "The volume size to assign to the device"
+    default     = null
+  }
+  variable "volume_type" {
+    type        = string
+    description = "The volume type to assign to the device"
+    default     = null
+  }
+  variable "volume_device_path" {
+    type        = string
+    description = "The path to the device associated with the volume"
+    default     = null
+  }
+  variable "enable_online_resize" {
+    type        = bool
+    description = "Enable volume to be resized on the fly or not"
+    default     = null
+  }
+  variable "key_pair_name" {
+    type        = string
+    description = "The name of the pre-defined key-pair to use for logging in to the nodes"
+    default     = null
+  }
+  variable "ssh_security_group_name" {
+    type        = string
+    description = "The name of the security group to allow ssh access"
+    default     = null
+  }
+Finally, proceed to initialise Terraform, plan and apply as we did above in the case of the base project.
+NB! In order to assign a publicly reachable IP address (i.e. a floating IP) to the above instance, you may either modify the above to include this to be done via code, or this may be done/managed via the Horizon dashboard too.

wiki.chpc.ac.za

User Tools

Site Tools

Differences

Page Tools