Module dan component yang reusable

Begitu dev, staging, dan production butuh bentuk yang sama, satu keypair plus satu VM, cuma beda sizing dan beberapa flag, copy-paste bentuk itu tiga kali artinya benerin bug-nya tiga kali juga. Terraform module dan Pulumi component ngebiarin lu nulis bentuknya sekali terus instantiate per environment.

Terraform module

infra/
  modules/
    neolite-vm/
      main.tf
      variables.tf
      outputs.tf
  main.tf

modules/neolite-vm/variables.tf:

variable "vm_name" {
  type = string
}

variable "product_id" {
  type = number
}

variable "select_os" {
  type = string
}

variable "cycle" {
  type = string
}

variable "ssh_and_console_user" {
  type = string
}

variable "console_password" {
  type      = string
  sensitive = true
}

variable "pay_with_credit_card" {
  type    = bool
  default = false
}

modules/neolite-vm/main.tf:

resource "biznetgio_neolite_keypair" "this" {
  name = "${var.vm_name}-key"
}

resource "biznetgio_neolite_vm" "this" {
  vm_name               = var.vm_name
  product_id            = var.product_id
  select_os              = var.select_os
  keypair_id            = biznetgio_neolite_keypair.this.keypair_id
  cycle                 = var.cycle
  ssh_and_console_user  = var.ssh_and_console_user
  console_password      = var.console_password
  pay_with_credit_card  = var.pay_with_credit_card
}

modules/neolite-vm/outputs.tf:

output "vm_status" {
  value = biznetgio_neolite_vm.this.status
}

output "keypair_private_key" {
  value     = biznetgio_neolite_keypair.this.private_key
  sensitive = true
}

Instantiate sekali per environment dari root module. var.console_password di sini itu persis yang udah dideklarasiin lengkap di tutorial quickstart dan project structure. product_id dipilih pake nama per environment, pola yang sama kayak di Environment - jangan pernah pass products[0] langsung ke module, soalnya module gak punya cara buat warning ke caller-nya kalau value itu asal-asalan:

data "biznetgio_neolite_products" "all" {}

locals {
  # Nama paket NEO Lite beneran - liat /id/products/neolite buat tabel harga lengkap.
  staging_product = [
    for p in data.biznetgio_neolite_products.all.products : p if p.name == "MS 4.2"
  ][0]
  production_product = [
    for p in data.biznetgio_neolite_products.all.products : p if p.name == "MS 4.2"
  ][0]
}

# staging dan production pake tier yang sama, jadi satu OS list cukup buat berdua
data "biznetgio_neolite_os_list" "ubuntu" {
  product_id = local.staging_product.product_id
}

module "web_staging" {
  source                = "./modules/neolite-vm"
  vm_name                = "web-staging"
  product_id            = local.staging_product.product_id
  select_os              = data.biznetgio_neolite_os_list.ubuntu.oss[0].name
  cycle                 = "m"
  ssh_and_console_user  = "adminuser"
  console_password      = var.console_password
  pay_with_credit_card  = false
}

module "web_production" {
  source                = "./modules/neolite-vm"
  vm_name                = "web-production"
  product_id            = local.production_product.product_id
  select_os              = data.biznetgio_neolite_os_list.ubuntu.oss[0].name
  cycle                 = "m"
  ssh_and_console_user  = "adminuser"
  console_password      = var.console_password
  pay_with_credit_card  = true
}

Confirm "MS 4.2" dulu ke output katalog akun lu sendiri - liat Langkah 1 di overview katalog. Source lokal ./modules/... udah cukup buat satu repository. Publish ke module registry bisa aja, tapi cuma worth it kalau lebih dari satu repository butuh module yang sama.

Pulumi component

Yang setara di Pulumi itu ComponentResource, dicontohin di sini pake TypeScript:

import * as pulumi from "@pulumi/pulumi";
import * as biznetgio from "@shirasakaren/biznetgio";

export interface NeoliteWebServerArgs {
  productId: pulumi.Input<number>;
  selectOs: pulumi.Input<string>;
  cycle: pulumi.Input<string>;
  sshAndConsoleUser: pulumi.Input<string>;
  consolePassword: pulumi.Input<string>;
  payWithCreditCard?: pulumi.Input<boolean>;
}

export class NeoliteWebServer extends pulumi.ComponentResource {
  public readonly vmStatus: pulumi.Output<string>;
  public readonly keypairPrivateKey: pulumi.Output<string>;

  constructor(name: string, args: NeoliteWebServerArgs, opts?: pulumi.ComponentResourceOptions) {
    super("biznetgio-tutorials:index:NeoliteWebServer", name, {}, opts);

    const keypair = new biznetgio.NeoliteKeypair(`${name}-key`, {
      name: `${name}-key`,
    }, { parent: this });

    const vm = new biznetgio.NeoliteVm(`${name}-vm`, {
      vmName: name,
      productId: args.productId,
      selectOs: args.selectOs,
      keypairId: keypair.keypairId,
      cycle: args.cycle,
      sshAndConsoleUser: args.sshAndConsoleUser,
      consolePassword: args.consolePassword,
      payWithCreditCard: args.payWithCreditCard ?? false,
    }, { parent: this });

    this.vmStatus = vm.status;
    this.keypairPrivateKey = keypair.privateKey;
    this.registerOutputs({ vmStatus: this.vmStatus });
  }
}

{ parent: this } daftarin keypair dan VM sebagai child dari component ini di resource tree Pulumi, jadi pulumi up dan console Pulumi Cloud nunjukin mereka nested di bawahnya, bukan sebagai dua top-level resource yang gak nyambung. Instantiate satu per stack. config itu persis yang udah dideklarasiin lengkap di quickstart Pulumi. productId dipilih pake nama, pola yang sama kayak di Environment - jangan pernah pass products[0] langsung ke component:

const stack = pulumi.getStack();
const products = biznetgio.neoliteProductsOutput();

// Nama paket NEO Lite beneran - liat /id/products/neolite buat tabel harga
// lengkap. Confirm dulu ke output katalog akun lu sendiri.
const productId = products.products.apply((items) => {
  const match = items.find((p) => p.name === "MS 4.2");
  if (!match) throw new Error("no NEO Lite product named 'MS 4.2' found");
  return match.productId;
});

const osList = biznetgio.neoliteOsListOutput({ productId: productId });

const web = new NeoliteWebServer(`web-${stack}`, {
  productId: productId,
  selectOs: osList.oss[0].name,
  cycle: "m",
  sshAndConsoleUser: "adminuser",
  consolePassword: config.requireSecret("consolePassword"),
  payWithCreditCard: stack === "production",
});

export const vmStatus = web.vmStatus;

Langkah berikutnya

Testing, validasi, dan guardrail - tangkep kesalahan sebelum module ini manggil API beneran

Mulai

Tutorial

Provider Terraform

Provider Pulumi

Panduan

Tentang

Module dan component yang reusable

Terraform module

Pulumi component

Langkah berikutnya

​Terraform module

​Pulumi component

​Langkah berikutnya

Terraform module

Pulumi component

Langkah berikutnya