SanzSkuy: Created page with "'''OKD''' adalah distribusi Kubernetes komunitas (upstream dari Red Hat OpenShift). Halaman ini mencatat langkah lengkap memasang '''OKD Single Node (SNO)''' sebagai satu VM di Proxmox VE, memakai '''Agent-based Installer''', untuk keperluan cluster dev. == Ringkasan == {| class="wikitable" ! Item !! Nilai |- | Versi OKD || `5.0.0-okd-scos.3` (stable) |- | OS node || CentOS Stream CoreOS (SCOS), ter-bake di ISO |- | Metode install || Agent-based Installer, t..."

2026-10-28T04:17:44Z

Created page with "'''OKD''' adalah distribusi Kubernetes komunitas (upstream dari Red Hat OpenShift). Halaman ini mencatat langkah lengkap memasang '''OKD Single Node (SNO)''' sebagai satu VM di Proxmox VE, memakai '''Agent-based Installer''', untuk keperluan cluster dev. == Ringkasan == {| class="wikitable" ! Item !! Nilai |- | Versi OKD || <code>5.0.0-okd-scos.3</code> (stable) |- | OS node || CentOS Stream CoreOS (SCOS), ter-bake di ISO |- | Metode install || Agent-based Installer, t..."

New page

'''OKD''' adalah distribusi Kubernetes komunitas (upstream dari Red Hat OpenShift). Halaman ini mencatat langkah lengkap memasang '''OKD Single Node (SNO)''' sebagai satu VM di Proxmox VE, memakai '''Agent-based Installer''', untuk keperluan cluster dev.

== Ringkasan ==
{| class="wikitable"
! Item !! Nilai
|-
| Versi OKD || <code>5.0.0-okd-scos.3</code> (stable)
|-
| OS node || CentOS Stream CoreOS (SCOS), ter-bake di ISO
|-
| Metode install || Agent-based Installer, topologi SNO
|-
| Hypervisor || Proxmox VE, standalone node <code>node-3</code>
|-
| Bridge jaringan || <code>vmbr3</code> (LAB) → subnet <code>192.168.90.0/24</code>
|-
| Gateway || <code>192.168.90.1</code> (MikroTik)
|-
| VM bastion (DNS) || <code>192.168.90.29</code>, AlmaLinux, dnsmasq
|-
| VM OKD (node) || <code>192.168.90.30</code>, hostname <code>okd-sno</code>
|-
| Cluster / base domain || <code>okd</code> / <code>lab.local</code>
|-
| Mesin kerja || Arch Linux (edit config + generate ISO)
|}

== Memilih topologi ==
* '''SNO (1 node)''': paling hemat resource, cocok untuk dev. Tidak ada HA, dan '''tidak bisa''' dikonversi ke cluster HA setelah terpasang.
* '''Compact cluster (3 node)''': ketiga node jadi master sekaligus worker. Lebih mirip production, tetap punya quorum etcd.
* '''2 node''': OKD punya topologi ''two-node with fencing'' (butuh BMC, tidak cocok untuk VM Proxmox) dan ''two control plane + arbiter'' (tetap 3 mesin, salah satunya arbiter kecil). Untuk lab, praktis pilih SNO atau 3 node.

Dipilih '''SNO''' supaya resource host tetap lega untuk VM lain.

== Arsitektur ==
<pre>
Arch Linux (laptop) ──WireGuard──► Proxmox (vmbr0, 192.168.11.x)
│ generate ISO
▼
Proxmox vmbr3 (LAB, 192.168.90.0/24)
├── VM bastion 192.168.90.29 → dnsmasq (DNS cluster)
└── VM OKD SNO 192.168.90.30 → seluruh cluster OKD
▲
gateway MikroTik 192.168.90.1 → internet (quay.io)
</pre>

'''Kenapa butuh bastion di dalam vmbr3?''' Host Proxmox tidak punya IP di <code>vmbr3</code>, dan laptop berada di jaringan lain (lewat WireGuard). Node OKD harus bisa menjangkau DNS-nya, jadi DNS diletakkan di VM yang satu subnet dengan node.

'''Bastion''' hanyalah istilah untuk mesin pembantu yang mengurus cluster (tempat <code>oc</code>, DNS, dsb.). DNS ini harus '''tetap hidup selama cluster hidup''', bukan hanya saat install, karena node memakai nama <code>api-int</code> untuk komunikasi internal.

== Kebutuhan resource ==
{| class="wikitable"
! VM !! vCPU !! RAM !! Disk
|-
| OKD SNO || 16 || 32 GB || 150 GB
|-
| Bastion (AlmaLinux minimal) || 1–2 || 1–2 GB || 10–20 GB
|}

Catatan:
* Spesifikasi minimal SNO di dokumentasi sekitar 8 vCPU / 16 GB, tapi 32 GB lebih nyaman.
* Di Proxmox, pemakaian RAM VM OKD terlihat sekitar 27 GiB saat install. Angka itu termasuk page cache dan tanpa guest agent, jadi lebih besar dari pemakaian riil. Cek angka asli dengan <code>oc adm top node</code>.

== Langkah 1: Siapkan binary di mesin kerja ==
Binary diambil dari GitHub Releases proyek OKD: <code>https://github.com/okd-project/okd/releases</code>

* Pilih rilis '''stable''' (tanpa label ''Pre-release'' dan tanpa <code>ec</code> di namanya).
* Download <code>openshift-install-linux-<tag>.tar.gz</code> dan <code>openshift-client-linux-<tag>.tar.gz</code>.

<syntaxhighlight lang="bash">
TAG=<tag-stable>
BASE=https://github.com/okd-project/okd/releases/download/$TAG
curl -LO $BASE/openshift-install-linux-$TAG.tar.gz
curl -LO $BASE/openshift-client-linux-$TAG.tar.gz

tar xzf openshift-install-linux-$TAG.tar.gz openshift-install
tar xzf openshift-client-linux-$TAG.tar.gz oc kubectl
sudo mv openshift-install oc kubectl /usr/local/bin/

openshift-install version
oc version --client
</syntaxhighlight>

'''Penting:''' <code>oc</code> '''wajib''' ada di <code>$PATH</code>, karena <code>openshift-install</code> memanggilnya saat membuat ISO.

Binary <code>openshift-install</code> terkunci ke satu rilis, jadi versi OKD yang terpasang sama dengan versi binary.

Install juga <code>nmstate</code> (menyediakan <code>nmstatectl</code>, dipakai untuk validasi IP statis):
<syntaxhighlight lang="bash">
yay -S nmstate # Arch (AUR)
nmstatectl --version
</syntaxhighlight>

Buat SSH key kalau belum ada:
<syntaxhighlight lang="bash">
ssh-keygen -t ed25519 -N ""
cat ~/.ssh/id_ed25519.pub
</syntaxhighlight>

== Langkah 2: Buat VM bastion (AlmaLinux) ==
AlmaLinux dipilih karena stabil dan support-nya panjang. Fedora kurang cocok untuk server yang hidup lama (siklus rilis cepat); CentOS Stream lebih sering berubah.

Setelan VM di Proxmox:
* Bridge '''<code>vmbr3</code>''', NIC VirtIO.
* '''CPU type <code>host</code>''' (lihat bagian Troubleshooting: kernel panic).
* RAM minimal 2 GB saat instalasi.
* Options → '''Start at boot''' aktif.

=== Kunci IP statis ===
<syntaxhighlight lang="bash">
nmcli -t -f NAME,DEVICE con show
sudo nmcli con mod ens18 ipv4.method manual \
ipv4.addresses 192.168.90.29/24 ipv4.gateway 192.168.90.1 \
ipv4.dns "192.168.90.29"
sudo nmcli con up ens18
sudo hostnamectl set-hostname marshall-okd-bastion
</syntaxhighlight>

DNS bastion diarahkan ke '''dnsmasq miliknya sendiri''' (<code>192.168.90.29</code>), bukan ke DNS publik. Kalau tidak, bastion tidak bisa resolve <code>api.okd.lab.local</code> dan <code>wait-for</code> tidak bisa memantau install.

Pastikan IP bastion dan IP node berada '''di luar pool DHCP''' MikroTik. Cek tanpa mengubah apa pun:
<pre>
/ip pool print
/ip dhcp-server lease print
</pre>

Cek IP node masih kosong:
<syntaxhighlight lang="bash">
ping -c2 192.168.90.30 # harus gagal
ip neigh | grep 192.168.90.30 # kosong atau FAILED
</syntaxhighlight>

== Langkah 3: DNS dengan dnsmasq ==
OKD membutuhkan tiga record:

{| class="wikitable"
! Record !! Fungsi
|-
| <code>api.okd.lab.local</code> || API cluster (port 6443), dipakai <code>oc</code> dan installer
|-
| <code>api-int.okd.lab.local</code> || API internal, dipakai node dan komponen cluster
|-
| <code>*.apps.okd.lab.local</code> || Ingress: web console, OAuth, dan semua aplikasi
|}

Di SNO, ketiganya mengarah ke IP node.

<syntaxhighlight lang="bash">
sudo dnf install -y dnsmasq bind-utils
sudo tee /etc/dnsmasq.d/okd.conf <<'EOF'
listen-address=192.168.90.29
bind-interfaces
server=1.1.1.1
server=8.8.8.8
address=/api.okd.lab.local/192.168.90.30
address=/api-int.okd.lab.local/192.168.90.30
address=/apps.okd.lab.local/192.168.90.30
EOF
</syntaxhighlight>

Penjelasan:
* <code>server=</code> adalah DNS upstream untuk nama di luar cluster (quay.io, dll.). dnsmasq hanya menjadi klien ke server itu, tidak mengubah konfigurasi router.
* <code>address=/apps.okd.lab.local/...</code> otomatis mencakup semua subdomain (wildcard).
* <code>listen-address</code> + <code>bind-interfaces</code> membuat dnsmasq hanya mendengarkan di IP tersebut, sehingga tidak bentrok dengan resolver lain.

Pastikan folder <code>.d</code> terbaca:
<syntaxhighlight lang="bash">
grep -n conf-dir /etc/dnsmasq.conf
# kalau tidak ada / masih dikomentari:
echo 'conf-dir=/etc/dnsmasq.d/,*.conf' | sudo tee -a /etc/dnsmasq.conf
</syntaxhighlight>

Jalankan dan uji:
<syntaxhighlight lang="bash">
sudo dnsmasq --test
sudo systemctl enable --now dnsmasq
sudo firewall-cmd --add-service=dns --permanent && sudo firewall-cmd --reload
sudo ss -lntup | grep ':53'
dig +short api.okd.lab.local @192.168.90.29 # → 192.168.90.30
dig +short quay.io @192.168.90.29 # harus ada jawaban
getent hosts api.okd.lab.local # dari bastion sendiri
</syntaxhighlight>

== Langkah 4: install-config.yaml ==
<syntaxhighlight lang="yaml">
apiVersion: v1
baseDomain: lab.local
metadata:
name: okd
compute:
- name: worker
replicas: 0
controlPlane:
name: master
replicas: 1
networking:
networkType: OVNKubernetes
machineNetwork:
- cidr: 192.168.90.0/24
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
serviceNetwork:
- 172.30.0.0/16
platform:
none: {}
pullSecret: '{"auths":{"fake":{"auth":"aWQ6cGFzcwo="}}}'
sshKey: 'ssh-ed25519 AAAA... (isi ~/.ssh/id_ed25519.pub)'
</syntaxhighlight>

Catatan:
* <code>platform: none</code> dipakai karena Proxmox tidak punya integrasi native.
* '''Pull secret dummy''' (<code>id:pass</code> dalam base64) cukup untuk OKD, karena image diambil dari <code>quay.io/okd</code> yang publik. Pull secret asli Red Hat hanya perlu untuk OpenShift atau image dari <code>registry.redhat.io</code>.

== Langkah 5: agent-config.yaml ==
<syntaxhighlight lang="yaml">
apiVersion: v1alpha1
kind: AgentConfig
metadata:
name: okd
rendezvousIP: 192.168.90.30
hosts:
- hostname: okd-sno
role: master
interfaces:
- name: eth0
macAddress: BC:24:11:00:00:30
networkConfig:
interfaces:
- name: eth0
type: ethernet
state: up
mac-address: BC:24:11:00:00:30
ipv4:
enabled: true
dhcp: false
address:
- ip: 192.168.90.30
prefix-length: 24
dns-resolver:
config:
server:
- 192.168.90.29
routes:
config:
- destination: 0.0.0.0/0
next-hop-address: 192.168.90.1
next-hop-interface: eth0
table-id: 254
</syntaxhighlight>

Catatan:
* '''MAC address ditentukan sendiri''', lalu dipasang manual di NIC VM. Installer mencocokkan IP statis ke VM berdasarkan MAC.
* Aturan MAC: oktet pertama harus genap di digit keduanya (unicast). Prefix <code>BC:24:11</code> adalah prefix Proxmox.
* Nama interface <code>eth0</code> hanya label; pencocokan dilakukan lewat MAC.

== Langkah 6: Generate ISO ==
ISO '''tidak didownload''', melainkan dibuat oleh <code>openshift-install</code> dari dua YAML di atas. File YAML akan '''dikonsumsi''' (dihapus) saat generate, jadi simpan backup.

<syntaxhighlight lang="bash">
cd ~/okd
mkdir -p ~/okd-backup && cp install-config.yaml agent-config.yaml ~/okd-backup/
rm -rf cluster && mkdir cluster
cp install-config.yaml agent-config.yaml cluster/
openshift-install agent create image --dir cluster --log-level=info
</syntaxhighlight>

Hasil: <code>cluster/agent.x86_64.iso</code>, plus <code>cluster/auth/</code> (kubeconfig dan password kubeadmin).

* Tidak ada progress bar saat <code>Downloading base ISO</code>; tunggu sampai prompt kembali.
* Warning <code>Failed to extract base ISO from release payload</code> tidak fatal; installer jatuh ke jalur download.
* '''Setiap perubahan IP/DNS/MAC wajib generate ulang ISO''', karena konfigurasi ter-bake di dalamnya.

Salin folder <code>cluster/</code> ke bastion supaya <code>wait-for</code> dan <code>oc</code> bisa dijalankan dari sana.

== Langkah 7: Buat VM OKD di Proxmox ==
Upload ISO lewat UI Proxmox (storage → ISO Images → Upload), lalu Create VM:

{| class="wikitable"
! Tab !! Setelan !! Alasan
|-
| General || Start at boot || Cluster ikut hidup saat host reboot
|-
| OS || ISO <code>agent.x86_64.iso</code> ||
|-
| System || Machine <code>q35</code>, BIOS SeaBIOS || q35 chipset modern (opsional, i440fx juga bisa). Kalau OVMF, matikan Secure Boot
|-
| Disks || VirtIO SCSI single, 150 GB, SSD, '''Discard''' + '''SSD emulation''' || Discard (TRIM) mengembalikan ruang thin-provisioned ke host; opsional
|-
| CPU || 1 socket, 16 core, type '''<code>host</code>''' || '''Wajib.''' SCOS butuh instruksi CPU modern; tipe default bisa memicu crash
|-
| Memory || 32768 MB, '''Ballooning off''' || '''Penting.''' Kubernetes mengasumsikan RAM tetap; balloon bisa memicu OOM/eviction
|-
| Network || Bridge <code>vmbr3</code>, VirtIO, MAC '''<code>BC:24:11:00:00:30</code>''' || Harus sama persis dengan agent-config.yaml
|-
| Options → Boot Order || <code>scsi0</code> di atas CD-ROM || Setelah install, node boot dari disk, bukan installer lagi
|}

== Langkah 8: Install dan pantau ==
Start VM. Di Console Proxmox, tanda awal yang benar:
<pre>
ens18: 192.168.90.30
Ignition: user-provided config was applied
This host (192.168.90.30) is the rendezvous host.
</pre>

Urutan yang terlihat:
# <code>Waiting for services</code> → service installer naik satu per satu.
# <code>Installation cannot proceed: Cluster status: insufficient</code> → sementara, validasi host belum selesai.
# <code>Cluster installation in progress</code>.
# <code>Writing image to disk</code> 0–100%, lalu node reboot dari disk.
# Log <code>crio-... libcrun container</code> berulang → container cluster dinyalakan (normal).
# <code>Finished bootkube.service</code> → bootstrap selesai.

Pantau dari bastion:
<syntaxhighlight lang="bash">
cd ~/okd
openshift-install agent wait-for bootstrap-complete --dir cluster --log-level=info
openshift-install agent wait-for install-complete --dir cluster --log-level=info
</syntaxhighlight>

* Pesan <code>cluster bootstrap did not complete</code> tepat setelah ''Writing image to disk: 100%'' bisa muncul karena <code>wait-for</code> kehilangan kontak saat node reboot dari ISO ke disk. Jalankan ulang <code>wait-for</code> (aman, tidak mengganggu installer).
* Install aktual memakan sekitar '''1 jam''' (cluster <code>Available</code> sekitar 09:15 dari mulai 08:11).

Cek status langsung:
<syntaxhighlight lang="bash">
export KUBECONFIG=~/okd/cluster/auth/kubeconfig
curl -k https://api.okd.lab.local:6443/version
oc get clusterversion
oc get co
</syntaxhighlight>

Install sukses bila <code>clusterversion</code> <code>Available=True</code> dan semua cluster operator <code>Available=True, Progressing=False, Degraded=False</code>.

== Langkah 9: Akses web console ==
Password:
<syntaxhighlight lang="bash">
cat ~/okd/cluster/auth/kubeadmin-password
</syntaxhighlight>

Console tidak bisa dibuka lewat <code>IP:port</code>, karena router OKD memilih tujuan berdasarkan '''nama host'''. Di mesin yang menjalankan browser, tambahkan ke <code>/etc/hosts</code>:
<pre>
192.168.90.30 api.okd.lab.local console-openshift-console.apps.okd.lab.local oauth-openshift.apps.okd.lab.local
</pre>

Buka <code>https://console-openshift-console.apps.okd.lab.local</code>, login sebagai <code>kubeadmin</code>. Peringatan sertifikat (self-signed) normal.

Mesin itu juga harus bisa menjangkau <code>192.168.90.0/24</code> (misalnya lewat route WireGuard atau <code>sshuttle</code> via bastion).

Tes router tanpa browser:
<syntaxhighlight lang="bash">
curl -kI --resolve console-openshift-console.apps.okd.lab.local:443:192.168.90.30 \
https://console-openshift-console.apps.okd.lab.local
</syntaxhighlight>

== Langkah 10: Setelah install ==
* '''Snapshot VM OKD''' selagi bersih.
* '''Lepas ISO''' dari VM OKD (CD/DVD → Do not use any media).
* '''Autostart dan urutan boot''': bastion order 1, OKD order 2, beri jeda start.
* '''Simpan <code>cluster/auth/</code>''' di tempat aman.
* '''Storage class''': cluster baru di <code>platform: none</code> belum punya storage dinamis; PVC akan Pending sampai dipasang NFS / local-path / LVMS. Cek dengan <code>oc get sc</code>.
* '''Image registry''' (dev): <syntaxhighlight lang="bash">
oc patch configs.imageregistry.operator.openshift.io cluster --type merge \
--patch '{"spec":{"managementState":"Managed","storage":{"emptyDir":{}}}}'
</syntaxhighlight> (emptyDir: isi hilang saat pod restart, hanya untuk dev.)
* '''Keamanan''': jangan publikasikan console, OAuth, dan API ke internet selama masih memakai <code>kubeadmin</code>. Ganti dengan user admin biasa lewat OAuth.

== Publish aplikasi dengan domain sendiri (rencana) ==
Alur: <code>Internet → MikroTik NAT → nginx → router OKD (192.168.90.30:80) → app</code>

Route dengan domain sendiri:
<syntaxhighlight lang="bash">
oc create route edge myapp --service=myapp \
--hostname=app.domainku.com --insecure-policy=Allow
</syntaxhighlight>

nginx (TLS di nginx, teruskan header Host):
<syntaxhighlight lang="nginx">
location / {
proxy_pass http://192.168.90.30:80;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
</syntaxhighlight>

Tes sisi OKD: <code>curl -sI -H "Host: app.domainku.com" http://192.168.90.30</code>

== Troubleshooting (yang benar-benar terjadi) ==
{| class="wikitable"
! Gejala !! Penyebab !! Solusi
|-
| dnsmasq <code>start-limit-hit</code>, log: <code>failed to create listening socket for port 53: Address already in use</code> || Config di <code>/etc/dnsmasq.d/</code> tidak terbaca (Arch tidak mengaktifkan <code>conf-dir</code>), dnsmasq bind ke semua alamat dan bentrok dengan dnsmasq libvirt di <code>virbr0</code> || Tambahkan <code>conf-dir=/etc/dnsmasq.d/,*.conf</code>; gunakan <code>listen-address</code> + <code>bind-interfaces</code>
|-
| <code>exec: "nmstatectl": executable file not found in $PATH</code> || Paket nmstate belum terpasang || <code>yay -S nmstate</code>, atau jalankan installer di container Fedora
|-
| <code>exec: "oc": executable file not found in $PATH</code> || <code>oc</code> belum diekstrak/di-PATH || Ekstrak <code>openshift-client</code>, pindahkan ke <code>/usr/local/bin</code>
|-
| Node tidak bisa menjangkau DNS di laptop || Laptop (192.168.83.x, WiFi) tidak bisa dijangkau dari jaringan Proxmox (laptop masuk via WireGuard) || Pindahkan DNS ke VM bastion di <code>vmbr3</code>
|-
| Kernel panic AlmaLinux: <code>Attempted to kill init! exitcode=0x00007f00</code> || CPU type default Proxmox menyembunyikan instruksi x86-64-v2/v3 yang dibutuhkan Alma 9/10 || Ubah Processor → Type <code>host</code>
|-
| <code>wait-for</code> stuck lama di <code>Waiting for cluster install to initialize. Sleeping for 30 seconds</code> || Bastion tidak bisa resolve <code>api.okd.lab.local</code> (DNS bastion ke 1.1.1.1). Cluster sebenarnya sudah jadi || Arahkan DNS bastion ke dnsmasq-nya (<code>192.168.90.29</code>) atau tambah <code>/etc/hosts</code>. Cek dengan <code>getent hosts api.okd.lab.local</code>
|-
| Console tidak terbuka di laptop || Nama <code>*.apps</code> tidak dikenal, atau subnet 192.168.90.x tidak terjangkau || Tambah <code>/etc/hosts</code>, pastikan route ke 192.168.90.0/24
|}

Perintah debug yang berguna:
<syntaxhighlight lang="bash">
ssh core@192.168.90.30
sudo journalctl -b -f
sudo crictl ps
tail -n 60 ~/okd/cluster/.openshift_install.log
openshift-install agent wait-for bootstrap-complete --dir cluster --log-level=debug
</syntaxhighlight>

== Referensi ==
* [https://docs.okd.io/latest/installing/overview/ OKD installation overview]
* [https://docs.okd.io/4.21/installing/installing_sno/install-sno-preparing-to-install-sno.html Preparing to install OKD on a single node]
* [https://docs.okd.io/4.22/installing/installing_two_node_cluster/about-two-node-arbiter-installation.html OKD two control plane + arbiter]
* [https://okd.io/blog/2025/05/14/okd-4.19-and-4.20-release OKD 4.19 / 4.20 release (transisi ke SCOS)]
* [https://github.com/okd-project/okd/releases OKD releases (GitHub)]

Cara install OKD - Revision history