Memulai dengan Fedora CoreOS

Pendahuluan

Stream

Ada tiga stream pembaruan Fedora CoreOS (FCOS) yang tersedia: stable, testing, dan next. Secara umum, Anda sebaiknya menggunakan stable, tetapi disarankan untuk menjalankan beberapa mesin pada testing dan next juga dan memberikan umpan balik.

Setiap stream memiliki URL kanonik yang mewakili statusnya saat ini dalam format JSON, yang dikenal sebagai "metadata stream". Sebagai contoh, URL metadata stream untuk stable adalah: https://builds.coreos.fedoraproject.org/streams/stable.json

Untuk mengotomatisasi instalasi Fedora CoreOS, Anda diharapkan berinteraksi dengan metadata streaming. Meskipun Fedora CoreOS melakukan pembaruan otomatis di tempat, secara umum disarankan untuk memulai penyediaan mesin baru dari citra terbaru.

Untuk informasi lebih lanjut tentang penggunaan metadata aliran, lihat Stream Metadata. Untuk informasi lebih lanjut mengenai aliran yang tersedia, lihat Pembaruan Aliran.

Filosofi Penyediaan

Fedora CoreOS tidak memiliki disk instalasi yang terpisah. Sebaliknya, setiap instalasinya dimulai dari image disk generik yang dikustomisasi pada boot pertama melalui Ignition.

Setiap platform memiliki logika khusus untuk mengambil dan menerapkan konfigurasi boot pertama. Untuk penerapan cloud, Ignition mengumpulkan konfigurasi melalui mekanisme data pengguna. Dalam kasus bare metal, Ignition dapat mengambil konfigurasinya dari disk atau dari sumber jarak jauh.

Untuk informasi lebih lanjut mengenai konfigurasi, lihat dokumentasi untuk Memproduksi Berkas Pengapian.

Mulai cepat

Mem-boot pada VM awan (contoh AWS)

Instance AWS baru dapat langsung dibuat dari citra publik FCOS. Anda dapat menemukan AMI terbaru untuk setiap wilayah di halaman unduhan.

Jika Anda hanya tertarik untuk menjelajahi FCOS tanpa melakukan kustomisasi lebih lanjut, Anda dapat menggunakan pasangan kunci SSH yang terdaftar untuk pengguna default core.

Untuk mencoba FCOS dengan cara ini, Anda perlu menjalankan perintah aws ec2 run-instances dan memberikan beberapa informasi agar instance dapat berjalan. Berikut ini contoh perintah yang dapat digunakan:

Menjalankan Instance Baru
NAME='instance1'
SSHKEY='my-key'     # nama kunci SSH Anda: `aws ec2 describe-key-pairs`
IMAGE='ami-xxx'     # ID AMI yang ditemukan di halaman unduhan
DISK='20'           # ukuran hard disk
REGION='us-east-1'  # wilayah target
TYPE='m5.large'     # tipe instance
SUBNET='subnet-xxx' # subnet: `aws ec2 describe-subnets`
SECURITY_GROUPS='sg-xx' # grup keamanan: `aws ec2 describe-security-groups`
aws ec2 run-instances                     \
    --region $REGION                      \
    --image-id $IMAGE                     \
    --instance-type $TYPE                 \
    --key-name $SSHKEY                    \
    --subnet-id $SUBNET                   \
    --security-group-ids $SECURITY_GROUPS \
    --tag-specifications "ResourceType=instance,Tags=[{Key=Name,Value=${NAME}}]" \
    --block-device-mappings "VirtualName=/dev/xvda,DeviceName=/dev/xvda,Ebs={VolumeSize=${DISK}}"
Anda dapat mengetahui alamat IP yang diberikan untuk instance dengan menjalankan perintah aws ec2 describe-instances.

Sekarang Anda seharusnya dapat melakukan SSH ke dalam instance menggunakan alamat IP yang terkait.

Contoh Koneksi
ssh core@<ip address>

Contoh yang lebih lengkap yang memungkinkan penyesuaian dijelaskan di Menyediakan Fedora CoreOS di Amazon Web Services.

Mem-boot pada hypervisor lokal (contoh libvirt)

  1. Ambil image terbaru yang sesuai untuk platform qemu menggunakan coreos-installer (atau unduh dan verifikasi dari web). Anda dapat menggunakan coreos-installer sebagai kontainer, atau pada Fedora menginstalnya dari repositori.

    STREAM="stable"
# sebagai biner yang diinstal:
coreos-installer download -s $STREAM -p qemu -f qcow2.xz --decompress -C ~/.local/share/libvirt/images/
# atau sebagai kontainer:
podman run --pull=always --rm -v "${HOME}/.local/share/libvirt/images/:/data" -w /data \
    quay.io/coreos/coreos-installer:release download -s $STREAM -p qemu -f qcow2.xz --decompress

  2. Jalankan mesin baru melalui virt-install, menggunakan berkas Ignition dengan kustomisasi Anda.

    IGNITION_CONFIG="/path/to/example.ign"
IMAGE="/path/to/image.qcow2"
VM_NAME="fcos-test-01"
VCPUS="2"
RAM_MB="2048"
STREAM="stable"
DISK_GB="10"
# Untuk x86 / aarch64,
IGNITION_DEVICE_ARG=(--qemu-commandline="-fw_cfg name=opt/com.coreos/config,file=${IGNITION_CONFIG}")

# Untuk s390x / ppc64le,
IGNITION_DEVICE_ARG=(--disk path="${IGNITION_CONFIG}",format=raw,readonly=on,serial=ignition,startup_policy=optional)

# Atur label SELinux yang benar untuk mengizinkan akses ke konfigurasi
chcon --verbose --type svirt_home_t ${IGNITION_CONFIG}

virt-install --connect="qemu:///system" --name="${VM_NAME}" --vcpus="${VCPUS}" --memory="${RAM_MB}" \
        --os-variant="fedora-coreos-$STREAM" --import --graphics=none \
        --disk="size=${DISK_GB},backing_store=${IMAGE}" \
        --network bridge=virbr0 "${IGNITION_DEVICE_ARG[@]}"
virt-install memerlukan baik image OS maupun berkas Ignition ditentukan menggunakan jalur absolut.
Bergantung pada versi virt-install Anda, Anda mungkin tidak dapat menggunakan --os-variant=fedora-coreos-* dan akan mendapatkan galat. Dalam kasus ini, Anda harus memilih varian Fedora yang lebih lama (misalnya --os-variant=fedora31). Anda dapat menemukan varian yang didukung oleh versi virt-install Anda dengan menjalankan osinfo-query os | grep '^\s*fedora'.
DISK_GB harus minimal sebesar ukuran bawaan image. Untuk Fedora CoreOS, saat ini ukurannya adalah 10 GB.
Pastikan pengguna Anda memiliki akses ke /dev/kvm. Secara bawaan akses ini diizinkan untuk semua orang, tetapi pada beberapa distribusi Anda mungkin perlu menambahkan diri Anda ke grup kvm.
Anda dapat keluar dari konsol serial dengan menekan CTRL + ].

Jika Anda menyiapkan kunci SSH untuk pengguna core default, Anda dapat melakukan SSH ke dalam VM dan menjelajahi OS:

ssh core@<ip address>

Menjelajahi OS

Setelah VM selesai melakukan booting, alamat IP-nya akan muncul di konsol. Secara desain, tidak ada kredensial default yang dikodekan.

Jika Anda menyiapkan kunci SSH untuk pengguna core default, Anda dapat melakukan SSH ke dalam VM dan menjelajahi OS:

ssh core@<ip address>

Menghubungi

Kami menyarankan agar semua pengguna berlangganan ke milis coreos-status yang bervolume rendah untuk mendapatkan pemberitahuan operasional yang terkait dengan Fedora CoreOS.

Bug dapat dilaporkan ke Fedora CoreOS Tracker.

Untuk pertanyaan langsung, jangan ragu untuk menghubungi #coreos:fedoraproject.org di Matrix.

Untuk pertanyaan dan diskusi lebih lanjut terkait Fedora CoreOS, tersedia forum dan milis.

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