Provisioning Fedora CoreOS on libvirt

This guide shows how to provision new Fedora CoreOS (FCOS) instances on a libvirt platform, using the QEMU hypervisor.

Pre-requisitos

Antes de aprovisionar una máquina FCOS, usted debe tener un archivo de configuración Ignition que contenga sus personalizaciones. Si no tiene uno vea Produciendo un Archivo Ignition.

Fedora CoreOS tiene un usuario core predeterminado que puede ser usado para explorar el SO. Si usted desea utilizarlo finalice su configuración proporcionando una clave SSH.

You also need to have access to a host machine with libvirt. The examples below use the virt-install command-line tool, which must be separately installed beforehand.

If running on a host with SELinux enabled (use the sestatus command to check SELinux status), make sure your OS image and Ignition file are labeled as svirt_home_t. You can do this by placing them under ~/.local/share/libvirt/images/ or running chcon -t svirt_home_t /path/to/file.

Lanzar una instancia de Máquina Virtual

  1. Obtenga la última imagen adecuada para la plataforma qemu utilizando coreos-installer (o descargue y verifique esto desde la web). Puede utilizar coreos-installer como un contenedor, o en instalación de Fedora desde los repos.

    STREAM="stable"
# como un binario instalado:
coreos-installer download -s $STREAM -p qemu -f qcow2.xz --decompress -C ~/.local/share/libvirt/images/
# o como un contenedor:
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. Lanza una máquina nueva por medio de virt-install, utilizando el archivo Ignition con sus personalizaciones.

    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"
# Para x86 / aarch64,
IGNITION_DEVICE_ARG=(--qemu-commandline="-fw_cfg name=opt/com.coreos/config,file=${IGNITION_CONFIG}")

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

# Configure la etiqueta correcta de SELinux para permitir acceder a la config
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 requiere ambos imagen de SO y archivo Ignition a ser especificado como rutas absolutas.
Depender en su versión de virt-install, tal vez no es capaz de utilizar --os-variant=fedora-coreos-* y obtendrá un error. En este caso, tomaría una variante Fedora más antigua (--os-variant=fedora31 por ejemplo). Puede encontrar las variantes que están admitidas por usted en la versión actual de virt-install con osinfo-query os | grep '^\s*fedora'.
DISK_GB sería al menos tan grande como el tamaño por defecto de la imagen. Para Fedora CoreOS, esto actualmente es de 10 GB.
Asegúrese que su usuario ha accedido a /dev/kvm. El predeterminado es permitirlo acceder para cada uno, pero en algunas ditribuciones puede necesitar añadirse al grupo kvm.
Puede escapar fuera de la consola serial presionando CTRL + ].

Si ha establecido una clave SSH para el usuario core predeterminado, puede hacer SSH en la MV y explorar el SO:

ssh core@<dirección ip>

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