Belajar Puppet - Bolt & Orchestration

#Pendahuluan

Di episode 10 kalian melihat Tasks dan Plans berjalan di Puppet Enterprise. Kini kita lepas dari Console dan memegang kendali langsung: di episode 11 kita belajar Bolt, tool orchestration open source dari Puppet yang bisa berdiri sendiri tanpa PE. Bolt menjalankan task, plan, command, dan script ke banyak target sekaligus melalui SSH, WinRM, atau koneksi lain — melengkapi model pull agent Puppet dengan kekuatan push.

Pola kerjanya sederhana: tentukan target di inventory, pilih aksi, lalu jalankan. Bolt menangani koneksi paralel, hasil per target, dan pengumpulan output.

#Instalasi Bolt

Bolt tersedia sebagai paket resmi untuk distro Linux utama dan macOS:

wget https://apt.puppet.com/puppet8-release-focal.deb
sudo dpkg -i puppet8-release-focal.deb
sudo apt-get update
sudo apt-get install puppet-bolt

bolt --version
bolt task show

bolt --version memastikan binary terpasang, sedangkan bolt task show menampilkan daftar task bawaan. Bolt dikirim dengan kumpulan task standar seperti service, package, dan reboot yang langsung bisa dipakai.

#inventory.yaml

Target dikelompokkan dalam file inventory.yaml. Ini adalah sumber kebenaran tentang node mana yang bisa diakses dan bagaimana caranya:

version: 2
groups:
  - name: web
    targets:
      - web01.example.com
      - web02.example.com
    config:
      transport: ssh
      ssh:
        user: deploy
        private-key: ~/.ssh/id_ed25519
        run-as: root
  - name: windows
    targets:
      - win01.corp.local
    config:
      transport: winrm
      winrm:
        user: svc-bolt
        password: '$${winrm_password}'
  - name: all
    targets:
      - 10.0.0.0

Grup bisa bertingkat: grup all menyatukan grup web dan windows, sehingga satu target di jalankan ke semuanya. Transport default adalah SSH untuk Linux dan WinRM untuk Windows, dan keduanya bisa diatur per grup.

#Menjalankan Task

Task dijalankan dengan bolt task run. Bentuk paling sederhana memakai task bawaan service:

bolt task run service action=restart name=nginx --targets web

Hasilnya ditampilkan per target dengan status sukses atau gagal. Untuk task dari module, panggil dengan nama lengkapnya:

bolt task run profile::collect_logs --targets web --params '{"days": 7}'

Perintah bolt command run menjalankan shell command langsung, dan bolt script run menjalankan script dari mesin lokal tanpa harus di-package dulu sebagai task:

bolt command run 'df -h /' --targets web
bolt script run ./scripts/collect-logs.sh --targets web

#Task dan Plan

Task custom cukup sebuah skrip plus metadata.json. Skrip menerima parameter lewat stdin dalam format JSON:

#!/bin/bash
systemctl restart nginx

{
  "description": "Restart layanan nginx",
  "input_method": "stdin",
  "parameters": {
    "service": {
      "type": "String[1]",
      "description": "Nama layanan"
    }
  }
}

Plan menggabungkan beberapa langkah dan bisa mengambil keputusan di tengah jalan:

plan upgrade::web(
  TargetSpec $targets,
  String[1] $version,
) {
  $targets.apply_prep
  run_task('deploy::stop', $targets)
  run_task('deploy::update', $targets, version => $version)
  run_task('deploy::start', $targets)
}

Jalankan plan dengan bolt plan run:

bolt plan run upgrade::web version=1.2.0 --targets web

Perhatikan keajaiban $targets.apply_prep — baris itu menginstal modul Puppet ke target secara otomatis agar task bisa berjalan. Jika task sudah tersedia di target, langkah ini bisa dilewati.

#Menggabungkan Bolt dan Puppet Agent

Puppet agent bekerja dengan model pull: ia menunggu jadwal untuk mengambil catalog dan menerapkannya. Bolt bekerja dengan model push: kita memerintahkan aksi langsung. Keduanya bukan pesaing, melainkan pelengkap.

Kombinasi paling umum adalah memicu run agent dari Bolt ketika ingin perubahan diterapkan segera, misalnya setelah deploy:

bolt command run 'puppet agent -t' --targets web
bolt command run 'puppet agent -t --noop' --targets web

puppet agent -t menjalankan satu run agent seketika, sedangkan --noop menampilkan apa yang akan diubah tanpa menerapkannya — aman untuk inspeksi. Dengan cara ini, konfigurasi tetap dikelola lewat manifest (pull), sementara waktu eksekusinya dikendalikan dari luar (push).

#Studi Kasus: Rolling Restart

Kombinasi plan dan target batching membuat operasi aman di fleet besar. Contoh plan yang me-restart layanan dua node sekaligus agar downtime tidak pernah terjadi bersamaan:

plan web::rolling_restart(
  TargetSpec $targets,
) {
  $batches = $targets.slice(2)
  $batches.each |$batch| {
    run_task('service', $batch, action => 'restart', name => 'nginx')
    run_command('sleep 5', $batch)
  }
  run_command('curl -f http://localhost/healthz', $targets)
}

Setiap batch di-restart, diberi jeda, lalu seluruh target dicek health-nya dengan curl. Jika satu batch gagal, output plan menunjukkannya dengan jelas dan eksekusi batch berikutnya tetap berlanjut.

#Penutup

Bolt memberi kalian tangan langsung di atas infrastruktur tanpa melepas kendali manifest.

• Bolt adalah tool orchestration push yang berjalan tanpa server Puppet.
• inventory.yaml mengelompokkan target dan mengatur transport SSH atau WinRM per grup.
• bolt task run, bolt command run, dan bolt script run mengeksekusi aksi secara paralel dengan hasil per target.
• Plans mengorkestrasi banyak langkah lengkap dengan logika dan pengecekan.
• Pull untuk state, push untuk aksi — gabungkan Puppet agent dan Bolt sesuai kekuatan masing-masing.

Dengan ini kalian bisa menggerakkan seluruh fleet dalam hitungan detik. Tapi siapa yang men-deploy kode manifest itu sendiri? Di episode 12, kalian akan belajar Code Manager dan r10k: environment berbasis branch dari git, deployment production vs staging, versi module lewat Puppetfile, dan alur kontrol versi untuk environment. Sampai jumpa!