Belajar Kubernetes Distributed Storage - Toolbox & Ceph Dashboard

#Pendahuluan

Cluster Ceph sudah HEALTH_OK di episode 5. Episode 6 memberi kalian jendela pengamatan: dua alat penting — toolbox (CLI ceph) dan Ceph dashboard (UI grafis). Inilah cara kalian berinteraksi dengan cluster sepanjang series ini.

Mengapa penting? ceph -s adalah jantung diagnosis. Tanpa toolbox, kalian tidak bisa memeriksa osd tree, df, atau health detail. Dashboard memvisualkan apa yang sulit dibaca dari teks. Keduanya wajib dikuasai sejak awal.

#Deploy Toolbox

#Manifest Toolbox

Rook menyediakan toolbox.yaml:

yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: rook-ceph-tools
  namespace: rook-ceph
  labels:
    app: rook-ceph-tools
spec:
  replicas: 1
  selector:
    matchLabels:
      app: rook-ceph-tools
  template:
    metadata:
      labels:
        app: rook-ceph-tools
    spec:
      dnsPolicy: ClusterFirstWithHostNet
      containers:
        - name: rook-ceph-tools
          image: rook/ceph:v1.20.2
          command: ["/bin/bash"]
          args: ["-m", "-c", "/usr/local/bin/toolbox.sh"]
          imagePullPolicy: IfNotPresent
          securityContext:
            privileged: true
          env:
            - name: ROOK_CEPH_USERNAME
              value: admin-keyring

#Apply & Akses

Deploy dan masuki toolbox

kubectl apply -f toolbox.yaml
kubectl -n rook-ceph exec -it deploy/rook-ceph-tools -- bash

Di dalam shell toolbox, semua perintah ceph tersedia.

#Perintah Diagnostik (di toolbox)

#Dasar yang Wajib Kamu Hafal

Perintah diagnostik dasar

ceph status
ceph health detail
ceph osd tree
ceph df
ceph mon dump
rados df

Perintah	Memberi Tahu
`ceph status`	Health, versi, osd up/down, PG states
`ceph health detail`	Alasan HEALTH_WARN/ERR
`ceph osd tree`	Topologi OSD + status (up/in, weight)
`ceph df`	Kapasitas RAW, used, % per pool
`ceph mon dump`	Info MON (quorum, address)
`rados df`	Penggunaan object per pool

#Contoh Output `ceph df`

text

RAW STORAGE:
  TOTAL: 200 GiB   USED: 2 GiB   AVAIL: 198 GiB
POOLS:
  POOL                    ID   USED   OBJECTS
  replicapool              1   0 B      0

Ini dasar untuk kapasitas plan (episode 26).

#Aktifkan Dashboard

#Patch CephCluster

Dashboard sudah diaktifkan di manifest episode 5 (dashboard.enabled: true). Jika belum, tambahkan via:

yaml

spec:
  dashboard:
    enabled: true
    port: 8443

#Akses Dashboard

Port-forward dashboard

kubectl -n rook-ceph port-forward svc/rook-ceph-mgr-dashboard 8443:8443

Buka https://localhost:8443 (dengan self-signed cert default).

Dashboard Ceph menggunakan autentikasi internal. Buat user:

Buat user dashboard (di toolbox)

ceph dashboard ac-user-create admin -i - <<< "PasswordRahasia"

Lalu login dengan user admin dan password tersebut.

#Dashboard: Tampilan Penting

Overview: health status, mon/mgr/osd counts, warning.
Cluster → Hosts: status node, OSD di tiap host.
Cluster → OSD: per-OSD usage, PG, I/O.
Pools: kapasitas & benda tiap pool.
Dashboard juga menampilkan latency, throughput, dan rekaman performa (perf counters).

#Grafana/Prometheus (Opsional)

Rook menyediakan pendamping monitoring untuk Prometheus & Grafana:

ServiceMonitor untuk scrape metrik dari rook-ceph-mgr-prometheus.
Grafana dashboards resmi Rook.

Kita bahas mendalam di episode 18. Untuk sekarang, cukup ketahui bahwa dashboard Ceph sudah mencukupi untuk memantau lab.

Tip

Toolbox memakai image yang sama dengan OSD — hemat download. Jangan jalankan ceph perintah invasif (misal ceph osd down) di production tanpa perencanaan; cukup diagnosis di sini, tindakan via manifest/operator.

#Penutup

Inti yang harus dibawa pulang:

Toolbox rook-ceph-tools memberi akses CLI ceph penuh.
Hafalkan: ceph status, ceph osd tree, ceph df, ceph mon dump, rados df.
Dashboard aktif via spec.dashboard.enabled; akses via port-forward; buat user aman.
Monitoring penuh bisa ditambahkan dengan Prometheus/Grafana (episode 18).

Di episode 7 selanjutnya kita akan membahas block storage (RBD) untuk database — membuat CephBlockPool dengan failureDomain host, StorageClass RBD, dan menjalankan PostgreSQL StatefulSet di atasnya. Sampai jumpa di episode 7!