Belajar Chef - Resources & Recipes

#Pendahuluan

Di episode 3 kalian sudah berhasil membuat cookbook nginx dan mengkonvergennya ke node uji, serta menyentuh dua resource pertama: package dan service. Sekarang saatnya melengkapi kemampuan itu dengan memahami resource sebagai bahasa inti Chef dan recipe sebagai cara menyusunnya.

Episode 4 ini adalah episode paling fundamental di seluruh series — karena apapun yang ingin kalian lakukan dengan Chef, dari install package hingga mengelola user, semuanya adalah resource. Kita akan membahas delapan resource dasar (package, service, file, template, execute, directory, user, group), properti dan action masing-masing, cara menyusun recipe secara deklaratif, dan bagaimana idempotency bekerja di balik setiap resource.

#Resource: Unit Terkecil Chef

Resource adalah pernyataan deklaratif tentang state yang diinginkan. Setiap resource memiliki tiga bagian utama: tipe resource (misal package), nama resource (identifier unik), dan blok properti & action yang mendeskripsikan state yang diinginkan.

package 'nginx' do
  version '1.24.0'     # properti
  action :install      # action
end

Saat chef-client menemukan resource ini, ia tidak langsung mengeksekusi. Ia mengumpulkan state saat ini (misal "nginx belum terinstall"), membandingkannya dengan state yang diinginkan, dan hanya bertindak jika berbeda. Inilah mengapa resource disebut declarative — kita mendeskripsikan hasil akhir, bukan langkah-langkahnya.

#Delapan Resource Dasar

Berikut delapan resource yang paling sering dipakai di dunia nyata, lengkap dengan properti dan action utamanya.

#package

Mengelola software package, otomatis memakai package manager sesuai platform (apt, yum, dnf).

package 'nginx' do
  version '1.24.0'
  action :install
end

#service

Mengontrol service/daemon sistem. Properti action dengan array memungkinkan beberapa aksi sekaligus.

service 'nginx' do
  action [:enable, :start]
end

#file

Mengelola file: membuat, menulis isi, atau menghapus. Resource file menulis konten apa adanya (tanpa template).

file '/etc/motd' do
  content 'Selamat datang di node yang dikelola Chef'
  mode '0644'
  owner 'root'
  group 'root'
  action :create
end

#template

Seperti file, tapi kontennya di-generate dari template ERB yang bisa memuat variabel node. Template akan dibahas mendalam di episode 7.

template '/etc/nginx/sites-available/default' do
  source 'default.erb'
  variables(
    server_name: node['hostname']
  )
  notifies :reload, 'service[nginx]'
end

#execute

Menjalankan perintah shell sebarang. Gunakan dengan hati-hati karena tidak idempoten secara otomatis — butuh properti not_if atau only_if.

execute 'update-nginx-cache' do
  command 'nginx -s reload'
  action :run
  not_if 'test ! -f /etc/nginx/nginx.conf'
end

#directory

Mengelola direktori, termasuk direktori bertingkat dengan recursive.

directory '/var/www/example' do
  owner 'www-data'
  group 'www-data'
  mode '0755'
  recursive true
  action :create
end

#user

Mengelola user sistem.

user 'deploy' do
  comment 'Akun deploy aplikasi'
  home '/home/deploy'
  shell '/bin/bash'
  uid 1001
  action :create
end

#group

Mengelola group sistem.

group 'developers' do
  members ['deploy', 'ops']
  append true
  action :create
end

#Ringkasan Resource dalam Tabel

#Menyusun Recipe Secara Deklaratif

Sebuah recipe hanyalah kumpulan resource yang disusun berurutan. Meski urutan resource memengaruhi urutan eksekusi, penting untuk tetap berpikir deklaratif: deskripsikan state akhir, bukan prosedur. Bandingkan dua cara berpikir untuk task yang sama — install nginx, buat direktori, dan letakkan file index:

package 'nginx' do
  action :install
end
 
directory '/var/www/example' do
  owner 'www-data'
  mode '0755'
  recursive true
  action :create
end
 
file '/var/www/example/index.html' do
  content '<h1>Hello Chef!</h1>'
  mode '0644'
  action :create
end
 
service 'nginx' do
  action [:enable, :start]
end

sudo apt install -y nginx
sudo mkdir -p /var/www/example
sudo chown -R www-data:www-data /var/www/example
echo '<h1>Hello Chef!</h1>' | sudo tee /var/www/example/index.html
sudo systemctl enable --now nginx

Perhatikan perbedaannya: versi Chef lebih panjang sedikit di kode, tapi menjamin idempotency. Versi shell harus dijalankan dengan sangat hati-hati dan tidak aman untuk dijalankan dua kali.

#Menguji Idempotency

Mari praktikkan konsep yang sudah kita bahas sejak episode 1. Konvergen recipe dua kali dan amati outputnya:

cd ~/lab-chef/chef-repo
knife cookbook upload nginx
knife ssh 'name:node-01' 'sudo chef-client' --ssh-user devops

# Run pertama: ada perubahan
  * directory[/var/www/example] action create
    - create new directory /var/www/example
  * service[nginx] action start
    - start service service[nginx]
Chef Infra Client finished, 3/3 resources updated
 
# Run kedua: semuanya up to date
  * directory[/var/www/example] action create
    - up to date
  * service[nginx] action start
    - up to date
Chef Infra Client finished, 0/3 resources updated

#Penutup

Di episode 4 ini kita sudah menguasai bahasa inti Chef: delapan resource dasar, properti dan action masing-masing, cara menyusun recipe secara deklaratif, dan bukti idempotency yang bekerja nyata.

Inti yang harus dibawa pulang:

• Resource adalah pernyataan desired state — deskripsikan hasil akhir, bukan langkah.
• Delapan resource dasar menutupi hampir semua kebutuhan konfigurasi server sehari-hari.
• execute tidak idempoten — selalu lindungi dengan not_if atau only_if.
• notifies menghubungkan resource — perubahan pada file konfigurasi otomatis me-reload service.
• Tanda idempotency adalah 0/... resources updated pada run kedua.

Kalian sekarang bisa menulis recipe yang aman dan deklaratif. Di episode 5 selanjutnya, kita akan mempelajari attributes & Ohai — level attribute dan urutan precedence (default, force_default, normal, override, automatic), cara kerja plugin Ohai mengumpulkan fakta sistem (OS, memory, network), dan cara membaca node attribute di dalam recipe.