Belajar OpenTofu - OpenTofu Providers & Resource Declarations

#Pendahuluan

Di episode 2 kita menjalankan workflow inti dan melihat OpenTofu Registry. Kalian sudah tahu bagaimana tofu init mengunduh provider dan bagaimana tofu plan menghasilkan pratinjau. Pertanyaannya sekarang: dari mana OpenTofu tahu resource apa yang harus dibuat? Jawabannya ada di deklarasi di dalam file .tf — topik episode 3 ini.

Di episode ini kita membahas tiga fondasi deklarasi: provider block (menghubungkan OpenTofu ke API cloud), resource block (sesuatu yang dibuat), dan data source (sesuatu yang sudah ada dan datanya diambil). Setelah selesai, kalian bisa membaca konfigurasi OpenTofu apa pun dengan percaya diri.

#Pembahasan Utama

#Provider: Jembatan OpenTofu ke Cloud API

Provider adalah plugin yang menerjemahkan permintaan OpenTofu menjadi panggilan API cloud. Analoginya seperti driver printer: OpenTofu tidak perlu tahu cara bicara ke AWS — provider hashicorp/aws yang melakukannya.

Deklarasi provider terjadi di dua level. Pertama, blok required_providers untuk mengunci sumber dan versi:

versions.tf

terraform {
  required_version = ">= 1.6"
 
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

source menunjuk lokasi di registry; version = "~> 5.0" berarti versi 5.x apa pun. Kedua, blok provider untuk konfigurasi instansi, misalnya region dan kredensial:

providers.tf

provider "aws" {
  region = "ap-southeast-1"
}

Note

Untuk GCP kalian menulis source = "hashicorp/google" dan provider "google" { project = var.project_id }. Polanya identik — hanya nama provider yang berbeda. Seluruh ekosistem provider mengikuti kontrak yang sama.

#Resource Block: Deklarasi "Apa yang Harus Ada"

Setelah provider siap, kalian mendeklarasikan resource: satu objek konkret di cloud. Sintaksnya selalu berbentuk resource "TYPE" "NAME" { ... } — tipe ditentukan oleh provider, nama bebas kalian pilih sebagai label internal.

main.tf

resource "aws_instance" "web" {
  ami           = data.aws_ami.ubuntu.id
  instance_type = "t3.micro"
 
  tags = {
    Name = "web-server"
  }
}

Resource bisa dibaca seperti kalimat: sebuah EC2 instance bernama web, memakai AMI dari data source ubuntu, tipe t3.micro, dengan tag Name web-server. Jika kalian menjalankan tofu apply, OpenTofu memanggil provider untuk membuat instance ini di cloud.

Block resource juga bisa dilengkapi meta-arguments seperti count, for_each, dan depends_on — akan dibahas detail di episode 8. Untuk sekarang, pahami konsep deklarasinya.

#Data Source: Mengambil Data Infrastruktur Eksisting

Tidak semua infrastruktur diciptakan OpenTofu. Kadang kalian butuh referensi ke resource yang sudah ada — misalnya AMI, VPC default, atau IAM role — tanpa mengelola lifecycle-nya. Di situlah data source berperan: ia membaca (read-only), tidak membuat apa pun.

data.tf

data "aws_ami" "ubuntu" {
  most_recent = true
 
  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/ubuntu-*-amd64-server-*"]
  }
 
  owners = ["099720109477"]
}

Data source menghasilkan atribut yang bisa direferensikan dari resource. Perhatikan pada contoh resource tadi: ami = data.aws_ami.ubuntu.id — ini mengambil id AMI hasil pencarian.

Kunci membedakan keduanya: resource = OpenTofu yang membuat; data source = OpenTofu yang membaca.

Tip

Gunakan data source untuk hal yang jarang berubah tapi sering direferensikan — AMI terbaru, subnet default, atau security group yang dikelola tim lain. Ini menghindarkan kalian dari hardcode ID yang cepat basi.

#Alur Lengkap dalam Satu Project

Untuk melihat ketiganya bekerja sama, berikut struktur satu project sederhana:

plaintext

lab-opentofu/
├── versions.tf   # terraform block + required_providers
├── providers.tf  # konfigurasi provider
├── data.tf       # data source (baca infrastruktur eksisting)
└── main.tf       # resource yang akan dibuat

Alurnya: tofu init mengunduh provider sesuai versions.tf, tofu plan membaca data source dan membandingkan resource dengan state, lalu tofu apply membuat resource di cloud. Ketiga file itu adalah pola standar yang akan kalian lihat di hampir semua repository IaC profesional.

#Penutup

Ringkasan episode 3:

Provider dideklarasi lewat blok terraform { required_providers } dan blok provider — source plus versi di block pertama, konfigurasi instansi di block kedua.
Resource block resource "type" "name" { ... } mendeklarasikan objek cloud yang OpenTofu kelola sepenuhnya.
Data source data "type" "name" { ... } membaca data eksisting, dan hasilnya bisa direferensikan seperti atribut resource.
Aturan praktis: resource membuat, data source membaca.

Kalian sekarang sudah bisa menulis konfigurasi yang benar dan terstruktur. Di episode 4 berikutnya kita membuat kode itu lebih fleksibel dan reusable dengan input variables, local values, dan output values — alat untuk menghilangkan hardcode dari konfigurasi. Sampai jumpa!