Provisioning di Fedora CoreOS su Hetzner

Questa guida mostra come fornire nuovi nodi Fedora CoreOS (FCOS) su Hetzner. Attualmente, Fedora CoreOS non è disponibile come opzione nella selezione del sistema operativo su Hetzner. Quindi, devi prima scaricare l’immagine del disco di Fedora CoreOS per Hetzner, poi creare uno snapshot da essa nel tuo account Hetzner utilizzando lo strumento [hcloud-upload-image](https://github.com/apricote/hcloud-upload-image), e infine creare i tuoi server da questo snapshot.

Il supporto per Fedora CoreOS su Hetzner è considerato emergente, poiché non offre ancora un’esperienza utente ottimizzata e si basa su strumenti non ufficialmente supportati da Hetzner. Per maggiori dettagli, consulta l'[issue #1324](https://github.com/coreos/fedora-coreos-tracker/issues/1324).
Lo strumento [hcloud-upload-image](https://github.com/apricote/hcloud-upload-image) non è un prodotto ufficiale di Hetzner Cloud e Hetzner Cloud non fornisce supporto per esso. In alternativa, puoi utilizzare il plugin ufficiale [packer-plugin-hcloud](https://github.com/hetznercloud/packer-plugin-hcloud) per installare l’immagine tramite coreos-installer.
Per creare uno snapshot, lo strumento hcloud-upload-image provvederà a fornire un piccolo server e avviarlo in modalità di recupero. Poiché questo server è di breve durata, il costo dovrebbe essere molto limitato. Gli snapshot risultanti vengono addebitati per GB al mese. Consulta la documentazione Backups/Snapshots nella Hetzner Cloud. È possibile eliminare questo snapshot una volta che il server è stato fornito.

Prerequisiti

Prima di effettuare il provisioning di una macchina FCOS, è necessario disporre di un file di configurazione Ignition contenente le proprie personalizzazioni. Se non ne hai uno, consulta la guida Creazione di un file Ignition.

Fedora CoreOS dispone di un utente predefinito chiamato core che può essere utilizzato per esplorare il sistema operativo. Se desideri utilizzarlo, completa la sua configurazione fornendo, ad esempio, una chiave SSH.

Se non desideri utilizzare Ignition per iniziare, puoi sfruttare il supporto Afterburn e configurare solo le chiavi SSH.

Devi anche avere accesso a un account Hetzner. Gli esempi seguenti utilizzano lo strumento da riga di comando hcloud, lo strumento hcloud-upload-image e jq come processore JSON da riga di comando.

Scaricando un’immagine Hetzner

Fedora CoreOS è progettato per essere aggiornato automaticamente, con programmi diversi per ogni stream. Una volta scelto lo stream rilevante, scarica e verifica l’ultima immagine Hetzner:

ARCH="x86_64"    # or "aarch64"
STREAM="stable"  # or "testing", "next"
coreos-installer download -s "$STREAM" -p hetzner -a "$ARCH" -f raw.xz
Sono supportate sia l’architettura x86_64 che aarch64 su Hetzner.

In alternativa, puoi scaricare manualmente un’immagine Hetzner dalla pagina di download. Verifica il download, seguendo le istruzioni su quella pagina.

Creazione snapshot

  1. Usa hcloud-upload-image per creare uno snapshot da questa immagine:

    IMAGE_NAME="fedora-coreos-41.20250213.0-hetzner.x86_64.raw.xz"
export HCLOUD_TOKEN="<your token>"
STREAM="stable"     # or "testing", "next"
HETZNER_ARCH="x86"  # or "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)"
    Lo strumento hcloud-upload-image usa nomi diversi per le architetture (x86_64 → x86, aarch64 → arm).

  2. Attendi che il processo sia completato e verifica di avere uno snapshot:

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

Avvio di un server

  1. Se non hai già una chiave SSH caricata su Hetzner, puoi caricarne una:

    Esempio di caricamento di una chiave SSH su Hetzner
    SSH_PUBKEY="ssh-ed25519 ..."
SSH_KEY_NAME="fedora-coreos-hetzner"
hcloud ssh-key create --name "$SSH_KEY_NAME" --public-key "$SSH_PUBKEY"

  2. Avvia un server. La tua configurazione Ignition può essere passata alla VM come i suoi user data, oppure puoi saltare il passaggio degli user data se vuoi solo l’accesso SSH. Questo fornisce un modo semplice per testare FCOS senza dover prima creare una configurazione Ignition.

    Esempio di avvio di FCOS su Hetzner utilizzando un file di configurazione Ignition e una chiave SSH
    IMAGE_ID="$(hcloud image list \
    --type=snapshot \
    --selector=os=fedora-coreos \
    --output json \
    | jq -r '.[0].id')"
SSH_KEY_NAME="fedora-coreos-hetzner"  # See: hcloud ssh-key list
DATACENTER="fsn1-dc14"                # See: hcloud datacenter list
TYPE="cx22"                           # See: 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"
    Mentre la documentazione e il sito web di Hetzner menzionano cloud-init e "cloud config", FCOS non supporta cloud-init. Accetta solo file di configurazione Ignition.

  3. Ora dovresti poter effettuare l’accesso SSH all’istanza utilizzando l’indirizzo IP associato.

    Esempio di connessione
    ssh core@"$(hcloud server ip "$NAME")"

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