Použitie vlastného cloud-init pri inštalácii vášho VPS

Pri inštalácii alebo preinštalovaní vášho VPS môžete zadať vlastný cloud-init. Váš VPS tento súbor pri prvom spustení sám vykoná: nainštaluje vaše balíky, vytvorí vašich používateľov a spustí vaše príkazy. Nepotrebujete na to API ani terminál.

1. Otvorenie poľa

1. Prihláste sa do portálu Môj WebOké, prejdite do časti Moje produkty a kliknite na svoj VPS.
2. Nový VPS: zobrazí sa blok Nainštalujte svoj VPS. Preinštalovanie: vyberte kartu Pokročilé a pri položke Preinštalovať kliknite na Preinštalovať....
3. Vyberte operačný systém a vyplňte root heslo a prípadne aj svoj SSH kľúč.
4. Pod SSH kľúčom kliknite na Vlastný cloud-init a vložte svoj súbor do poľa.
5. Kliknite na tlačidlo na inštaláciu alebo na Zmazať všetko a preinštalovať.

2. Čo môže súbor obsahovať?

• Súbor, ktorý začína riadkom #cloud-config (nastavenia v YAML), alebo skript, ktorý začína znakmi #!. Fungujú aj #cloud-boothook a ## template: jinja.
• Najviac 256 KB a iba text (UTF-8).
• V YAML odsadzujte medzerami, nikdy tabulátormi.
• Sieť (IPv4 a IPv6) zabezpečuje WebOké. Vlastný network-config sa nepoužije.

3. Príklad

Tento súbor nainštaluje htop a fail2ban, vytvorí používateľa anna so SSH kľúčom a oprávnením sudo a potom spustí príkaz:

#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

Nahraďte kľúč svojím vlastným verejným kľúčom. Príklad je určený pre Debian a Ubuntu: na AlmaLinux a Rocky Linux nainštalujete htop a fail2ban cez runcmd, po príkaze dnf install -y epel-release.

4. Čo má prednosť?

WebOké samo odovzdá názov hostiteľa, root heslo (ako hash) a váš SSH kľúč. Váš súbor sa s týmito údajmi zlúči. Ak sami nastavíte users, password, chpasswd alebo ssh_authorized_keys, majú vaše hodnoty prednosť.

5. Kontrola, či všetko prebehlo úspešne

cloud-init sa spustí jedenkrát, pri prvom spustení vášho VPS. Potom sa prihláste a skontrolujte:

1. cloud-init status --long zobrazí status: done, ak všetko prebehlo úspešne, alebo error spolu s chybou.
2. Výstup vašich balíkov, príkazov a skriptov nájdete v súbore /var/log/cloud-init-output.log. Podrobnosti sú v súbore /var/log/cloud-init.log.
3. Príkazom sudo cloud-init schema --system skontrolujete svoj súbor. Ak YAML nie je správny, cloud-init niektoré časti preskočí.

Dobré vedieť

• Funguje to pre všetky operačné systémy v zozname: Ubuntu 24.04 a 26.04, Debian 12 a 13, AlmaLinux 9 a 10 a Rocky Linux 9 a 10.
• Váš súbor sa odovzdáva šifrovane a neukladá sa v histórii úloh vášho VPS. Napriek tomu doň nevkladajte tajné údaje, ktoré nepotrebujete.
• VPS je unmanaged. Podpora nepomáha s obsahom vášho cloud-init. Všetky možnosti nájdete na docs.cloud-init.io.

Podrobné vysvetlenie s ďalšími príkladmi: Vlastný cloud-init: automatické nastavenie VPS pri prvom spustení v príručke k VPS.

Pozrite aj: Pripojenie vlastného ISO alebo preinštalovanie vášho VPS a Prihlásenie na váš VPS cez SSH (a vytvorenie SSH kľúča).