Utilizzare un cloud-init personalizzato durante l'installazione del Suo VPS

Durante l'installazione o la reinstallazione del Suo VPS può fornire un cloud-init personalizzato. Il Suo VPS esegue autonomamente questo file al primo avvio: installa i Suoi pacchetti, crea i Suoi utenti ed esegue i Suoi comandi. Non Le servono API né terminale.

1. Aprire il campo

1. Acceda a Mio WebOké, vada su I miei prodotti e clicchi sul Suo VPS.
2. Nuovo VPS: vedrà il blocco Installi il Suo VPS. Reinstallazione: scelga la scheda Avanzate e, alla voce Reinstalla, clicchi su Reinstalla....
3. Scelga il sistema operativo e inserisca la password di root ed eventualmente la Sua chiave SSH.
4. Sotto la chiave SSH clicchi su cloud-init personalizzato e incolli il Suo file nel campo.
5. Clicchi sul pulsante per installare, oppure su Cancella tutto e reinstalla.

2. Cosa può contenere il file?

• Un file che inizia con #cloud-config (impostazioni in YAML) oppure uno script che inizia con #!. Funzionano anche #cloud-boothook e ## template: jinja.
• Massimo 256 KB e solo testo (UTF-8).
• In YAML l'indentazione si fa con gli spazi, mai con le tabulazioni.
• La rete (IPv4 e IPv6) è gestita da WebOké. Un network-config personalizzato non viene utilizzato.

3. Un esempio

Questo file installa htop e fail2ban, crea l'utente anna con una chiave SSH e sudo e poi esegue un comando:

#cloud-config
hostname: web1
fqdn: web1.example.com
package_update: true
packages:
  - htop
  - fail2ban
users:
  - default
  - name: anna
    shell: /bin/bash
    sudo: "ALL=(ALL) NOPASSWD:ALL"
    ssh_authorized_keys:
      - ssh-ed25519 AAAAC3Nza... anna@laptop
runcmd:
  - timedatectl set-timezone Europe/Amsterdam

Sostituisca la chiave con la Sua chiave pubblica. L'esempio è per Debian e Ubuntu: su AlmaLinux e Rocky Linux installi htop e fail2ban tramite runcmd, dopo dnf install -y epel-release.

4. Cosa ha la precedenza?

WebOké fornisce automaticamente il nome host, la password di root (come hash) e la Sua chiave SSH. Il Suo file viene unito a questi dati. Se imposta Lei stesso users, password, chpasswd o ssh_authorized_keys, i Suoi valori hanno la precedenza.

5. Verificare che sia andato a buon fine

cloud-init viene eseguito una sola volta, al primo avvio del Suo VPS. Successivamente acceda e verifichi:

1. cloud-init status --long mostra status: done se tutto è andato a buon fine, oppure error con l'errore.
2. L'output dei Suoi pacchetti, comandi e script si trova in /var/log/cloud-init-output.log. I dettagli si trovano in /var/log/cloud-init.log.
3. Con sudo cloud-init schema --system può verificare il Suo file. Se lo YAML non è corretto, cloud-init salta alcune parti.

Buono a sapersi

• Funziona con tutti i sistemi operativi dell'elenco: Ubuntu 24.04 e 26.04, Debian 12 e 13, AlmaLinux 9 e 10 e Rocky Linux 9 e 10.
• Il Suo file viene trasmesso in forma crittografata e non viene conservato nella cronologia delle attività del Suo VPS. Tuttavia, non vi inserisca segreti di cui non ha bisogno.
• Un VPS è unmanaged. Il supporto non fornisce assistenza sul contenuto del Suo cloud-init. Tutte le possibilità sono descritte su docs.cloud-init.io.

Spiegazione dettagliata con altri esempi: cloud-init personalizzato: configurare automaticamente il Suo VPS al primo avvio nel manuale VPS.

Vedi anche: Collegare un'ISO personalizzata o reinstallare il Suo VPS e Accedere al Suo VPS tramite SSH (e creare una chiave SSH).