Requisitos previos para los tutoriales

Los siguientes tutoriales se centran en ayudarte a empezar a usar Fedora CoreOS, aprendiendo a configurar (o aprovisionar) automáticamente una instancia en el primer arranque. Cada tutorial se basa en el anterior, por lo que se recomienda seguirlos secuencialmente.

Si no sabe qué es Fedora CoreOS, puede consultar P+F para obtener más información.

Si necesita ayuda o tiene alguna pregunta mientras sigue estos tutoriales, únase al enlace Sala Matrix o únase a nuestro foro de discusión. Si encuentra alguna incidencia con el tutorial, infórmelo en el seguidor de incidencias de fedora-coreos-docs.

Debes comenzar con las instrucciones de configuración de esta página, ya que deben completarse primero para poder seguir los tutoriales.

Virtualización con libvirt

Estos tutoriales están diseñados para un entorno Linux con una configuración de libvirt funcional y compatibilidad con virtualización de hardware mediante KVM. Sin embargo, no hay información específica sobre el entorno libvirt en esos tutoriales, por lo que puede probar las mismas configuraciones en cualquier plataforma donde tengas acceso a la consola (o puedes pasar directamente al tutorial de acceso SSH para obtener acceso remoto).

Para obtener instrucciones sobre cómo configurar libvirt y KVM, consulte la guía Introducción a la virtualización de Fedora. Aunque esta guía de configuración se centra en Fedora, los tutoriales deberían funcionar en cualquier distribución con libvirt instalado y en ejecución.

Directorio de trabajo local

Para mantener todos los archivos de configuración y las imágenes de Fedora CoreOS en el mismo lugar, crearemos un directorio nuevo para trabajar desde:

mkdir ~/coreos
cd ~/coreos

Clave pública SSH

Alguno de los tutoriales añade una clave pública de SSH para las instancias a conceder para acceso SSH como opuesto para acceso por consola serie. Coloque una clave pública en su directorio actual de trabajo bajo el nombre de archivo ssh-key.pub. Por ejemplo, para una pareja de claves RSA el lugar por defecto estaría en ~/.ssh/id_rsa.pub:

cp ~/.ssh/id_rsa.pub ssh-key.pub

Herramientas de CoreOS

Para los tutoriales, necesitaremos las herramientas siguientes:

  • Butane: para generar la configuración de Ignition desde los archivos de configuración de Butane.

  • coreos-installer: para descargar la última imagen de Fedora CoreOS QCOW2.

  • ignition-validate: para validar los archivos de configuración de Ignition.

Configure con podman o docker

Todas las herramientas requeridas para funcionar con Fedora CoreOS están disponibles desde los contenedores hospedados en quay.io:

podman pull quay.io/coreos/butane:release
podman pull quay.io/coreos/coreos-installer:release
podman pull quay.io/coreos/ignition-validate:release

Para hacerlo más simple a teclear, puede añadir los aliases a continuación a su configuración del intérprete:

alias butane='podman run --rm --interactive         \
              --security-opt label=disable          \
              --volume "${PWD}:/pwd" --workdir /pwd \
              quay.io/coreos/butane:release'

alias coreos-installer='podman run --pull=always              \
                        --rm --interactive                    \
                        --security-opt label=disable          \
                        --volume "${PWD}:/pwd" --workdir /pwd \
                        quay.io/coreos/coreos-installer:release'

alias ignition-validate='podman run --rm --interactive         \
                         --security-opt label=disable          \
                         --volume "${PWD}:/pwd" --workdir /pwd \
                         quay.io/coreos/ignition-validate:release'

Entonces puedes utilizar coreos-installer para descargar la última versión estable con:

coreos-installer download -p qemu -f qcow2.xz --decompress

Para hacer más simple el tutorial, renombraría la imagen que acabamos de descargar a un nombre más breve:

mv fedora-coreos-44.20260621.3.1-qemu.x86_64.qcow2 fedora-coreos.qcow2

Ahora está preparado para proceder con el primer tutorial.

Instalación a través de paquetes de Fedora

Todas las tres herramientas (Butane, coreos-installer, y ignition-validate) están disponibles como paquetes de Fedora:

# Instalar las herramientas
sudo dnf install -y butane coreos-installer ignition-validate

# Descargar las últimas imágenes estables de QCOW2 en Fedora CoreOS
coreos-installer download -p qemu -f qcow2.xz --decompress

Para hacer más simple el tutorial, renombraría la imagen que acabamos de descargar a un nombre más breve:

mv fedora-coreos-44.20260621.3.1-qemu.x86_64.qcow2 fedora-coreos.qcow2

Ahora está preparado para proceder con el primer tutorial.

Descarga manual

Si ninguna de las soluciones anteriores te funciona, aún puede descargar manualmente Fedora CoreOS desde fedoraproject.org con:

RELEASE="44.20260621.3.1"
curl -O https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/${RELEASE}/x86_64/fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz
curl -O https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/${RELEASE}/x86_64/fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz.sig

Una vez descargado el archivo, asegúrese de verificar su integridad siguiendo las instrucciones disponibles al pulsar en el botón Verificar firma y SHA256. Deberá descargar el archivo de suma de comprobación, la firma y las claves GPG de Fedora para verificar la descarga:

curl https://fedoraproject.org/fedora.gpg | gpg --import
gpg --verify fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz.sig

Una vez que haya verificado el archivador, puede extraerlo con:

unxz fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz

Para hacer más simple el tutorial, renombraría la imagen que acabamos de descargar a un nombre más breve:

mv fedora-coreos-44.20260621.3.1-qemu.x86_64.qcow2 fedora-coreos.qcow2

Entonces descargarías los últimos lanzamientos de Butane y ignition-validate desde GitHub:

# Butane
curl -OL https://github.com/coreos/butane/releases/download/v0.29.0/butane-x86_64-unknown-linux-gnu
curl -OL https://github.com/coreos/butane/releases/download/v0.29.0/butane-x86_64-unknown-linux-gnu.asc
gpg --verify butane-x86_64-unknown-linux-gnu.asc
mv butane-x86_64-unknown-linux-gnu butane
chmod a+x butane

# ignition-validate
curl -OL https://github.com/coreos/ignition/releases/download/v2.26.0/ignition-validate-x86_64-linux
curl -OL https://github.com/coreos/ignition/releases/download/v2.26.0/ignition-validate-x86_64-linux.asc
gpg --verify ignition-validate-x86_64-linux.asc
mv ignition-validate-x86_64-linux ignition-validate
chmod a+x ignition-validate

Entonces puede configurar aliases para butane e ignition-validate:

alias butane="${PWD}/butane"
alias ignition-validate="${PWD}/ignition-validate"

O mueve aquellos comandos a una carpeta dentro de su ruta de $PATH, por ejemplo:

mv butane ignition-validate "${HOME}/.local/bin/"
# O
mv butane ignition-validate "${HOME}/bin"

Ahora está preparado para proceder con el primer tutorial.

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