Menginstal CoreOS pada Server Fisik

Panduan ini memberikan petunjuk untuk menginstal Fedora CoreOS pada perangkat keras mentah. Terdapat tiga opsi yang tersedia:

Menginstal dari ISO langsung
Instalasi melalui PXE
Menginstal dari kontainer

Persyaratan

Sebelum menginstal FCOS, Anda harus memiliki file konfigurasi Ignition dan menempatkannya di suatu tempat (misalnya menggunakan python3 -m http.server). Jika Anda tidak memiliki file tersebut, lihat Membuat Berkas Ignition.

Jika Anda memiliki server dengan jenis dan/atau jumlah hard drive yang berbeda, Anda harus membuat konfigurasi Ignition yang disesuaikan secara terpisah untuk setiap mesin (atau kelas mesin). Model yang baik adalah memisahkan bagian-bagian umum dari konfigurasi ke dalam konfigurasi Ignition terpisah yang dapat digabungkan (melalui HTTP atau inline) ke dalam konfigurasi khusus per mesin.

Menginstal dari ISO langsung

Untuk menginstal FCOS pada perangkat keras mentah menggunakan ISO langsung secara interaktif, ikuti langkah-langkah berikut:

Unduh citra ISO terbaru dari halaman unduhan atau menggunakan podman (lihat dokumentasi untuk opsi):

podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
    quay.io/coreos/coreos-installer:release download -s stable -p metal -f iso

Perhatikan bahwa ini hanya menggunakan coreos-installer sebagai alat untuk mengunduh file ISO.

Anda dapat mem-boot ISO live dalam mode BIOS legacy atau UEFI, terlepas dari mode apa yang akan digunakan oleh sistem operasi setelah diinstal.

Bakar ISO ke disk. Pada Linux dan macOS, Anda dapat menggunakan dd. Pada Windows, Anda dapat menggunakan Rufus dalam mode “DD Image”.
Jalankan sistem pada sistem target. Berkas ISO ini mampu menjalankan sistem FCOS yang sepenuhnya berfungsi hanya dari memori (yaitu tanpa menggunakan penyimpanan disk). Setelah sistem dijalankan, Anda akan memiliki akses ke prompt perintah bash.
Anda sekarang dapat menjalankan coreos-installer:

sudo coreos-installer install /dev/sda \
    --ignition-url https://example.com/example.ign

Setelah instalasi selesai, Anda dapat me-reboot sistem menggunakan perintah sudo reboot. Setelah reboot, proses booting pertama dimulai. Pada saat inilah Ignition memproses file konfigurasi dan menyiapkan sistem sesuai dengan spesifikasi yang ditentukan.

Untuk instalasi ISO yang lebih canggih, termasuk otomatisasi, lihat di bawah ini. Untuk informasi lebih lanjut tentang citra ISO langsung, lihat referensi citra langsung.

Lihat coreos-installer install --help untuk opsi tambahan tentang cara menginstal Fedora CoreOS.

Menginstal dari jaringan

Mem-boot citra PXE langsung memerlukan setidaknya 2 GiB RAM dengan argumen kernel coreos.live.rootfs_url, dan 4 GiB jika tidak. Anda dapat melakukan instalasi dalam mode boot legacy (BIOS) atau mode UEFI, terlepas dari mode apa yang akan digunakan oleh sistem operasi setelah diinstal.

Instalasi melalui PXE

Untuk menginstal melalui PXE, ikuti langkah-langkah berikut:

Unduh kernel PXE FCOS, initramfs, dan citra rootfs:

podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
    quay.io/coreos/coreos-installer:release download -f pxe

Ikuti contoh berikut pxelinux.cfg untuk mem-boot citra installer menggunakan PXELINUX:

DEFAULT pxeboot
TIMEOUT 20
PROMPT 0
LABEL pxeboot
    KERNEL fedora-coreos-42.20250929.3.0-live-kernel-x86_64
    APPEND initrd=fedora-coreos-42.20250929.3.0-live-initramfs.x86_64.img, fedora-coreos-42.20250929.3.0-live-rootfs.x86_64.img coreos.inst.install_dev=/dev/sda coreos.inst.ignition_url=http://192.168.1.101:8000/config.ign
IPAPPEND 2

Untuk informasi lebih lanjut tentang cara menggunakan informasi ini, lihat posting blog ini blog post untuk menguji instalasi PXE melalui VM lokal dan libvirt. Untuk opsi baris perintah kernel lainnya yang didukung, lihat dokumen coreos-installer, tetapi perhatikan bahwa coreos-installer pxe customize (lihat di bawah) lebih fleksibel. Untuk informasi lebih lanjut tentang citra PXE langsung, lihat referensi citra langsung.

Menginstal dari iPXE

Mesin yang mendukung iPXE perlu dilengkapi dengan skrip boot yang sesuai untuk mengambil dan memuat artefak FCOS.

Contoh di bawah ini menunjukkan cara memuat file-file tersebut langsung dari infrastruktur Fedora. Untuk alasan kinerja dan keandalan, disarankan untuk menyalin file-file tersebut ke infrastruktur lokal, lalu sesuaikan nilai BASEURL sesuai kebutuhan.

#!ipxe

set STREAM stable
set VERSION 42.20250929.3.0
set INSTALLDEV /dev/sda
set CONFIGURL https://example.com/config.ign

set BASEURL https://builds.coreos.fedoraproject.org/prod/streams/${STREAM}/builds/${VERSION}/x86_64

kernel ${BASEURL}/fedora-coreos-${VERSION}-live-kernel.x86_64 initrd=main coreos. live.rootfs_url=${BASEURL}/fedora-coreos-${VERSION}-live-rootfs.x86_64.img coreos.inst.install_dev=${INSTALLDEV} coreos.inst.ignition_url=$\ {CONFIGURL}
initrd --name main ${BASEURL}/fedora-coreos-${VERSION}-live-initramfs.x86_64.img

boot

Untuk opsi baris perintah kernel lainnya yang didukung, lihat coreos-installer docs, tetapi perhatikan bahwa coreos-installer pxe customize (lihat di bawah) lebih fleksibel. Untuk informasi lebih lanjut tentang citra PXE langsung, lihat referensi citra langsung.

Menginstal dari kontainer

Anda dapat menggunakan coreos-installer container dari sistem yang sudah ada untuk menginstal ke perangkat blok yang terhubung. Misalnya (ganti docker dengan podman jika diperlukan):

sudo podman run --pull=always --privileged --rm \
    -v /dev:/dev -v /run/udev:/run/udev -v .:/data -w /data \
    quay.io/coreos/coreos-installer:release \
    install /dev/vdb -i config.ign

Dalam contoh ini, coreos-installer akan mengunduh citra metal FCOS stabil terbaru dan menginstalnya ke /dev/vdb. Kemudian, ia akan menyisipkan file Ignition config.ign yang berada di direktori saat ini ke dalam citra tersebut. Gunakan opsi --help untuk melihat semua opsi yang tersedia.

Mengunduh dan menyalin citra metal

Terkadang, perlu mengunduh citra metal terlebih dahulu dan kemudian meneruskannya secara lokal ke coreos-installer untuk proses instalasi. Anda dapat mengunduh citra metal langsung dari halaman unduhan FCOS di https://fedoraproject.org/coreos/download/?stream=stable#baremetal, atau Anda dapat menggunakan perintah coreos-installer download.

Saat melakukan instalasi melalui ISO langsung atau PXE, tidak perlu mengunduh citra metal. Gambar tersebut sudah termasuk dalam lingkungan tersebut.

Ada dua citra metal: satu untuk disk sektor 512b (berlabel “Raw” di halaman unduhan), dan satu untuk disk sektor 4k asli (berlabel “Raw (4K Native)”). Kecuali Anda tahu bahwa Anda menargetkan disk sektor 4k asli, gunakan yang 512b, yang paling umum digunakan. Lihat halaman ini untuk informasi lebih lanjut.

Untuk mengunduh citra metal asli 4kn dengan perintah coreos-installer download, gunakan opsi --format 4k.raw.xz.

Gambar logam ini menggunakan tata letak partisi hibrida yang mendukung booting baik melalui BIOS maupun UEFI.

Ketika Anda siap untuk menginstal FCOS, Anda dapat mengarahkannya ke citra yang telah diunduh menggunakan perintah coreos-installer install --image-url <LOCAL_MIRROR> atau coreos-install --image-file <PATH>.

Penyesuaian instalasi

Perintah coreos-installer iso customize dan coreos-installer pxe customize dapat digunakan untuk membuat citra ISO dan PXE yang disesuaikan dengan konfigurasi khusus situs, termasuk kemampuan untuk melakukan instalasi tanpa pengawasan Fedora CoreOS.

Saat melakukan booting pada citra yang dibuat dengan coreos-installer pxe customize, baris perintah kernel PXE atau iPXE harus mencakup argumen ignition.firstboot ignition.platform.id=metal. Jika dijalankan dalam mesin virtual, ganti metal dengan ID platform untuk platform Anda, seperti qemu atau vmware.

Misalnya:

# Buat file .iso yang disesuaikan yang:
# - Secara otomatis diinstal ke /dev/sda
# - Menyiapkan sistem yang diinstal dengan config.ign
# - Mengonfigurasi GRUB dan kernel yang diinstal untuk menggunakan konsol grafis utama
#   dan konsol serial sekunder
# - Menggunakan konfigurasi jaringan dari static-ip.nmconnection
# - Mempercayai sertifikat HTTPS yang ditandatangani oleh ca.pem
# - Menjalankan post.sh setelah instalasi
coreos-installer iso customize \
    --dest-device /dev/sda \
    --dest-ignition config.ign \
    --dest-console ttyS0,115200n8 \
    --dest-console tty0 \
    --network-keyfile static-ip.nmconnection \
    --ignition-ca ca.pem \
    --post-install post.sh \
    -o custom.iso fedora-coreos-42.20250929.3.0-live.x86_64.iso
# Sama, tetapi buat citra initramfs PXE yang disesuaikan
coreos-installer pxe customize \
    --dest-device /dev/sda \
    --dest-ignition config.ign \
    --dest-console ttyS0,115200n8 \
    --dest-console tty0 \
    --network-keyfile static-ip.nmconnection \
    --ignition-ca ca.pem \
    --post-install post.sh \
    -o custom-initramfs.img fedora-coreos-42.20250929.3.0-live-initramfs.x86_64.img

Untuk detail tentang kustomisasi yang tersedia, lihat dokumentasihttps://coreos.github.io/coreos-installer/customizing-install/#customize-options[coreos-installer].

Pemasangan ISO pada berbagai perangkat keras

Sistem bare metal umumnya memiliki beragam perangkat keras - beberapa sistem mungkin menggunakan drive NVMe /dev/nvme*, sedangkan yang lain menggunakan /dev/sd*, misalnya. Anda hampir pasti harus menyesuaikan nilai /dev/sda di atas.

Pendekatan yang berguna adalah membuat skrip untuk menghasilkan file .iso per mesin. Jika Anda memiliki basis data perangkat keras (baik berupa file teks di Git atau basis data relasional), Anda dapat menghasilkan file target-dell.ign dan target-hp.ign per mesin, misalnya, dan menentukan file tersebut ke opsi --dest-ignition bersama dengan opsi --dest-device yang sesuai untuk menghasilkan file fedora-coreos-install-dell.iso dan fedora-coreos-install-hp.iso.

Sebagai alternatif, daripada menghasilkan ISO per mesin, Anda dapat menjalankan skrip --pre-install yang menjalankan kontainer berprivilese untuk memeriksa sistem target dan menulis konfigurasi installer yang sesuai (installer config) ke /etc/coreos/installer.d.

Pemasangan pada iSCSI

Untuk menginstal CoreOS pada perangkat boot iSCSI, ikuti langkah-langkah yang sama seperti yang dijelaskan di atas untuk mendapatkan lingkungan live, dan tambahkan argumen kernel yang terkait dengan iSCSI.

Pasang target iSCSI dari lingkungan live:

sudo iscsiadm -m discovery -t st -p 10.0.0.1
sudo iscsiadm -m node -T iqn.2023-10.coreos.target.vm:coreos -l

Tambahkan argumen yang diperlukan saat menjalankan coreos-installer:

Menginstal ke target iSCSI dengan iBFT

Pada mesin yang sepenuhnya tanpa disk, nilai target dan inisiator iSCSI dapat diteruskan melalui iBFT. Nilai-nilai ini dapat disediakan melalui skrip boot iPXE, misalnya:

---
#!ipxe
set initiator-iqn iqn.2023-11.coreos.diskless:testsetup
sanboot iscsi:10.0.0.1::::iqn.2023-10.coreos.target.vm:coreos
---

---
sudo coreos-installer install \
    /dev/disk/by-path/ip-10.0.0.1\:3260-iscsi-iqn.2023-10.coreos.target.vm\:coreos-lun-0 \
    --append-karg rd.iscsi.firmware=1 --append-karg ip=ibft \
    --console ttyS0 \
    --ignition-url https://example.com/example.ign
---

Menginstal ke target iSCSI dengan konfigurasi manual

---
sudo coreos-installer install \
    /dev/disk/by-path/ip-10.0.0.1\:3260-iscsi-iqn.2023-10.coreos.target.vm\:coreos-lun-0 \
    --append-karg rd.iscsi.initiator=iqn.2024-02.com.yourorg.name:lun0 \
    --append-karg netroot=iscsi:iqn.2023-10.coreos.target.vm:coreos` \
    --console ttyS0 \
    --ignition-url https://example.com/example.ign
---

Semua ini juga dapat diatur menggunakan coreos-installer iso customize atau coreos-installer pxe customize. (Lihat bagian “Menyesuaikan instalasi” di atas).

Misalnya menggunakan iBFT:

# Buat file .iso yang disesuaikan yang:
# - Secara otomatis menghubungkan target iSCSI menggunakan mount-iscsi.sh
# - Menyiapkan sistem yang diinstal dengan config.ign
# - Mengonfigurasi sistem yang diinstal untuk menggunakan iBFT
coreos-installer iso customize \
    --pre-install mount-iscsi.sh \
    --dest-device /dev/disk/by-path/ip-10.0.0.1\:3260-iscsi-iqn.2023-10.coreos.target.vm\:coreos-lun-0 \
    --dest-ignition config.ign \
    --dest-karg-append rd.iscsi.firmware=1 \
    --dest-karg-append ip=ibft \
-o custom.iso fedora-coreos-42.20250929.3.0-live.x86_64.iso

Bendera --pre-install digunakan untuk menjalankan skrip dengan perintah iscsiadm, --dest-device menargetkan disk yang telah dipasang, dan kemudian --dest-karg-append menambahkan kargs yang diperlukan.

Menginstal ulang Fedora CoreOS

Anda dapat menggunakan salah satu metode yang dijelaskan di atas untuk menginstal ulang Fedora CoreOS pada mesin yang sama melalui lingkungan live.

Persisten data

Pemasang tidak sepenuhnya menghapus disk target. Berkat fitur “https://coreos.github.io/ignition/operator-notes#filesystem-reuse-semantics” (semantik penggunaan ulang sistem file) dari Ignition, jika Anda menerapkan konfigurasi dengan pengaturan partisi dan sistem file yang sama persis seperti pada instalasi pertama, semua data yang disimpan sebelumnya di partisi tambahan tetap tersedia. Hal ini dapat berguna untuk mempertahankan, misalnya, /var/lib/containers atau /var/home antara instalasi ulang. Namun, ada beberapa batasan. Lihat bagian Menggunakan keadaan persisten untuk informasi lebih lanjut. Anda juga perlu memastikan sistem file akar memiliki ukuran tetap minimal 8 GiB seperti yang dijelaskan dalam Konfigurasi Penyimpanan agar partisi data tidak terhapus secara tidak sengaja.

Drive tujuan

Fedora CoreOS mensyaratkan bahwa hanya ada satu sistem file yang diberi label boot. Jika ditemukan lebih dari satu sistem file semacam itu pada booting pertama, proses provisioning akan gagal sebagai langkah pengamanan. Jika menginstal ulang Fedora CoreOS pada disk yang berbeda dari instalasi sebelumnya, pastikan untuk menghapus disk sebelumnya menggunakan perintah seperti wipefs. Misalnya, jika menginstal ulang ke /dev/sdb, tetapi /dev/sda masih berisi instalasi sebelumnya dari FCOS, gunakan perintah wipefs -a /dev/sda di lingkungan instalasi.

Want to help? Learn how to contribute to Fedora Docs ›