Aprovisionamiento de Fedora CoreOS en Hetzner

Esta guía muestra cómo aprovisionar nodos nuevos de Fedora CoreOS (FCOS) en Hetzner. Fedora CoreOS actualmente no está disponible como opción en la selección de sistemas operativos de Hetzner. Por lo tanto, primero debe descargar la imagen de disco de Fedora CoreOS para Hetzner, luego crear una instantánea de ella en su cuenta de Hetzner usando la herramienta hcloud-upload-image y, finalmente, crear sus servidores a partir de esta instantánea.

El soporte para Fedora CoreOS en Hetzner se considera emergente, ya que aún no ofrece una experiencia de usuario optimizada y depende de herramientas que no son oficialmente compatibles con Hetzner. Consulte issue #1324 para obtener más detalles.
La herramienta hcloud-upload-image no es un producto oficial de Hetzner Cloud y no ofrece soporte para ella. Como alternativa, también puede usar la herramienta oficial packer-plugin-hcloud para instalar la imagen mediante coreos-installer.
Para crear una instantánea, la herramienta hcloud-upload-image aprovisionará un servidor pequeño y lo iniciará en modo de rescate. Dado que este servidor tiene una vida útil corta, el coste debería ser muy bajo. Las instantáneas resultantes se cobran por GB al mes. Consulte Respaldos/Capturas en la documentación de Hetzner Cloud. Puede eliminar esta instantánea una vez que el servidor se haya aprovisionado.

Prerrequisitos

Antes de proporcionar una máquina FCOS, debes tener un archivo de configuración Ignition que contenga sus personalizaciones. Si no tiene uno, consulte Produciendo un Archivo Ignition.

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

Si no desea utilizar Ignition para comenzar, puede utilizar asistencia sobre Afterburn y configurar solo claves SSH.

También necesita tener acceso a una cuenta de Hetzner. Los ejemplos a continuación utilizan la herramienta de línea de comandos hcloud, la herramienta hcloud-upload-image y jq como procesador JSON de línea de comandos.

Descargar una imagen Hetzner

Fedora CoreOS está diseñado para ser actualizado automáticamente, con diferentes horarios por transmisión. Una vez que haya tomado la transmisión relevante, descargue y verifique la última imagen Hetzner:

ARCH="x86_64"    # or "aarch64"
STREAM="stable"  # or "testing", "next"
coreos-installer download -s "$STREAM" -p hetzner -a "$ARCH" -f raw.xz
Ambas arquitecturas x86_64 y aarch64 son admitidas en Hetzner.

Alternativamente, puedes descargar manualmente una imagen Hetzner desde la página de descargas. Verifique la descarga, siguiendo las instrucciones en esa página.

Crear una instantánea

  1. Utiliza el hcloud-upload-image para crear una instantánea desde esta imagen:

    IMAGE_NAME="fedora-coreos-41.20250213.0-hetzner.x86_64.raw.xz"
export HCLOUD_TOKEN="<tu vale>
STREAM="stable"     # o "testing", "next"
HETZNER_ARCH="x86"  # o "arm"

hcloud-upload-image upload \
    --architecture "$HETZNER_ARCH" \
    --compression xz \
    --image-path "$IMAGE_NAME" \
    --labels os=fedora-coreos,channel="$STREAM" \
    --description "Fedora CoreOS ($STREAM, $ARCH)"
    La herramienta hcloud-upload-image utiliza nombres diferentes para arquitecturas (x86_64 → x86, aarch64 → arm).

  2. Espera a que el proceso se complete y valide que tiene una instantánea:

    hcloud image list --type=snapshot --selector=os=fedora-coreos

Lanzar un servidor

  1. Si ya no tienes una clave SSH subida a Hetzner, puedes subir una:

    Ejemplo al subir una clave SSH a Hetzner
    SSH_PUBKEY="ssh-ed25519 ..."
SSH_KEY_NAME="fedora-coreos-hetzner"
hcloud ssh-key create --name "$SSH_KEY_NAME" --public-key "$SSH_PUBKEY"

  2. Lanza un servidor. Tu configuración de Ignition puede ser aprobada para la MV como sus datos de usuario, o puede omitir los datos de usuario si tan solo desea acceso por SSH. Esto proporciona una manera simple para probar FCOS sin crear primero una config de Ignition.

    Ejemplo de lanzar FCOS en Herzner utilizando un archivo de la configuración Ignition y la clave SSH
    IMAGE_ID="$(hcloud image list \
    --type=snapshot \
    --selector=os=fedora-coreos \
    --output json \
    | jq -r '.[0].id')"
SSH_KEY_NAME="fedora-coreos-hetzner"  # Consulte: hcloud ssh-key list
DATACENTER="fsn1-dc14"                # Consulte: hcloud datacenter list
TYPE="cx22"                           # Consulte: hcloud server-type list
NAME="fedora-coreos-test"
IGNITION_CONFIG="./config.ign"
hcloud server create \
    --name "$NAME" \
    --type "$TYPE" \
    --datacenter "$DATACENTER" \
    --image "$IMAGE_ID" \
    --ssh-key "$SSH_KEY_NAME" \
    --user-data-from-file "$IGNITION_CONFIG"
    While the Hetzner documentation and website mentions cloud-init and "cloud config", FCOS does not support cloud-init. It accepts only Ignition configuration files.

  3. Ahora serías capaz de acceder por SSH a la instancia usando la dirección IP asociada.

    Ejemplo al conectar
    ssh core@"$(hcloud server ip "$NAME")"

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