Referensi citra Live ISO dan PXE

Untuk pengantar tentang menjalankan Fedora CoreOS langsung dari RAM, lihat [panduan provisioning](xref:live-booting.adoc).

Mengirimkan rootfs PXE ke mesin

Citra PXE Fedora CoreOS terdiri dari tiga komponen: kernel, initramfs, dan rootfs. Ketiganya wajib ada, dan lingkungan PXE live tidak akan melakukan boot tanpa ketiganya.

Ada beberapa cara untuk mengirimkan rootfs ke mesin:

  • Tentukan hanya file initramfs sebagai initrd di konfigurasi PXE Anda, dan kirimkan URL HTTP(S) atau TFTP untuk rootfs menggunakan argumen kernel coreos.live.rootfs_url=. Metode ini memerlukan 2 GiB RAM dan merupakan opsi yang direkomendasikan kecuali Anda memiliki kebutuhan khusus.

  • Tentukan kedua file initramfs dan rootfs sebagai initrd di konfigurasi PXE Anda. Ini dapat dilakukan melalui beberapa direktif initrd, atau dengan menambahkan parameter initrd= tambahan di argumen kernel. Metode ini lebih lambat dibandingkan metode pertama dan memerlukan 4 GiB RAM.

  • Gabungkan file initramfs dan rootfs menjadi satu, lalu tentukan file gabungan tersebut sebagai initrd. Metode ini juga lebih lambat dan memerlukan 4 GiB RAM.

Mengirimkan konfigurasi Ignition ke sistem PXE live

Saat melakukan boot Fedora CoreOS melalui PXE live, baris perintah kernel harus menyertakan argumen ignition.firstboot ignition.platform.id=metal untuk menjalankan Ignition. Jika dijalankan di mesin virtual, ganti metal dengan [ID platform](https://coreos.github.io/ignition/supported-platforms/) yang sesuai dengan platform Anda, seperti qemu atau vmware.

Ada beberapa cara untuk mengirimkan konfigurasi Ignition saat melakukan boot Fedora CoreOS melalui PXE:

  • Tambahkan ignition.config.url=<config-url> ke baris perintah kernel. Skema URL yang didukung meliputi http, https, tftp, s3, dan gs.

  • Jika dijalankan secara virtual, kirimkan konfigurasi Ignition melalui hypervisor, sama seperti saat melakukan boot dari citra disk. Pastikan argumen kernel ignition.platform.id disetel ke [ID platform](https://coreos.github.io/ignition/supported-platforms/) yang sesuai dengan platform Anda.

  • Hasilkan versi khusus dari initramfs yang berisi konfigurasi Ignition Anda menggunakan coreos-installer pxe customize. Misalnya, jalankan:

    coreos-installer pxe customize --live-ignition config.ign -o custom-initramfs.img \
    fedora-coreos-43.20251120.3.0-live-initramfs.x86_64.img

  • Jika Anda ingin menjaga konfigurasi Ignition tetap terpisah dari citra initramfs Fedora CoreOS, buat initrd terpisah dengan perintah tingkat rendah coreos-installer pxe ignition wrap, lalu kirimkan sebagai initrd tambahan. Misalnya, jalankan:

    coreos-installer pxe ignition wrap -i config.ign -o ignition.img

    dan kemudian gunakan baris APPEND PXELINUX yang serupa dengan:

    APPEND initrd=fedora-coreos-43.20251120.3.0-live-initramfs.x86_64.img,fedora-coreos-43.20251120.3.0-live-rootfs.x86_64.img,ignition.img ignition.firstboot ignition.platform.id=metal

Mengirimkan konfigurasi jaringan ke sistem live ISO atau PXE

Di Fedora CoreOS, jaringan biasanya dikonfigurasi melalui [berkas kunci NetworkManager](https://developer.gnome.org/NetworkManager/stable/nm-settings-keyfile.html). Jika jaringan Anda memerlukan pengaturan khusus seperti alamat IP statis dan konfigurasi Ignition Anda mengambil sumber daya dari jaringan, Anda tidak dapat menyertakan berkas kunci tersebut langsung dalam konfigurasi Ignition karena hal itu akan menimbulkan ketergantungan sirkular.

Sebagai gantinya, Anda dapat menggunakan coreos-installer iso customize atau coreos-installer pxe customize dengan opsi --network-keyfile untuk membuat citra ISO atau citra initramfs PXE yang disesuaikan agar dapat menerapkan pengaturan jaringan sebelum menjalankan Ignition. Misalnya:

coreos-installer iso customize --network-keyfile custom.nmconnection -o custom.iso \
    fedora-coreos-43.20251120.3.0-live.x86_64.iso

Jika Anda melakukan boot melalui PXE dan ingin menjaga pengaturan jaringan terpisah dari citra initramfs Fedora CoreOS, Anda juga dapat menggunakan perintah tingkat rendah coreos-installer pxe network wrap untuk membuat citra initrd terpisah dan mengirimkannya sebagai initrd tambahan. Misalnya, jalankan:

coreos-installer pxe network wrap -k custom.nmconnection -o network.img

dan kemudian gunakan baris APPEND PXELINUX yang serupa dengan:

APPEND initrd=fedora-coreos-43.20251120.3.0-live-initramfs.x86_64.img,fedora-coreos-43.20251120.3.0-live-rootfs.x86_64.img,network.img ignition.firstboot ignition.platform.id=metal

Mengirimkan argumen kernel ke sistem live ISO

Jika Anda ingin memodifikasi argumen kernel bawaan dari sistem live ISO, Anda dapat menggunakan opsi --live-karg-{append,replace,delete} pada coreos-installer iso customize. Misalnya, jika Anda ingin mengaktifkan simultaneous multithreading (SMT) bahkan pada CPU yang tidak aman, Anda dapat menjalankan perintah berikut:

coreos-installer iso customize --live-karg-delete mitigations=auto,nosmt -o custom.iso \
    fedora-coreos-43.20251120.3.0-live.x86_64.iso

Mengekstrak artefak PXE dari citra ISO live

Jika Anda memerlukan artefak PXE Fedora CoreOS dan sudah memiliki citra ISO, Anda dapat mengekstrak artefak PXE darinya:

podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
    quay.io/coreos/coreos-installer:release iso extract pxe \
    fedora-coreos-43.20251120.3.0-live.x86_64.iso

Perintah ini akan menampilkan jalur ke artefak yang berhasil diekstrak.

Menggunakan citra ISO minimal

Dalam beberapa kasus, Anda mungkin ingin melakukan boot citra ISO Fedora CoreOS pada mesin yang dilengkapi dengan perangkat keras Lights-Out Management (LOM). Anda dapat mengunggah ISO ke pengendali LOM sebagai citra CD virtual, tetapi ukuran ISO mungkin lebih besar dari kapasitas yang didukung oleh pengendali LOM.

Untuk menghindari masalah ini, Anda dapat mengonversi citra ISO menjadi citra ISO minimal yang berukuran lebih kecil tanpa rootfs. Mirip dengan citra PXE, ISO minimal harus mengambil rootfs dari jaringan selama proses boot.

Misalkan Anda berencana untuk menyimpan citra rootfs di https://example.com/fedora-coreos-43.20251120.3.0-live-rootfs.x86_64.img. Perintah berikut akan mengekstrak citra ISO minimal dan file rootfs dari citra ISO asli, serta menambahkan argumen kernel coreos.live.rootfs_url dengan URL yang sesuai:

podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
    quay.io/coreos/coreos-installer:release iso extract minimal-iso \
    --output-rootfs fedora-coreos-43.20251120.3.0-live-rootfs.x86_64.img \
    --rootfs-url https://example.com/fedora-coreos-43.20251120.3.0-live-rootfs.x86_64.img \
    fedora-coreos-43.20251120.3.0-live.x86_64.iso \
    fedora-coreos-43.20251120.3.0-live-minimal.x86_64.iso

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