Belajar Chef - Attributes & Ohai

#Pendahuluan

Di episode 4 kalian sudah menguasai resource dan recipe — bahasa inti untuk mendeskripsikan apa yang diinginkan. Namun ada pertanyaan yang pasti muncul begitu recipe kalian mulai kompleks: bagaimana cara membuat satu cookbook berperilaku berbeda di node yang berbeda? Jawabannya ada di attributes.

Episode 5 ini membedah dua konsep yang sering dianggap sulit padahal justru sangat fungsional: node attributes (data yang menggambarkan node dan mendorong perilaku recipe) dan Ohai (mesin yang mengumpulkan data tersebut). Kita akan membahas lima level attribute beserta urutan precedence-nya — dari mana nilainya berasal dan siapa yang menang ketika terjadi konflik — serta cara membaca attribute di dalam recipe.

#Node Attributes: Data di Balik Recipe

Attribute adalah pasangan key-value yang melekat pada node. Bayangkan attribute sebagai "KTP" sebuah node: sistem operasi apa, berapa memory-nya, IP address apa, hostname apa, dan pengaturan apa yang harus dipakai cookbook.

Attribute mengalir dari banyak sumber: Ohai (otomatis), attribute file di cookbook, environment, role, dan atribut yang di-set langsung di node. Pertanyaannya kemudian: jika banyak sumber menetapkan nilai yang sama, siapa yang menang? Inilah yang diatur oleh precedence.

#Lima Level Attribute & Precedence

Chef mengenal beberapa level attribute. Di level awal series ini, fokus pada lima level utama berikut, diurutkan dari prioritas terendah ke tertinggi:

Aturan emasnya: level dengan prioritas lebih tinggi menimpa level yang lebih rendah. automatic (Ohai) selalu menang, default selalu kalah.

1. default        (cookbook attribute)   -- paling mudah ditimpa
2. force_default  (memaksa nilai default)
3. normal         (di-set langsung di node)
4. override       (role / environment / cookbook)
5. automatic      (Ohai)                 -- tidak bisa ditimpa cookbook

#Dari Mana Nilai Datang

Untuk memahami precedence, kita harus tahu dari mana tiap level datang:

• default — dideklarasikan di attributes/default.rb cookbook.
• force_default — juga dari attribute file, tapi lebih diprioritaskan.
• normal — disimpan di node object di server, biasanya via knife node edit node-01.
• override — dari attribute file cookbook, role, atau environment.
• automatic — sepenuhnya dari Ohai, tidak pernah ditulis manual.

Contoh deklarasi di attribute file cookbook:

default['nginx']['port'] = 80
default['nginx']['worker_processes'] = 2
default['nginx']['server_name'] = 'example.com'

#Ohai: Mesin Fakta Sistem

Ohai adalah tool yang dijalankan chef-client di fase pertama (ingat episode 2) untuk mengumpulkan fakta node menjadi attribute automatic. Ohai bekerja melalui plugin — setiap plugin bertanggung jawab atas satu area data.

Plugin Ohai yang paling sering dipakai:

platform: ubuntu
platform_version: 22.04
memory.total: 3.82GB
cpu.total: 2
hostname: node-01
network.interfaces.eth0.addresses: 10.0.0.11

Untuk melihat data Ohai secara langsung di node:

ohai platform
ohai memory
ohai network/ipaddress

#Menulis Plugin Ohai Sendiri

Jika data bawaan belum cukup, kita bisa menulis plugin Ohai sendiri. Plugin ditulis dalam Ruby dan ditaruh di ohai/plugins/ cookbook.

Ohai.plugin(:AppVersion) do
  provides 'app_version'
 
  collect_data(:linux) do
    app_version(
      shell_out('cat /opt/app/version.txt').stdout.strip
    ) if File.exist?('/opt/app/version.txt')
  end
end

Plugin di atas membaca versi aplikasi dari sebuah file dan memublikasikannya sebagai attribute app_version. Setelah di-load, recipe bisa membacanya seperti attribute biasa.

#Membaca Node Attribute di Recipe

Sekarang bagian praktisnya: bagaimana recipe memakai attribute. Ada dua cara — membaca attribute node, dan membaca attribute dari cookbook.

# Attribute automatic dari Ohai
log node['platform'] do
  level :info
end
 
# Kombinasi untuk keputusan bercabang
if node['platform_family'] == 'debian'
  package 'nginx' do
    action :install
  end
end
 
# Attribute default dari cookbook sendiri
log "Port nginx: #{node['nginx']['port']}" do
  level :info
end

#Contoh Praktis: Recipe yang Menyesuaikan Platform

Mari gabungkan semuanya. Recipe berikut menggunakan attribute Ohai untuk menyesuaikan package dan service name sesuai platform:

webserver_package = node['platform_family'] == 'debian' ? 'nginx' : 'httpd'
 
package webserver_package do
  action :install
end
 
service webserver_package do
  action [:enable, :start]
end
 
# Gunakan attribute default cookbook untuk konfigurasi
template '/etc/nginx/conf.d/server.conf' do
  source 'server.conf.erb'
  variables(
    server_name: node['nginx']['server_name'],
    port: node['nginx']['port']
  )
  notifies :restart, "service[#{webserver_package}]"
end

knife node edit node-01

{
  "name": "node-01",
  "normal": {
    "nginx": {
      "port": 8080
    }
  }
}

#Menampilkan Semua Attribute Node

Untuk debugging, kita bisa melihat seluruh attribute sebuah node sekaligus:

knife node show node-01 --format json

#Penutup

Di episode 5 ini kita sudah membedah dua fondasi data Chef: node attributes beserta lima level dan precedence-nya (default, force_default, normal, override, automatic), cara Ohai dan plugin-pluginnya mengumpulkan fakta sistem, serta cara membaca attribute di dalam recipe untuk membuat cookbook yang adaptif.

Inti yang harus dibawa pulang:

• Attribute adalah data node yang mendorong perilaku recipe, dari sumber Ohai dan cookbook.
• Precedence dari terendah ke tertinggi: default, force_default, normal, override, automatic.
• Ohai mengumpulkan fakta otomatis (OS, memory, network) menjadi attribute automatic.
• Plugin Ohai custom bisa ditulis untuk menambahkan data khusus aplikasi.
• Satu cookbook, banyak konfigurasi dicapai dengan membaca attribute yang berbeda antar node.

Dengan attributes dan Ohai, cookbook kalian kini adaptif terhadap perbedaan node. Di episode 6 selanjutnya, kita akan membahas cookbook & run list — struktur lengkap direktori cookbook (recipes, attributes, templates, files, libraries, metadata.rb), cara menyusun run_list per node, serta peran roles dan environments untuk pengelompokan node.